Token Search#
Search tokens by token name, symbol or token contract address.
For token name or symbol search, return maximum 100 results by relevance.For token contract address, return the exact match result.
Request URL#
GET https://web3.okx.com/api/v6/dex/market/token/search
Request Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
| chains | String | Yes | Unique identifier for the chain. e.g., 1: Ethereum. See more here. |
| search | String | Yes | Search for token keywords, token address or token symbol |
| cursor | String | No | Pagination cursor, pass the cursor value returned from the previous request |
| limit | String | No | Number of records per page, max 100 |
Response Parameters#
| Parameter | Type | Description |
|---|---|---|
| chainIndex | String | Unique identifier of the chain. (Such as 1: Ethereum, for more see the list of chainIndex ) |
| cursor | String | Pagination cursor |
| tokenName | String | Token name |
| tokenSymbol | String | Token identification |
| tokenLogoUrl | String | Token icon url |
| tokenContractAddress | String | Token contract address |
| decimal | String | Token precision |
| explorerUrl | String | Token Browser link |
| change | String | 24H price change ratio |
| holders | String | Number of holders |
| liquidity | String | Token liquidity (24h) |
| marketCap | String | Token market cap |
| price | String | Price |
| tagList | Object | Label |
| >communityRecognized | Boolean | True means it's listed in the Top 10 CEX or is community verifed |
Request Example#
Shell
curl --location --request GET 'https://web3.okx.com/api/v6/dex/market/token/search?chains=1,10&search=weth' \
--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'
Response Example#
Json
{
"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": ""
}