Get Wallet Currency Token Balance

Returns the on-chain balance a user's wallet holds for a specific currency token, together with the currency token metadata.

Request

GET /v2/users/users/{id}/wallets/currency_tokens/{currencyTokenID}

Parameters

Name	Type	In	Description
id	string	path	Required. User ID
currencyTokenID	string	path	Required. Currency token ID

Headers

Name	Description
Authorization	Required. Bearer token for authentication

Example

curl --request GET \
  --url '\{\{baseUrl\}\}/v2/users/users/665b372f3a72d7d0791596ba/wallets/currency_tokens/68fe8c129367fd414b227c7a' \
  --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'

Response

{
  "currency_token": {
    "id": "68fe8c129367fd414b227c7a",
    "name": "USDT",
    "symbol": "USDT",
    "decimal": 6,
    "address": "0x073c0196e516a0e77b1c804d1825fb1bad23895d"
  },
  "balance": {
    "amount": 1250.5,
    "raw": "1250500000"
  }
}

Response Fields

Field	Type	Description
currency_token	object	Currency token metadata (ID, name, symbol, decimal, address)
balance.amount	number	Human-readable balance (adjusted for decimals)
balance.raw	string	Raw on-chain balance (smallest unit)

The exact shape may extend with additional fields; consult the server response for the authoritative schema.

Status Codes

Status Code	Description
200	Success
400	Bad Request - Missing or invalid id / currencyTokenID
401	Unauthorized - Invalid or missing authentication token
404	Not Found - User or currency token not found
500	Internal Server Error