Token Balances

Returns token balances for a specific wallet address. This endpoint is essential for building trading interfaces, portfolio management tools, and any application that needs to display or verify user token holdings.

Endpoint: GET https://api.liqd.ag/tokens/balances

Authentication: None required - publicly accessible

Rate Limits: No rate limits

Required Parameters

Name	Type	Description	Required
wallet	address	Address of the wallet to check balances for	Yes

Optional Parameters

Name	Type	Description	Default
limit	number	Maximum number of tokens to return	none

Parameter Details:

• wallet: Must be a valid Ethereum-style address (0x followed by 40 hexadecimal characters)

• limit: Useful for pagination or when you only need the top token holdings. If not specified, returns all tokens with non-zero balances

Example Requests:

# Get all token balances for a wallet
GET https://api.liqd.ag/tokens/balances?wallet=0x123456789abcdef123456789abcdef123456789

# Get only the top 10 token holdings
GET https://api.liqd.ag/tokens/balances?wallet=0x123456789abcdef123456789abcdef123456789&limit=10

Example Response:

{
  "success": true,
  "data": {
    "wallet": "0x123456789abcdef123456789abcdef123456789",
    "tokens": [
      {
        "token": "Native HYPE",
        "balance": "1000000000000000000",
        "name": "HYPE",
        "symbol": "HYPE",
        "decimals": 18
      },
      {
        "token": "0x47bb061C0204Af921F43DC73C7D7768d2672DdEE",
        "balance": "500000000000000000",
        "name": "Token One",
        "symbol": "TOKEN1",
        "decimals": 18
      }
    ],
    "count": 2,
    "limitedCount": 2
  }
}