获取 TSV 交易明细#

查询 OKXICE TSV 的交易记录，可同时组合多个筛选条件，按照交易时间倒序返回。不传 txHash 时仅查询最近 30 天，未指定时间则使用最近 30 天，begin 和 end 均须处于该范围。传入 txHash 时精确查询该交易的全部历史记录，不受最近 30 天限制；仅应用显式传入的可选 begin / end。同时传入两端时，begin 不得晚于 end。

本接口免费开放，无需登录、API key、签名或支付。每个 IP 对每个接口的服务端限额为 2 RPS，随对应版本部署生效。每个接口合计 200 RPS 的总限额须通过外部平台规则配置，并以该规则实际生效为准。更改查询参数、游标或客户端 key 不会重置配额；同一出口 IP 的调用方共享该 IP 配额。超限后应降低请求频率，额度恢复后重试。

请求地址#

GET

https://web3.okx.com/api/v6/explorer/tsv/transaction-list

请求参数#

参数名	类型	是否必填	描述
txHash	String	否	交易哈希，`0x` 加 64 位十六进制字符，精确匹配；传入时不受最近 30 天限制
stockTokenAddress	String	否	股票代币合约地址
stockSymbol	String	否	股票代币代码，精确匹配
paymentSymbol	String	否	支付资产代码，例如 `USDG`
paymentTokenAddress	String	否	支付资产合约地址
poolId	String	否	Uniswap V4 `bytes32` PoolId，区别于 PoolManager 合约地址
begin	String	否	起始交易确认时间，13 位 UTC Unix 毫秒时间戳，包含边界
end	String	否	结束交易确认时间，13 位 UTC Unix 毫秒时间戳，包含边界
limit	Integer	否	每页条数，默认 `100`，范围 `1`–`1000`
cursor	String	否	非负整数偏移量，以数字字符串表示；首次请求省略或传 `"0"`，续页原样使用响应中的非空值

cursor 是数字字符串偏移量，不保存查询条件。翻页时须继续携带相同的筛选条件、时间参数和 limit，并原样回传响应中的非空 cursor；响应为空字符串表示没有更多记录。为保持时间范围一致，建议首次请求显式指定时间边界，并在后续请求中保留。

响应参数#

成功响应使用 code、msg、data 包络，data 是数组，包含一个分页结果对象。所有数值响应字段均以字符串表示。

参数名	类型	描述
limit	String	每页条数上限
cursor	String	下一页数字字符串偏移量；空字符串表示没有更多记录
transactionList	Array	当前页数据列表
> txHash	String	链上交易哈希
> logIndex	String	交易内的链上日志索引，以字符串表示
> stockSymbol	String	股票代币代码
> stockTokenAddress	String	股票代币合约地址
> paymentTokenAddress	String	支付资产合约地址
> paymentSymbol	String	支付资产代码
> price	String	每股 USD 成交价格
> amount	String	成交股数，单位为股
> multiper	String	股票代币合约约定的乘数；沿用该字段拼写
> transactionTime	String	AMM Pool 交易确认时间，UTC Unix 毫秒时间戳
> side	String	交易方向：`buy` 或 `sell`
> poolId	String	`bytes32` PoolId
> hook	String	Hook 合约地址
> feePercent	String	池手续费，单位 bps；动态池未配置费率时为空字符串 `""`
> poolManager	String	PoolManager 合约地址

无匹配记录时返回空列表及空 cursor。上游异常或数据未就绪应作为失败处理，不能解释为空数据或零成交。

错误处理#

场景	HTTP 状态码	业务错误码	处理建议
请求频率超限	429	50011	`Requests too frequent`；降低请求频率，额度恢复后重试
参数错误	400	50036	检查参数后重新请求
限流服务不可用	503	50001	稍后重试

每个 IP 对每个接口独立使用从首次请求起计时的 1000 毫秒固定窗口。

上游查询失败返回相应错误，不会返回成功的空列表。

请求示例#

shell

curl --location --request GET 'https://web3.okx.com/api/v6/explorer/tsv/transaction-list?txHash=0x0000000000000000000000000000000000000000000000000000000000000002&limit=100'

响应示例#

以下为结构示例，地址、交易及数值仅作说明，不代表真实资产配置或查询结果。

json

{
  "code": "0",
  "msg": "",
  "data": [
    {
      "limit": "100",
      "cursor": "",
      "transactionList": [
        {
          "txHash": "0x0000000000000000000000000000000000000000000000000000000000000002",
          "logIndex": "12",
          "stockSymbol": "AAPLx",
          "stockTokenAddress": "0x9d275685dc284c8eb1c79f6aba7a63dc75ec890a",
          "paymentTokenAddress": "0x0000000000000000000000000000000000000003",
          "paymentSymbol": "USDG",
          "price": "250.50",
          "amount": "10.5",
          "multiper": "1",
          "transactionTime": "1793595600000",
          "side": "buy",
          "poolId": "0x0000000000000000000000000000000000000000000000000000000000000001",
          "hook": "0x1234567890123456789012345678901234567890",
          "feePercent": "30",
          "poolManager": "0x360e68faccca8ca495c1b759fd9eee466db9fb32"
        }
      ]
    }
  ]
}