Wallet API
Get real-time coin price

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#

ParameterTypeRequiredDescription
tokenListArray<Object>YesQuery List
> chainIdStringYesUnique identifier of the chain
>tokenAddressListArray<String>YesToken address
timeStringNoQuery historical data.
The latest time data is returned by default.
The millisecond format of Unix timestamp, such as 1597026383085

Response parameters#

ParameterTypeDescription
chainIdStringUnique identifier of the chain
symbolStringToken abbreviation
priceStringToken price
tokenAddressStringToken address
circulatingSupplyStringCirculation volume (multi-chain summary, some token data are empty)
maxSupplyStringMaximum supply (summary of multiple chains, some token data are empty)
totalSupplyStringTotal supply (multi-chain summary, some token data are empty)
volume24hString24-hour transaction volume
marketCapStringMarket capitalization (multi-chain summary, some token data are empty)
priceChangeRate24HString24-hour price change rate
priceChange24HString24-hour price change amount
decimalsStringCoin precision
tokenStatusListList<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": []
    }
  ]
}