代币搜索#
通过代币符号或代币合约地址搜索代币。
当使用代币名称或符号搜索时，按相关性最多返回 100 条结果
当使用代币合约地址搜索时，返回完全匹配的结果
请求地址#
Get https://web3.okx.com/api/v6/dex/market/token/search
请求参数#
| Parameter | Type | Required | Description |
|---|---|---|---|
| chains | String | 是 | 链的唯一标识，传入链id(如1代表Ethereum。更多可查看这里。) ，支持查询多条链的结果，按逗号隔开 |
| search | String | 是 | 搜索关键词，可传入代币地址、symbol 返回相应结果 |
| cursor | String | 否 | 分页游标，传入上一次请求返回的 cursor 值 |
| limit | String | 否 | 每页返回数量，最大 100 |
响应参数#
| 参数 | 类型 | 描述 |
|---|---|---|
| chainIndex | String | 区块链唯一标识符。（如 1: Ethereum，更多信息参见 chainIndex 列表） |
| cursor | String | 分页游标 |
| tokenName | String | 代币名称 |
| tokenSymbol | String | 代币符号 |
| tokenLogoUrl | String | 代币图标 URL |
| tokenContractAddress | String | 代币合约地址 |
| decimal | String | 代币精度 |
| explorerUrl | String | 代币区块浏览器链接 |
| change | String | 24 小时价格变动比例 |
| holders | String | 持有人数量 |
| liquidity | String | 代币流动性（24 小时） |
| marketCap | String | 代币市值 |
| price | String | 价格 |
| tagList | Object | 标签 |
| >communityRecognized | Boolean | True 表示已在前 10 大中心化交易所上线或已被社区验证 |
请求示例#
Shell
curl --location --request GET 'https://web3.okx.com/api/v6/dex/market/token/search?chains=1,10&search=weth' \
--header 'Content-Type: application/json' \
--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' \
响应示例#
Json
-- 不是深度分页，只支持在内存返回的 最多100条数据中 分页
{
"code": "0",
"data": [
{
"chainIndex": "501",
"change": "6.59",
"decimal": "8",
"explorerUrl": "https://web3.okx.com/explorer/solana/token/XsDoVfqeBukxuZHWhdvWHBhgEHjGNst4MLodqsJHzoB",
"holders": "22447",
"liquidity": "3492546.00711048141155477039737838",
"marketCap": "51095303.595316825571569398",
"price": "381.228119807066217995",
"tagList": {
"communityRecognized": true
},
"tokenContractAddress": "XsDoVfqeBukxuZHWhdvWHBhgEHjGNst4MLodqsJHzoB",
"tokenLogoUrl": "https://static.oklink.com/cdn/web3/currency/token/large/501-XsDoVfqeBukxuZHWhdvWHBhgEHjGNst4MLodqsJHzoB-900/type=default_90_0?v=1771926275192",
"tokenName": "Tesla xStock",
"tokenSymbol": "TSLAx",
"cursor": "0"
},
{
"chainIndex": "501",
"change": "6.19",
"decimal": "9",
"explorerUrl": "https://web3.okx.com/explorer/solana/token/KeGv7bsfR4MheC1CkmnAVceoApjrkvBhHYjWb67ondo",
"holders": "133",
"liquidity": "",
"marketCap": "7747.288131154003818",
"price": "380.833333",
"tagList": {
"communityRecognized": true
},
"tokenContractAddress": "KeGv7bsfR4MheC1CkmnAVceoApjrkvBhHYjWb67ondo",
"tokenLogoUrl": "https://static.oklink.com/cdn/web3/currency/token/large/501-KeGv7bsfR4MheC1CkmnAVceoApjrkvBhHYjWb67ondo-900/type=default_90_0?v=1774296033373",
"tokenName": "Tesla (Ondo Tokenized)",
"tokenSymbol": "TSLAon",
"cursor": "1"
}
],
"msg": ""
}