Get real-time coin price#
Acquire real-time price information for a batch of coins. This includes data on the current, fluctuating value of various cryptocurrencies.
Request address#
POST https://www.okx.com/api/v5/waas/coin/price-list
Request parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
| tokenList | Array<Object> | Yes | Query List |
| > chainId | String | Yes | Unique identifier of the chain |
| >tokenAddressList | Array<String> | Yes | Token address |
| time | String | No | Query historical data. The latest time data is returned by default. The millisecond format of Unix timestamp, such as 1597026383085 |
Response parameters#
| Parameter | Type | Description |
|---|---|---|
| chainId | String | Unique identifier of the chain |
| symbol | String | Token abbreviation |
| price | String | Token price |
| tokenAddress | String | Token address |
| circulatingSupply | String | Circulation volume (multi-chain summary, some token data are empty) |
| maxSupply | String | Maximum supply (summary of multiple chains, some token data are empty) |
| totalSupply | String | Total supply (multi-chain summary, some token data are empty) |
| volume24h | String | 24-hour transaction volume |
| marketCap | String | Market capitalization (multi-chain summary, some token data are empty) |
| priceChangeRate24H | String | 24-hour price change rate |
| priceChange24H | String | 24-hour price change amount |
| decimals | String | Coin precision |
| tokenStatusList | List<String> | Coin price status: if there is no abnormality in the coin price, this field is empty Abnormal Coin Price: Low liquidity: The token has low liquidity in the mainstream dex Disparity between sources: There is a large difference between quotes from multiple data sources Abnormal fluctuation: Abnormal fluctuation, generally refers to a sharp increase or decrease in the price of a token in a short period of time |
Request example#
shell
curl --location --request POST 'https://www.okx.com/api/v5/waas/coin/price-list' \
--header 'Content-Type: application/json' \
--header 'OK-ACCESS-PROJECT: 86af********d1bc' \
--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 '{
"tokenList":[
{
"chainId":1,
"tokenAddressList":["0xdac17f958d2ee523a2206206994597c13d831ec7"]
},
{
"chainId":56
}
]
}'
Response example#
200
{
"code": 0,
"msg": "success",
"data": [
{
"chainId": "1",
"symbol": "usdt",
"price": "1.000145405432340",
"tokenAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"circulatingSupply": "84605973812.990000000000000",
"maxSupply": "",
"totalSupply": "",
"volume24h": "38817595045.301186000000000",
"marketCap": "84650814979.110000000000000",
"priceChangeRate24H": "-0.000039990000000",
"priceChange24H": "-0.000040000000000",
"decimals": "6",
"tokenStatusList": []
},
{
"chainId": "56",
"symbol": "bnb",
"price": "246.935112798767160",
"tokenAddress": "",
"circulatingSupply": "151703763.020000000000000",
"maxSupply": "200000000.000000000000000",
"totalSupply": "",
"volume24h": "283632981.281666040000000",
"marketCap": "34510982165.370000000000000",
"priceChangeRate24H": "0.012086000000000",
"priceChange24H": "2.959179336225160",
"decimals": "18",
"tokenStatusList": []
}
]
}