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-liquidityRequest Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
| chainIndex | String | Yes | Unique identifier of the chain. For example: 1: Ethereum. |
| tokenContractAddress | String | Yes | Token contract address (e.g. 0x382bb369d343125bfb2117af9c149795c6c65c50) |
Response Parameters#
| Field | Type | Description |
|---|---|---|
| pool | String | Funding pool, e.g. Punch/SOL |
| protocolName | String | Agreement name |
| liquidityUsd | String | Liquidity value |
| liquidityAmount | Array | Quantity of liquidity |
| >tokenAmount | String | Token amount in liquidity pool |
| >tokenSymbol | String | Token name in liquidity pool |
| >tokenContractAddress | String | Token contract address |
| liquidityProviderFeePercent | String | Base LP/Pool fee rate. The same value applies to both buys and sells. Returns an empty string if the value cannot be determined |
| hookFeePercent | Object | Additional Hook fee rates |
| >buy | String | Additional Hook fee rate for buys. Returns an empty string if the value cannot be determined |
| >sell | String | Additional Hook fee rate for sells. Returns an empty string if the value cannot be determined |
| sniperTaxPercent | Object | Sniper tax rates |
| >buy | String | Sniper tax rate for buys. Returns an empty string if the value cannot be determined |
| >sell | String | Sniper tax rate for sells. Returns an empty string if the value cannot be determined |
| liquidityLogoUrl | String | Logo URL of the liquidity protocol. Returns an empty string when unavailable |
| poolAddress | String | Pool address |
| poolCreator | String | Pool creator |
Request Example#
shell
curl --location 'https://web3.okx.com/api/v6/dex/market/token/top-liquidity?chainIndex=4663&tokenContractAddress=0xd9db30bb0d2b8d2eae3826a1372117e058791e18' \
--header 'Cookie: locale=en-US'
Response Example#
json
{
"code": "0",
"data": [
{
"hookFeePercent": {
"buy": "1%",
"sell": "1%"
},
"liquidityAmount": [
{
"tokenAmount": "38775020.48665667",
"tokenContractAddress": "0xd9db30bb0d2b8d2eae3826a1372117e058791e18",
"tokenSymbol": "MOO"
},
{
"tokenAmount": "653.36523431004980229835744728",
"tokenContractAddress": "0xff080c8ce2e5feadaca0da81314ae59d232d4afd",
"tokenSymbol": "MU"
}
],
"liquidityProviderFeePercent": "0.7%",
"liquidityUsd": "1343864.31842109989918644517516400036894252703585374203425260868",
"pool": "MOO/MU",
"poolAddress": "0xc3cc877a8a7d28efdb5dbec9ae71724652431e6411aa1a9fc8928028da554aa1",
"poolBasicFeePercent": null,
"poolCreator": "",
"poolLogoUrl": "https://static.coinall.ltd/cdn/web3/protocol/logo/1770884244454.png/type=png_350_0",
"protocolName": "Uniswap V4 - Community Hook",
"sniperTaxInfo": null
},
{
"hookFeePercent": {
"buy": "",
"sell": ""
},
"liquidityAmount": [
{
"tokenAmount": "192851.599681",
"tokenContractAddress": "0x5fc5360d0400a0fd4f2af552add042d716f1d168",
"tokenSymbol": "USDG"
},
{
"tokenAmount": "9223264.021555675",
"tokenContractAddress": "0xd9db30bb0d2b8d2eae3826a1372117e058791e18",
"tokenSymbol": "MOO"
}
],
"liquidityProviderFeePercent": "2%",
"liquidityUsd": "365171.1252607631700333345788402492143108913664225",
"pool": "USDG/MOO",
"poolAddress": "0x85a3cd053eecbcf2a67fd2c391479a2267e237edcea3acf19609b329e3a482fa",
"poolBasicFeePercent": null,
"poolCreator": "",
"poolLogoUrl": "https://static.coinall.ltd/cdn/web3/protocol/logo/1786978952893.png/type=png_350_0",
"protocolName": "Uniswap V4",
"sniperTaxInfo": null
},
{
"hookFeePercent": null,
"liquidityAmount": [
{
"tokenAmount": "35.93333971245758",
"tokenContractAddress": "0x0bd7d308f8e1639fab988df18a8011f41eacad73",
"tokenSymbol": "WETH"
},
{
"tokenAmount": "8405699.385555107",
"tokenContractAddress": "0xd9db30bb0d2b8d2eae3826a1372117e058791e18",
"tokenSymbol": "MOO"
}
],
"liquidityProviderFeePercent": "1%",
"liquidityUsd": "244773.1930151989884487072380611495834412882847929",
"pool": "WETH/MOO",
"poolAddress": "0x9036a9406dac1c252c364d037f489e5f0a752f54",
"poolBasicFeePercent": null,
"poolCreator": "0x9819bbb9c355ab6f91304a1a54d301d72ca31247",
"poolLogoUrl": "https://static.coinall.ltd/cdn/web3/protocol/logo/1782205622669.png/type=png_350_0",
"protocolName": "Uniswap V3",
"sniperTaxInfo": null
},
{
"hookFeePercent": {
"buy": "",
"sell": ""
},
"liquidityAmount": [
{
"tokenAmount": "14.726095075084912",
"tokenContractAddress": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
"tokenSymbol": "ETH"
},
{
"tokenAmount": "2491379.7439266276",
"tokenContractAddress": "0xd9db30bb0d2b8d2eae3826a1372117e058791e18",
"tokenSymbol": "MOO"
}
],
"liquidityProviderFeePercent": "1.0012%",
"liquidityUsd": "81510.527818604372666440446965457732050555261546736",
"pool": "ETH/MOO",
"poolAddress": "0x6132955c48b86c50fa83d8fa8ba74ad557c2e68c51bf23f2e44ba7937570f995",
"poolBasicFeePercent": null,
"poolCreator": "",
"poolLogoUrl": "https://static.coinall.ltd/cdn/web3/protocol/logo/1786978952893.png/type=png_350_0",
"protocolName": "Uniswap V4",
"sniperTaxInfo": null
},
{
"hookFeePercent": {
"buy": "",
"sell": ""
},
"liquidityAmount": [
{
"tokenAmount": "40872.825671",
"tokenContractAddress": "0x5fc5360d0400a0fd4f2af552add042d716f1d168",
"tokenSymbol": "USDG"
},
{
"tokenAmount": "710753.4229407404",
"tokenContractAddress": "0xd9db30bb0d2b8d2eae3826a1372117e058791e18",
"tokenSymbol": "MOO"
}
],
"liquidityProviderFeePercent": "3.94%",
"liquidityUsd": "53940.836738898283951698181671940634276709769724452",
"pool": "USDG/MOO",
"poolAddress": "0x50b29d336ff8c80656c9c2e811a82779f8b8064b46c99799cf61d20d096765c8",
"poolBasicFeePercent": null,
"poolCreator": "",
"poolLogoUrl": "https://static.coinall.ltd/cdn/web3/protocol/logo/1786978952893.png/type=png_350_0",
"protocolName": "Uniswap V4",
"sniperTaxInfo": null
}
],
"msg": ""
}