> ## Documentation Index
> Fetch the complete documentation index at: https://pay-docs.holdstation.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Tokens

> Retrieve the list of tokens supported for buy/sell operations.

## Overview

Partners use this API to retrieve the list of tokens supported for buy/sell operations in the Holdstation Pay system. Use this to obtain valid `chain_id` and `token_address` values for creating orders.

<ParamField query="chain_id" type="integer">
  Filter by blockchain network ID.
</ParamField>

<ParamField query="active" type="boolean">
  Filter by active status.
</ParamField>

<ParamField query="page" type="integer">
  Page number for pagination.
</ParamField>

<ParamField query="page_size" type="integer">
  Number of results per page.
</ParamField>

<ParamField query="symbols" type="string[]">
  Filter by token symbols (e.g. `USDT`).
</ParamField>

<ParamField query="no_limit" type="boolean">
  If `true`, returns all tokens without pagination.
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "message": "success",
    "data": {
      "tokens": [
        {
          "id": "ba8618c3-fadb-4d9d-b75f-f14e6acd6110",
          "name": "Tether USD",
          "symbol": "USDT",
          "name_override": "Tether USD (BSC)",
          "address": "0x55d398326f99059ff775485246999027b3197955",
          "chain_id": 56,
          "decimals": 18,
          "price": "1",
          "price_change_24h": "0",
          "image": "https://static.holdstation.com/tokens/usdt.png",
          "active": true,
          "withdrawal_contract": "0x0000000000000000000000000000000000000000",
          "created_at": { "seconds": 1751951680, "nanos": 676721000 },
          "updated_at": { "seconds": 1751951680, "nanos": 676721000 }
        }
      ],
      "page": 1,
      "page_size": 20,
      "total_count": 10
    }
  }
  ```

  ```json 400 theme={null}
  {
    "error": "invalid request",
    "error_code": "BAD_REQUEST",
    "message": "Invalid parameters"
  }
  ```
</ResponseExample>