GAgala
user

Fetch user token balances

Returns all supported tokens + the user's balance for each (even if 0). When address is given and its balance lookup fails, the list is still returned with data.balancesAvailable: false: every quantity is then UNKNOWN (sent as '0' only so older clients keep working) and must be ignored. balancesAvailable is absent when the balances are known or no address was given.

get/user/token-list

Request

Query parameters

searchstring
Example:GALA

Search term for filtering tokens

tokenNamestring
Example:GALA

Filter by specific token name

pagenumber
Example:1

Page number for pagination (starts at 1)

limitnumber
Example:10

Maximum number of items per page; omit to return all

addressstring
Example:eth|6742903677106B3156434F61f2731c3516B1aD68

User wallet address

compositeKeysstring
Example:GALA$Unit$none$none,GUSDC$Unit$none$none

Comma-separated composite token keys (collection$category$type$additionalKey) to fetch exactly. When present, this REPLACES search/tokenName filtering entirely — an exact-match lookup, not an additional narrowing of it.

Response

statusnumber required
errorfalse required
messagestring required

Example response

{
  "status": 200,
  "message": "Tokens fetched",
  "data": {
    "token": [
      {
        "isUngraduatedLaunchpad": true,
        "price": 0.025,
        "change24h": -2.1,
        "listed": true,
        "originChain": "native",
        "listedAt": "2026-01-01T00:00:00.000Z",
        "id": 1,
        "name": "GALA",
        "displayName": "Gala",
        "symbol": "GALA",
        "compositeKey": "GALA$Unit$none$none",
        "collection": "GALA",
        "category": "Unit",
        "type": "none",
        "additionalKey": "none",
        "decimals": "18",
        "subscribePrice": true,
        "verify": true,
        "quantity": "0"
      }
    ],
    "count": 1
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.