获取 TSV 每日交易统计#

查询按股票和快照时间汇总的每日成交股数，以及各 AMM Pool 的 EOD TVL。begin / end 按 snapshotTime 筛选，且 begin 不得晚于 end。EOD 为每日固定 EST（UTC−5）00:00，即 UTC 05:00，不随夏令时切换。

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

请求地址#

GET

https://web3.okx.com/api/v6/explorer/tsv/daily-statistics

请求参数#

参数名	类型	是否必填	描述
stockCode	String	否	股票代币代码，精确匹配 `stockSymbol`
stockTokenAddress	String	否	股票代币合约地址，`0x` 加 40 位十六进制字符；与 `stockCode` 共同筛选
begin	String	否	起始快照时间，13 位 UTC Unix 毫秒时间戳，包含边界
end	String	否	结束快照时间，13 位 UTC Unix 毫秒时间戳，包含边界
limit	Integer	否	每页条数，默认 `100`，范围 `1`–`1000`
cursor	String	否	非负整数偏移量，以数字字符串表示；首次请求省略或传 `"0"`，续页原样使用响应中的非空值

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

未传 end 时使用当前 UTC 毫秒时间；未传 begin 时从最终 end 回推 29 天，两端均包含。显式时间边界直接按 snapshotTime 筛选，不做统计日平移或零点对齐，且显式区间不受 30 天限制。limit 和 cursor 按股票与快照时间的汇总条目计数，LiquidityInfo 内保留各池明细。

响应参数#

成功响应使用 code、msg、data 包络，data 是数组，包含一个分页结果对象。所有数值响应字段均以字符串表示；成交量缺失时返回空字符串 ""，与表示真实零成交的字符串 "0" 区分，不将缺失值填零。

参数名	类型	描述
limit	String	每页条数上限
cursor	String	下一页数字字符串偏移量；空字符串表示没有更多记录
dailyStatisticsList	Array	当前页数据列表
> date	String	统计日起点，UTC Unix 毫秒时间戳，比对应 `snapshotTime` 早 24 小时
> totalDailyShareVolume	String	同一股票及快照时间下各池的合计成交股数，单位为股；任一池成交量缺失时为空字符串 `""`，真实合计为零时为 `"0"`
> snapshotTime	String	实际 EOD 快照业务时间，UTC Unix 毫秒时间戳
> LiquidityInfo	Array	各池的 EOD 流动性信息；字段首字母为大写
> > eodPoolSize	String	该池 EOD TVL，单位 USD
> > paymentSymbol	String	支付资产代码
> > paymentTokenAddress	String	支付资产合约地址
> > stockSymbol	String	股票代币代码
> > stockTokenAddress	String	股票代币合约地址
> > dailyShareVolume	String	该池当日成交股数，单位为股；真实零为 `"0"`，缺失时为空字符串 `""`
> > poolId	String	`bytes32` PoolId
> > 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/daily-statistics?stockCode=AAPLx&limit=100'

响应示例#

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

json

{
  "code": "0",
  "msg": "",
  "data": [
    {
      "limit": "100",
      "cursor": "",
      "dailyStatisticsList": [
        {
          "date": "1793509200000",
          "totalDailyShareVolume": "15230.75",
          "snapshotTime": "1793595600000",
          "LiquidityInfo": [
            {
              "eodPoolSize": "2500000.50",
              "paymentSymbol": "USDG",
              "paymentTokenAddress": "0x0000000000000000000000000000000000000003",
              "stockSymbol": "AAPLx",
              "stockTokenAddress": "0x9d275685dc284c8eb1c79f6aba7a63dc75ec890a",
              "dailyShareVolume": "15230.75",
              "poolId": "0x0000000000000000000000000000000000000000000000000000000000000001",
              "poolManager": "0x360e68faccca8ca495c1b759fd9eee466db9fb32"
            }
          ]
        }
      ]
    }
  ]
}