Get user token balances

GET/v0/account/balances

Needs Authorization: Bearer <accessToken> from /v0/auth/authenticate. Without tokenIds only non-zero balances are listed (an empty account returns { "balances": [] }); with tokenIds every requested token is listed, including zeros as below. tokenIds takes a comma-separated list. Real response for a fresh throwaway account.

Returns token balances for the authenticated user from private balance sources Tidepool: needs a Tidepool JWT (401 without). Balances come from the testnet verifier; source is private.

Operation id: getBalances · Auth: optional (X-API-Key or Authorization: Bearer, any value)

Request

curl "https://www.usetidepool.tech/v0/account/balances?tokenIds=nep141%3Ausdc.tidepool-sandbox.testnet%2Cnep141%3Awnear.tidepool-sandbox.testnet" \
  -H 'Authorization: Bearer <accessToken>'

Query parameters

Responses

200

{
  "balances": [
    {
      "tokenId": "nep141:usdc.tidepool-sandbox.testnet",
      "available": "0",
      "source": "private"
    },
    {
      "tokenId": "nep141:wnear.tidepool-sandbox.testnet",
      "available": "0",
      "source": "private"
    }
  ]
}

401 Unauthorized - User session token is invalid or expired

{
  "message": "Unauthorized: send Authorization: Bearer <accessToken> from /v0/auth/authenticate"
}