---
title: "Fetch user token balances"
method: GET
path: "/user/token-list"
tags: ["user"]
---

# Fetch user token balances

`GET /user/token-list`

## Request

- Base URL: `https://swap-backend.stage.defi.ovh.gala.com`
- URL: `https://swap-backend.stage.defi.ovh.gala.com/user/token-list`
- Auth: none declared
- TypeScript: <https://skmtc.dev/gala/apis/gala-defi-backend-api/docs/user/token-list/get.ts> (a function with typed inputs; its response is checked against the schema)

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.

## Query parameters

- `search` string
- `tokenName` string
- `page` number
- `limit` number
- `address` string
- `compositeKeys` string

## Response `200`

- UserTokenListResponseDto
  - `status` number, required
  - `error` false, required
  - `message` string, required
  - `data` UserTokenListDataResponseDto, required
    - `token` UserTokenResponseDto[], required
      - `isUngraduatedLaunchpad` boolean
      - `price` number, nullable
      - `change24h` number, nullable
      - `listed` boolean
      - `originChain` string, nullable
      - `listedAt` string, nullable
      - `id` number
      - `name` string, required
      - `displayName` string, required
      - `symbol` string, required
      - `compositeKey` string, required
      - `collection` string, required
      - `category` string, required
      - `type` string, required
      - `additionalKey` string, required
      - `decimals` string, required
      - `description` string, required
      - `subscribePrice` boolean, required
      - `verify` boolean, required
      - `image` string, required
      - `quantity` string
    - `count` number, required
    - `balancesAvailable` false

## Other responses

- `400`
- `500`
- `default`: An error response using the shared backend error envelope.

---

[API](https://skmtc.dev/gala/apis/gala-defi-backend-api.md) - [All operations](https://skmtc.dev/gala/apis/gala-defi-backend-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gala/apis/gala-defi-backend-api/revisions/84f8184e2828?raw)