​
接口地址

GET /v1/common/tokens

​
请求参数

参数类型必填描述
tokenNameString否币种名称，不传时默认返回所有币种信息。
同一个代币，可能在多条链上发行，从参数chainList中可获取到该币在哪些链发行，以及其对应的信息。有几个 信息是值得注意：提现数量的小数位限制/最小提现数量/最小充值数量等，详见下方说明。

​
响应参数

参数类型必须描述
tokenNameString是币种名称
fullNameString是币种全称。
<chainList>Object是币种支持的提现/充值链的列表，一个代币可能在多个链上发行，本质上属于同一资产。
chainIdInteger是链的唯一 ID。
chainNameString是链的唯一名称。
tokenIdString是币种的唯一 ID。
contractIdString否币种的合约 ID，仅智能合约代币（如 USDT）存在此值。
tokenTypeString是币种类型，链主币时值为 Base，例如 Ethereum 链的主币为 ETH。
decimalsInteger是币种的精度。
displayDecimalInteger是币种金额显示的最长小数位，提现金额受此限制。
blockConfirmNumInteger是安全上账所需的区块确认数，达到此值将解冻金额。
minDepositAmountString是最小充值数量，小于此值的充值将不会上账。
minWithdrawAmountString是最小提现数量，小于此值的金额将不能提现。
feeString是提币的网络手续费，可能根据网络情况动态调整。
depositEnableBool是充值功能状态，True 表示正常，False 表示暂停。
sdaString否暂停充值的公告信息（如有）。
suspendDepositDescString否暂停充值的描述信息（如有）。
withdrawEnableBool是提现功能状态，True 表示正常，False 表示暂停。
swaString否暂停提现的公告信息（如有）。
suspendWithdrawDescString否暂停提现的描述信息（如有）。

​
响应示例

{
    "code": 200,
    "msg": "success",
    "timestamp": "1725619438648",
    "data": [
        {
            "tokenName": "USDT",
            "fullName": "Tether USD",
            "chainList": [
                {
                    "chainId": 102,
                    "chainName": "Ethereum",
                    "tokenId": 102003,
                    "contractId": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
                    "tokenType": "ERC-20",
                    "decimals": 6,
                    "displayDecimal": 2,
                    "blockConfirmNum": 64,
                    "minDepositAmount": "0.01",
                    "minWithdrawAmount": "0.01",
                    "fee": "0.11",
                    "depositEnable": true,
                    "withdrawEnable": true
                },
                {
                    "chainId": 103,
                    "chainName": "Tron",
                    "tokenId": 103002,
                    "contractId": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
                    "tokenType": "TRC-20",
                    "decimals": 6,
                    "displayDecimal": 2,
                    "blockConfirmNum": 20,
                    "minDepositAmount": "0.01",
                    "minWithdrawAmount": "0.12",
                    "fee": "0.01",
                    "depositEnable": true,
                    "withdrawEnable": true
                }
            ]
        },
        {
            "tokenName": "ETH",
            "fullName": "Ethereum",
            "chainList": [
                {
                    "chainId": 102,
                    "chainName": "Ethereum",
                    "tokenId": 102002,
                    "contractId": "",
                    "tokenType": "Base",
                    "decimals": 18,
                    "displayDecimal": 6,
                    "blockConfirmNum": 64,
                    "minDepositAmount": "0.00001",
                    "minWithdrawAmount": "0.00001",
                    "fee": "0.00001",
                    "depositEnable": true,
                    "withdrawEnable": true
                }
            ]
        },
    ]
}