Get Supported TSV Assets#
Return all supported stock tokens and their AMM pools in one response, with no more than 300 assets. Optionally filter by stockCode. Returns asset information by pool; if a single asset has liquidity in multiple pools, multiple records will be returned.
This endpoint is free and requires no login, API key, signature, or payment. The service implements a 2 RPS limit per IP for each endpoint, effective when the corresponding version is deployed. The aggregate 200 RPS limit per endpoint requires an external platform rule and applies when that rule is configured and active. Changing the stock filter or client keys does not reset the quota. Clients sharing an outbound IP share its quota. Reduce the request rate after a rate-limit failure and retry when quota recovers.
Request URL#
https://web3.okx.com/api/v6/explorer/tsv/asset-listRequest Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
| stockCode | String | No | Stock code filter |
Response Parameters#
Successful responses use a code, msg, and data envelope. data is an array containing an asset-list object.
| Parameter | Type | Description |
|---|---|---|
| assetInfo | Array | All matching assets, up to 300 entries |
| > stockTokenAddress | String | Stock token contract address |
| > stockSymbol | String | Stock token symbol |
| > paymentSymbol | String | Payment asset symbol |
| > poolId | String | bytes32 PoolId |
No matching assets returns data: [{assetInfo: []}]. Upstream failures or unavailable data must be treated as errors, not as an empty asset list.
Error Handling#
| Scenario | HTTP status | Business code | Action |
|---|---|---|---|
| Rate limit exceeded | 429 | 50011 | Requests too frequent; reduce the request rate and retry when quota recovers |
| Invalid parameter | 400 | 50036 | Correct the parameters and retry |
| Rate-limit service unavailable | 503 | 50001 | Retry later |
Each IP is counted independently for each endpoint in a fixed 1000 ms window starting with the first request.
Request Example#
curl --location --request GET 'https://web3.okx.com/api/v6/explorer/tsv/asset-list?stockCode=AAPL'
Response Example#
This is a structural example. Addresses, trades, and values are illustrative and do not represent actual asset configurations or query results.
{
"code": "0",
"msg": "",
"data": [
{
"assetInfo": [
{
"stockTokenAddress": "0x9d275685dc284c8eb1c79f6aba7a63dc75ec890a",
"stockSymbol": "AAPLx",
"paymentSymbol": "USDG",
"poolId": "0x0000000000000000000000000000000000000000000000000000000000000001"
}
]
}
]
}