行情 API

代币交易信息#

返回代币的交易信息,包括价格、交易量、交易数据、流通量、持有人数、流动性等。
支持在指定时间点查询,最多支持批量查询 100 个代币。

请求 URL#

POST https://web3.okx.com/api/v5/dex/market/price-info

请求参数#

参数类型必填描述
chainIndexString链的唯一标识。
例如:1:Ethereum。
更多链请参考 这里
tokenContractAddressString代币合约地址(例如:0x382bb369d343125bfb2117af9c149795c6c65c50)。
支持批量查询:最多可输入 100 个地址,用英文逗号分隔。

返回参数#

参数类型描述
chainIndexString链的唯一标识。
例如:1:Ethereum。更多链请参考 这里
tokenContractAddressString代币合约地址(例如:0x382bb369d343125bfb2117af9c149795c6c65c50)
timeString价格时间戳,Unix 毫秒时间戳格式
priceString最新代币价格
marketCapString代币市值
priceChange5MString5 分钟内价格变动(百分比增减)
priceChange1HString1 小时内价格变动(百分比增减)
priceChange4HString4 小时内价格变动(百分比增减)
priceChange24HString24 小时内价格变动(百分比增减)
volume5MString5 分钟内交易量
volume1HString1 小时内交易量
volume4HString4 小时内交易量
volume24HString24 小时内交易量
txs5MString5 分钟内交易笔数
txs1HString1 小时内交易笔数
txs4HString4 小时内交易笔数
txs24HString24 小时内交易笔数
maxPriceString24 小时最高价
tradeNumString24 小时代币交易数量
minPriceString24 小时最低价
circSupplyString代币流通量
liquidityString代币池内流动性
holdersString代币持有地址数量

请求示例#

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"
    
}
]'

响应示例#

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": ""
}