Token Trading Information#
Return token trading information including price, volume, trading info, supply, holders, liquidity etc at specific timestamp, support max 100 multiple tokens query.
Request URL#
POST https://web3.okx.com/api/v5/dex/market/price-info
Request Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
| chainIndex | String | Yes | Unique identifier for the chain. e.g., 1: Ethereum. See more here. |
| tokenContractAddress | String | Yes | Token contract address (e.g., 0x382bb369d343125bfb2117af9c149795c6c65c50) |
Response Parameters#
| Parameter | Type | Description |
|---|---|---|
| chainIndex | String | Unique identifier of the chain. e.g., 1: Ethereum. See more here |
| tokenContractAddress | String | Token contract address (e.g. 0x382bb369d343125bfb2117af9c149795c6c65c50) |
| time | String | Price timestamp, using Unix Millisecond timestamp format |
| price | String | Latest token price |
| marketCap | String | Token market cap |
| priceChange5M | String | Price changes within 5 minutes, in percentage increase or decrease |
| priceChange1H | String | Price changes within one hour, expressed as a percentage increase or decrease |
| priceChange4H | String | Price changes within 4 hours, expressed as a percentage increase or decrease |
| priceChange24H | String | Price changes within 24 hours, expressed as a percentage increase or decrease |
| volume5M | String | Trading volume within 5 minutes |
| volume1H | String | Trading volume within 1 hour |
| volume4H | String | Trading volume within 4 hours |
| volume24H | String | Trading volume within 24 hours |
| txs5M | String | Token transactions within 5 minutes |
| txs1H | String | Token transactions within 1 hour |
| txs4H | String | Token transactions within 4 hours |
| txs24H | String | Number of token transactions within 24 hours |
| maxPrice | String | Token 24h highest price |
| tradeNum | String | 24H token trading quantity |
| minPrice | String | Token 24h lowest price |
| circSupply | String | Token circulation supply |
| liquidity | String | Liquidity in the token pool |
| holders | String | Number of token holding addresses |
Request Example#
shell
curl --location --request POST 'https://web3.okx.com/api/v5/dex/market/price-info' \
--header 'Content-Type: application/json' \
--header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \
--header 'OK-ACCESS-SIGN: leaV********3uw=' \
--header 'OK-ACCESS-PASSPHRASE: 1****6' \
--header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z' \
--data-raw '[
{
"chainIndex": "501",
"tokenContractAddress": "5mbK36SZ7J19An8jFochhQS4of8g6BwUjbeCSxBSoWdp"
},
{
"chainIndex": "501",
"tokenContractAddress": "eL5fUxj2J4CiQsmW85k5FG9DvuQjjUoBHoQBi2Kpump"
}
]'
Response Example#
200
{
"code": "0",
"data": [
{
"chainIndex": "501",
"circSupply": "555761678.7348550000",
"holders": "46998",
"liquidity": "2909733.283759244562509712218832656",
"marketCap": "12252728.212049527112081409",
"maxPrice": "0.023000175796511334",
"minPrice": "0.021290716539724027",
"price": "0.022046730965585534",
"priceChange1H": "-1.24",
"priceChange24H": "-1.8",
"priceChange4H": "-2.64",
"priceChange5M": "0.22",
"time": "1756816961600",
"tokenContractAddress": "5mbK36SZ7J19An8jFochhQS4of8g6BwUjbeCSxBSoWdp",
"tradeNum": "9577269.994247",
"txs1H": "27664",
"txs24H": "127879",
"txs4H": "108489",
"txs5M": "2265",
"volume1H": "7376.6139697593500223",
"volume24H": "213047.96235814982022456",
"volume4H": "33943.03136454470008366",
"volume5M": "544.69701090069000181"
},
{
"chainIndex": "501",
"circSupply": "999973538.9201610000",
"holders": "37302",
"liquidity": "2946946.965800864848335614721052390",
"marketCap": "25792746.281014184438384254",
"maxPrice": "0.026539875867707924",
"minPrice": "0.02427728431412691",
"price": "0.025793428802993062",
"priceChange1H": "-1.13",
"priceChange24H": "3.4",
"priceChange4H": "-2.07",
"priceChange5M": "0.52",
"time": "1756816961600",
"tokenContractAddress": "eL5fUxj2J4CiQsmW85k5FG9DvuQjjUoBHoQBi2Kpump",
"tradeNum": "10046562.105494",
"txs1H": "166",
"txs24H": "2888",
"txs4H": "322",
"txs5M": "29",
"volume1H": "10343.0564689259900202",
"volume24H": "253496.67765782958052983",
"volume4H": "21530.5160926891601342",
"volume5M": "3278.85450250897"
}
],
"msg": ""
}