Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs-en.basswallet.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Endpoint

GET /v1/common/tokens

​
Request Parameters

ParameterTypeRequiredDescription
tokenNameStringNoToken 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

ParameterTypeRequiredDescription
tokenNameStringYesToken name.
fullNameStringYesFull name of the token.
<chainList>ObjectYesList of supported chains for deposit/withdrawal for the token.
chainIdIntegerYesUnique ID of the chain.
chainNameStringYesUnique name of the chain.
tokenIdStringYesUnique ID of the token.
contractIdStringNoContract ID for the token. This is applicable only for smart contract tokens (e.g., USDT).
tokenTypeStringYesToken type. For main chain tokens, the value is Base (e.g., ETH for Ethereum).
decimalsIntegerYesDecimal precision of the token.
displayDecimalIntegerYesMaximum number of decimals displayed for token amounts. Withdrawal amounts are subject to this limit.
blockConfirmNumIntegerYesNumber of block confirmations required for secure deposit. Amounts are unlocked after this threshold.
minDepositAmountStringYesMinimum deposit amount. Deposits below this amount will not be credited.
minWithdrawAmountStringYesMinimum withdrawal amount. Withdrawals below this amount are not allowed.
feeStringYesNetwork fee for withdrawals, which may vary based on network conditions.
depositEnableBoolYesDeposit status: True for enabled, False for disabled.
sdaStringNoAnnouncement message for suspended deposits (if any).
suspendDepositDescStringNoDescription for suspended deposits (if any).
withdrawEnableBoolYesWithdrawal status: True for enabled, False for disabled.
swaStringNoAnnouncement message for suspended withdrawals (if any).
suspendWithdrawDescStringNoDescription 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
                }
            ]
        }
    ]
}