行情 API

流通频道#

获取代币流动性相关的数据,推送频率最快是间隔 1 秒推送一次数据。

URL路径
请联系我们获取 dexapi@okx.com

请求参数#

参数类型必填描述
opString操作,subscribe unsubscribe
argsArray订阅的频道列表
channelString频道名称,price
chainIndexString区块链唯一标识符。 (例如,1 代表 Ethereum。更多请查看 ChainIndex)
tokenContractAddressString代币合约地址,对于 EVM 请传入全小写地址 (例如,0x382bb369d343125bfb2117af9c149795c6c65c50)

响应参数#

参数类型描述
eventString事件类型,subscribe unsubscribe error
argObject代币合约地址
channelString频道名称
chainIndexString区块链唯一标识符。(例如,1 代表 Ethereum。更多请查看 ChainIndex)
tokenContractAddressString代币合约地址 (例如,0x382bb369d343125bfb2117af9c149795c6c65c50)
codeString错误码
msgString错误信息

推送数据参数#

参数类型描述
argObject成功订阅的频道
> channelString频道名称
> chainIndexString区块链唯一标识符。(例如,1 代表 Ethereum。更多请查看 ChainIndex)
> tokenContractAddressString代币合约地址 (例如,0x382bb369d343125bfb2117af9c149795c6c65c50)
dataArray已订阅的数据
> timeString价格时间戳,Unix 毫秒时间戳格式
> priceString最新代币价格
> marketCapString代币市值
> priceChange5MString5 分钟价格变动
> priceChange1HString1 小时价格变动
> priceChange4HString4 小时价格变动
> priceChange24HString24 小时价格变动
> volume5MString5 分钟交易量
> volume1HString1 小时交易量
> volume4HString4 小时交易量
> volume24HString24 小时交易量
> txs5MString代币 5 分钟内交易笔数
> txs1HString代币 1 小时内交易笔数
> txs4HString代币 4 小时内交易笔数
> txs24HString代币 24 小时内交易笔数
> maxPriceString代币 24 小时最高价格
> tradeNumString24 小时代币交易数量
> minPriceString代币 24 小时最低价格
> circSupplyString代币流通供应量
> liquidityString代币资金池流动性
> holdersString代币持仓地址数量

请求示例#

shell
{
  "op": "subscribe",
  "args": [
    {
      "channel": "price-info",
      "chainIndex": "1",
      "tokenContractAddress":"0x382bb369d343125bfb2117af9c149795c6c65c50"
    }
  ]
}

响应示例#

200

成功响应示例

{
  "event": "subscribe",
  "arg": {
    "channel": "price-info",
    "chainIndex": "501"
    "tokenContractAddress":"eL5fUxj2J4CiQsmW85k5FG9DvuQjjUoBHoQBi2Kpump"
  },
  "connId": "a4d3ae55"
}

失败响应示例

{
  "event": "error",
  "code": "60012",
  "msg": "Invalid request: {\"op\": \"subscribe\", \"argss\":[{ \"channel\" : \"price-info\", \"chainIndex\" : \"501\", \"tokenContractAddress\" : \"eL5fUxj2J4CiQsmW85k5FG9DvuQjjUoBHoQBi2Kpump\"}]}",
  "connId": "a4d3ae55"
}

推送数据示例

{
  "arg": {
    "channel": "price-info",
    "chainIndex": "501"
    "tokenContractAddress":"0x382bb369d343125bfb2117af9c149795c6c65c50"
  },
  "data": [
    {
            "chainIndex": "501",
            "circSupply": "999973312.2632950000",
            "holders": "37241",
            "liquidity": "3923952.461979153265333544895656917",
            "marketCap": "19960307.19257757296691203",
            "maxPrice": "0.1656024888921609",
            "minPrice": "0.02292722724150618",
            "price": "0.019960839902217294",
            "priceChange1H": "9.12",
            "priceChange24H": "374.25",
            "priceChange4H": "68.26",
            "priceChange5M": "6.91",
            "time": "1758702741738",
            "tokenContractAddress": "eL5fUxj2J4CiQsmW85k5FG9DvuQjjUoBHoQBi2Kpump",
            "tradeNum": "2460429287.120492",
            "txs1H": "15142",
            "txs24H": "276164",
            "txs4H": "38998",
            "txs5M": "1196",
            "volume1H": "12864939.572057",
            "volume24H": "169512096.311189",
            "volume4H": "29069166.04389",
            "volume5M": "893224.505265"
    }
  ]
}