Token API

Token Liquidity Pool Information#

Support viewing pool information of the top 5 liquidity

Request Path#

GET https://web3.okx.com/api/v6/dex/market/token/top-liquidity

Request Parameters#

ParameterTypeRequiredDescription
chainIndexStringYesUnique identifier of the chain. For example: 1: Ethereum.
tokenContractAddressStringYesToken contract address (e.g. 0x382bb369d343125bfb2117af9c149795c6c65c50)

Response Parameters#

FieldTypeDescription
poolStringFunding pool, e.g. Punch/SOL
protocolNameStringAgreement name
liquidityUsdStringLiquidity value
liquidityAmountArrayQuantity of liquidity
>tokenAmountStringToken amount in liquidity pool
>tokenSymbolStringToken name in liquidity pool
liquidityProviderFeePercentStringLiquidity provider fee percentage
poolAddressStringPool address
poolCreatorStringPool creator

Request Example#

Shell
curl --location 'https://web3pre.okex.org/api/v6/dex/market/token/liquidity?chainIndex=8453&tokenContractAddress=0x1f16e03c1a5908818f47f6ee7bb16690b40d0671' \
--header 'Cookie: locale=en-US'

Response Example#

Json
{
    "code": "0",
    "data": [
        {
            "liquidityAmount": [
                {
                    "tokenAmount": "4347613.0508917095",
                    "tokenSymbol": "RECALL"
                },
                {
                    "tokenAmount": "142351.302373",
                    "tokenSymbol": "USDC"
                }
            ],
            "liquidityProviderFeePercent": "0.06%",
            "liquidityUsd": "344879.7538226645330963352547001735",
            "pool": "RECALL/USDC",
            "poolAddress": "0x5e3791f68ebceac82788f3becab154c15141a2f4",
            "poolCreator": "0xee4bbf067ce361b75e8f31fd2fe726caba757a67",
            "protocolName": "Aerodrome"
        },
        {
            "liquidityAmount": [
                {
                    "tokenAmount": "1627239.5672854523",
                    "tokenSymbol": "RECALL"
                },
                {
                    "tokenAmount": "25.183845099309004",
                    "tokenSymbol": "WETH"
                }
            ],
            "liquidityProviderFeePercent": "0.30%",
            "liquidityUsd": "126390.2349541208658853815306505521",
            "pool": "RECALL/WETH",
            "poolAddress": "0x6ee714d6d8df7662bca805f58cc1d5a8886d78eb",
            "poolCreator": "0xee4bbf067ce361b75e8f31fd2fe726caba757a67",
            "protocolName": "Aerodrome"
        }
    ],
    "msg": ""
}