介绍

交易频道#

获取最近的成交数据，有成交数据就推送

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

请求参数#

Parameter	Type	Required	Description
op	String	是	操作, `subscribe` `unsubscribe`
args	Array	是	请求订阅的频道列表
channel	String	是	频道名, `trades`
chainIndex	String	是	链的唯一标识。 (如1代表Ethereum。更多可查看这里。)
tokenContractAddress	String	是	币种合约地址

响应参数#

Parameter	Type	Description
event	String	事件, `subscribe` `unsubscribe` `error`
arg	Object	订阅的频道
channel	String	频道名
chainIndex	String	链的唯一标识
tokenContractAddress	String	币种合约地址
code	String	错误码
msg	String	错误消息
connId	String	WebSocket连接ID

推送数据参数#

Parameter	Type	Description
arg	Object	订阅成功的频道
> channel	String	频道名
> chainIndex	String	链的唯一标识。
> tokenContractAddress	String	币种合约地址
data	Array	频道的数据
> id	String	成交id
> txHashUrl	String	链上交易的tx哈希
> userAddress	String	交易的发起方
> dexName	String	交易发生的DEX
> poolLogoUrl	String	池子logo链接
> type	String	交易类型。`buy`: 买 `sell`: 卖
> amountExchanged	String	交易信息
>> amount	String	成交数量
>> tokenSymbol	String	代币符号
>> tokenContractAddress	String	币种合约地址
> price	String	最新交易价格
> volume	String	交易的美元价值
> time	String	交易的时间，Unix 时间戳格式，用毫秒表示
> isFiltered	String	此交易在k线和币价计算中是否过滤。 `0`: 不过滤 `1`: 过滤

K线频道

错误码

请求示例#

shell

{
  "op": "subscribe",
  "args": [
    {
      "channel": "trades",
      "chainIndex": "501",
      "tokenContractAddress":"HeLp6NuQkmYB4pYWo2zYs22mESHXPQYzXbB8n4V98jwC"
    }
  ]
}

响应示例#

200

成功响应示例

{
  "event": "subscribe",
  "arg": {
    "channel": "trades",
      "chainIndex": "501",
      "tokenContractAddress":"HeLp6NuQkmYB4pYWo2zYs22mESHXPQYzXbB8n4V98jwC"
  },
  "connId": "a4d3ae55"
}

失败响应示例

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

推送数据示例

{
  "arg": {
    "channel": "trades",
    "chainIndex": "501"
    "tokenContractAddress":"HeLp6NuQkmYB4pYWo2zYs22mESHXPQYzXbB8n4V98jwC"
  },
    "data":[
    {
    "id":"1739439633000!@#120!@#14731892839",
    "chainIndex": "501",
    "tokenContractAddress": "HeLp6NuQkmYB4pYWo2zYs22mESHXPQYzXbB8n4V98jwC",
    "txHashUrl": "https://solscan.io/tx/zgDzoiVG4XuDgQcoEg9vhpRyfyk5thNUQuTeTCeF289Qec5iraeCrUzPLyiE2UCviox2ebbTcsagGvzYF7M5uqs",
    "userAddress": "2kCm1RHGJjeCKL4SA3ZJCLyXqUD7nEJ7GMtVaP7c6jQ8",
    "dexName": "Orca Whirlpools",
    "poolLogoUrl": "https://static.okx.com/cdn/wallet/logo/dex_orcaswap.png",
    "type": "sell",
    "changedTokenInfo": [
    {
    "amount":"100.396595878", 
    "tokenSymbol":"ai16z",
    "tokenContractAddress": "HeLp6NuQkmYB4pYWo2zYs22mESHXPQYzXbB8n4V98jwC"
    },
    {
    "amount":"2.482831", 
    "tokenSymbol":"SOL",
    "tokenContractAddress": "So11111111111111111111111111111111111111112"
    }
    ]
    "price": "26.458143090226812",
    "volume": "519.788163",
    "time": "1739439633000",
    "isFiltered": "0"
    }
    ]
}

K线频道

错误码