行情 API

获取交易#

获取DEX上的代币交易数据。

请求地址#

GET https://web3.okx.com/api/v5/dex/market/trades

请求参数#

ParameterTypeRequiredDescription
chainIndexString链的唯一标识。 (如1代表Ethereum。更多可查看这里。)
tokenContractAddressString币种合约地址 (如:0x382bb369d343125bfb2117af9c149795c6c65c50)
afterString请求此 id 之前的分页内容,传的值为对应交易的 id
limitString分页返回的结果集数量,最大为500,不填默认返回100条

响应参数#

ParameterTypeDescription
idString成交id
chainIndexString链的唯一标识。 (如 1 代表 Ethereum,66 代表 OKTC。更多可查看这里。)
tokenContractAddressString币种合约地址
txHashUrlString链上交易的tx哈希
userAddressString交易的发起方
dexNameString交易发生的DEX
poolLogoUrlString池子logo链接
typeString交易类型。buy: 买 sell: 卖
changedTokenInfoString交易信息
> amountString成交数量
> tokenSymbolString代币符号
> tokenContractAddressString币种合约地址
priceString最新交易价格
volumeString交易的美元价值
timeString交易的时间,Unix 时间戳格式,用毫秒表示
isFilteredString此交易在k线和币价计算中是否过滤
0: 不过滤 1: 过滤

请求示例#

shell
curl --location --request GET 'https://web3.okx.com/api/v5/dex/market/trades?chainIndex=501&tokenContractAddress=HeLp6NuQkmYB4pYWo2zYs22mESHXPQYzXbB8n4V98jwC' \
--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'

响应示例#

200
{
    "code":"0",
    "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"
      }
    ],
    "msg":"",
}