Endpoint
GET/v1/common/tokens
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| tokenName | String | No | Token name. If not provided, returns information for all tokens. |
A single token may be issued on multiple chains. The parameter
chainList provides information on which chains a token is issued and its corresponding details, such as withdrawal precision, minimum withdrawal amount, and minimum deposit amount. See the detailed explanation below.Response Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| tokenName | String | Yes | Token name. |
| fullName | String | Yes | Full name of the token. |
| <chainList> | Object | Yes | List of supported chains for deposit/withdrawal for the token. |
| chainId | Integer | Yes | Unique ID of the chain. |
| chainName | String | Yes | Unique name of the chain. |
| tokenId | String | Yes | Unique ID of the token. |
| contractId | String | No | Contract ID for the token. This is applicable only for smart contract tokens (e.g., USDT). |
| tokenType | String | Yes | Token type. For main chain tokens, the value is Base (e.g., ETH for Ethereum). |
| decimals | Integer | Yes | Decimal precision of the token. |
| displayDecimal | Integer | Yes | Maximum number of decimals displayed for token amounts. Withdrawal amounts are subject to this limit. |
| blockConfirmNum | Integer | Yes | Number of block confirmations required for secure deposit. Amounts are unlocked after this threshold. |
| minDepositAmount | String | Yes | Minimum deposit amount. Deposits below this amount will not be credited. |
| minWithdrawAmount | String | Yes | Minimum withdrawal amount. Withdrawals below this amount are not allowed. |
| fee | String | Yes | Network fee for withdrawals, which may vary based on network conditions. |
| depositEnable | Bool | Yes | Deposit status: True for enabled, False for disabled. |
| sda | String | No | Announcement message for suspended deposits (if any). |
| suspendDepositDesc | String | No | Description for suspended deposits (if any). |
| withdrawEnable | Bool | Yes | Withdrawal status: True for enabled, False for disabled. |
| swa | String | No | Announcement message for suspended withdrawals (if any). |
| suspendWithdrawDesc | String | No | Description for suspended withdrawals (if any). |
Response Example
{
"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
}
]
}
]
}