Get Payment Token List

Query available payment tokens (e.g. USDT, USDC) and their CEX_<id> token codes for on-chain trading.

info

• Returns token codes in CEX_<id> format used by Get Trade Quote and execution endpoints
• Each payment token lists supported chains via supportChains
• To get on-chain tradable tokens, use Get Biz Token List instead

HTTP Request

POST/v5/alpha/trade/pay-token-list

Request Parameters

Parameter	Required	Type	Comments
chainCode	true	string	Blockchain code, e.g. SOL, MANTLE
tokenAddress	true	string	Token contract address on the specified chain

Response Parameters

Parameter	Type	Comments
tokenCode	string	Payment token code in CEX_<id> format. Use this in quote and execution requests
symbol	string	Token symbol, e.g. USDT, USDC
tokenDecimals	integer	Token decimal precision
tokenIconUrlDay	string	Token icon URL (light mode)
tokenIconUrlNight	string	Token icon URL (dark mode)
limit	string	Maximum trading amount for this payment token
supportChains	array	Supported blockchain codes, e.g. ["ETH", "BSC", "SOL"]

Request Example

HTTP

POST /v5/alpha/trade/pay-token-list HTTP/1.1
Host: api.bybit.com
X-BAPI-SIGN: XXXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1704067200000
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json

{
    "chainCode": "SOL",
    "tokenAddress": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB"
}

Python

Node.js

Response Example

{
    "retCode": 0,
    "retMsg": "OK",
    "result": [
        {
            "tokenCode": "CEX_1",
            "symbol": "USDT",
            "tokenDecimals": 6,
            "tokenIconUrlDay": "https://example.com/usdt-day.png",
            "tokenIconUrlNight": "https://example.com/usdt-night.png",
            "limit": "50000",
            "supportChains": ["ETH", "BSC", "SOL", "TRX"]
        },
        {
            "tokenCode": "CEX_2",
            "symbol": "USDC",
            "tokenDecimals": 6,
            "tokenIconUrlDay": "https://example.com/usdc-day.png",
            "tokenIconUrlNight": "https://example.com/usdc-night.png",
            "limit": "50000",
            "supportChains": ["ETH", "SOL", "BASE"]
        }
    ],
    "retExtInfo": {},
    "time": 1704067200000
}