查询支持的 TSV 资产#

一次返回全部支持的股票代币及其 AMM Pool，资产总数不超过 300，可通过可选参数 stockCode 筛选。

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

请求地址#

GET

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

请求参数#

参数名	类型	是否必填	描述
stockCode	String	否	股票代码筛选条件

响应参数#

成功响应使用 code、msg、data 包络，data 是数组，包含一个资产列表对象。

参数名	类型	描述
assetInfo	Array	全部匹配资产，最多 300 项
> stockTokenAddress	String	股票代币合约地址
> stockSymbol	String	股票代币代码
> paymentSymbol	String	支付资产代码
> poolId	String	`bytes32` PoolId

无匹配资产时返回 data: [{assetInfo: []}]。上游异常或数据未就绪应作为失败处理，不能解释为空资产列表。

错误处理#

场景	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/asset-list?stockCode=AAPL'

响应示例#

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

json

{
  "code": "0",
  "msg": "",
  "data": [
    {
      "assetInfo": [
        {
          "stockTokenAddress": "0x9d275685dc284c8eb1c79f6aba7a63dc75ec890a",
          "stockSymbol": "AAPLx",
          "paymentSymbol": "USDG",
          "poolId": "0x0000000000000000000000000000000000000000000000000000000000000001"
        }
      ]
    }
  ]
}