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/v5/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 |
Response Parameters#
| Parameter | Type | Description |
|---|---|---|
| chainIndex | String | Unique identifier of the chain. (Such as 1: Ethereum, for more see the list of chainIndex ) |
| 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/v5/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#
200
{
"code": "0",
"data": [
{
"chainIndex": "1",
"change": "1.02",
"decimal": "18",
"explorerUrl": "https://web3.okx.com/explorer/ethereum/token/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"holders": "886855",
"liquidity": "2188092231.7914506202196479164801803109959738",
"marketCap": "9916173829.907587128987514754",
"price": "4391.91765972826983527",
"tagList": {
"communityRecognized": true
},
"tokenContractAddress": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"tokenLogoUrl": "https://static.coinall.ltd/cdn/wallet/logo/WETH-0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2.png",
"tokenName": "Wrapped Ether",
"tokenSymbol": "WETH"
},
{
"chainIndex": "10",
"change": "1.57",
"decimal": "18",
"explorerUrl": "https://web3.okx.com/explorer/optimism/token/0x4200000000000000000000000000000000000006",
"holders": "",
"liquidity": "8066012.857541468860969364926025092091",
"marketCap": "89347769.41928855897874667",
"price": "4388.588953537819147873",
"tagList": {
"communityRecognized": false
},
"tokenContractAddress": "0x4200000000000000000000000000000000000006",
"tokenLogoUrl": "https://static.coinall.ltd/cdn/wallet/logo/WETH-0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2.png",
"tokenName": "Wrapped Ether",
"tokenSymbol": "WETH"
},
{
"chainIndex": "1",
"change": "0",
"decimal": "18",
"explorerUrl": "https://web3.okx.com/explorer/ethereum/token/0x03928473f25bb2da6bc880b07ecbadc636822264",
"holders": "",
"liquidity": "290386.93658880514761888891240493783472",
"marketCap": "125306.637009951812221918",
"price": "1865.6119139683371",
"tagList": {
"communityRecognized": false
},
"tokenContractAddress": "0x03928473f25bb2da6bc880b07ecbadc636822264",
"tokenLogoUrl": "https://static.oklink.com/cdn/web3/currency/token/default-logo/token_custom_logo_default_s.png/type=default_350_0",
"tokenName": "Static Aave Ethereum WETH",
"tokenSymbol": "stataEthWETH"
},
{
"chainIndex": "1",
"change": "",
"decimal": "18",
"explorerUrl": "https://web3.okx.com/explorer/ethereum/token/0xa684eaf215ad323452e2b2bf6f817d4aa5c116ab",
"holders": "",
"liquidity": "282162.925026260171260600639527587053876",
"marketCap": "2708767.72448012889795138",
"price": "4709.630733200069922727",
"tagList": {
"communityRecognized": false
},
"tokenContractAddress": "0xa684eaf215ad323452e2b2bf6f817d4aa5c116ab",
"tokenLogoUrl": "https://static.oklink.com/cdn/web3/currency/token/large/1-0xa684eaf215ad323452e2b2bf6f817d4aa5c116ab-106/type=default_90_0?v=1756925210569",
"tokenName": "Loop Liquidity Pool - WETH",
"tokenSymbol": "lpETH"
},
{
"chainIndex": "1",
"change": "",
"decimal": "18",
"explorerUrl": "https://web3.okx.com/explorer/ethereum/token/0x5c6ee304399dbdb9c8ef030ab642b10820db8f56",
"holders": "2084",
"liquidity": "116461.577792709260809499466595788994488",
"marketCap": "36218431.822006716776613252",
"price": "5.339960118861368738",
"tagList": {
"communityRecognized": false
},
"tokenContractAddress": "0x5c6ee304399dbdb9c8ef030ab642b10820db8f56",
"tokenLogoUrl": "https://static.oklink.com/cdn/web3/currency/token/large/1-0x5c6ee304399dbdb9c8ef030ab642b10820db8f56-106/type=default_90_0?v=1756916154072",
"tokenName": "Balancer 80 BAL 20 WETH",
"tokenSymbol": "B-80BAL-20WETH"
},
{
"chainIndex": "1",
"change": "",
"decimal": "18",
"explorerUrl": "https://web3.okx.com/explorer/ethereum/token/0x59cd1c87501baa753d0b5b5ab5d8416a45cd71db",
"holders": "3062",
"liquidity": "23099.0090680252518897028883167295250576",
"marketCap": "873724256.731651779318335243",
"price": "3073.898172687059849241",
"tagList": {
"communityRecognized": false
},
"tokenContractAddress": "0x59cd1c87501baa753d0b5b5ab5d8416a45cd71db",
"tokenLogoUrl": "https://static.oklink.com/cdn/web3/currency/token/default-logo/token_custom_logo_default_s.png/type=default_350_0",
"tokenName": "Spark WETH",
"tokenSymbol": "spWETH"
},
{
"chainIndex": "1",
"change": "",
"decimal": "18",
"explorerUrl": "https://web3.okx.com/explorer/ethereum/token/0x2015bc0be96be4aea2aabc95522109acfec84c30",
"holders": "168",
"liquidity": "20290.228588047977267221819104361761613",
"marketCap": "12948.232224742",
"price": "0.000012948232224742",
"tagList": {
"communityRecognized": false
},
"tokenContractAddress": "0x2015bc0be96be4aea2aabc95522109acfec84c30",
"tokenLogoUrl": "https://static.oklink.com/cdn/web3/currency/token/large/1-0x2015bc0be96be4aea2aabc95522109acfec84c30-106/type=default_90_0?v=1756940993907",
"tokenName": "WETH HEDZ",
"tokenSymbol": "HEDZ"
},
{
"chainIndex": "10",
"change": "",
"decimal": "18",
"explorerUrl": "https://web3.okx.com/explorer/optimism/token/0xc4d4500326981eacd020e20a81b1c479c161c7ef",
"holders": "",
"liquidity": "13254.943087761946817613043627328123036048",
"marketCap": "611320.947975873134702172",
"price": "1456.890419322951364824",
"tagList": {
"communityRecognized": false
},
"tokenContractAddress": "0xc4d4500326981eacd020e20a81b1c479c161c7ef",
"tokenLogoUrl": "https://static.oklink.com/cdn/web3/currency/token/large/10-0xc4d4500326981eacd020e20a81b1c479c161c7ef-106/type=default_90_0?v=1756917757030",
"tokenName": "exactly WETH",
"tokenSymbol": "exaWETH"
},
{
"chainIndex": "1",
"change": "",
"decimal": "18",
"explorerUrl": "https://web3.okx.com/explorer/ethereum/token/0x030ba81f1c18d280636f32af80b9aad02cf0854e",
"holders": "",
"liquidity": "12547.59168386404013787240620483741313585",
"marketCap": "35826020.242000942530530715",
"price": "1314.148440799180995081",
"tagList": {
"communityRecognized": false
},
"tokenContractAddress": "0x030ba81f1c18d280636f32af80b9aad02cf0854e",
"tokenLogoUrl": "https://static.oklink.com/cdn/web3/currency/token/large/1666600000-0xe50fa9b3c56ffb159cb0fca61f5c9d750e8128c8-106/type=default_90_0?v=1756916162800",
"tokenName": "Aave interest bearing WETH",
"tokenSymbol": "aWETH"
},
{
"chainIndex": "1",
"change": "2.85",
"decimal": "18",
"explorerUrl": "https://web3.okx.com/explorer/ethereum/token/0x4d5f47fa6a74757f35c14fd3a6ef8e3c9bc514e8",
"holders": "34257",
"liquidity": "11463.76396971485790593630247013424890962",
"marketCap": "4750418418.712334041035710975",
"price": "1907.640543775320052289",
"tagList": {
"communityRecognized": false
},
"tokenContractAddress": "0x4d5f47fa6a74757f35c14fd3a6ef8e3c9bc514e8",
"tokenLogoUrl": "https://static.oklink.com/cdn/web3/currency/token/large/1-0x4d5f47fa6a74757f35c14fd3a6ef8e3c9bc514e8-106/type=default_90_0?v=1756917533831",
"tokenName": "Aave Ethereum WETH",
"tokenSymbol": "aEthWETH"
},
{
"chainIndex": "1",
"change": "2.53",
"decimal": "18",
"explorerUrl": "https://web3.okx.com/explorer/ethereum/token/0xf951e335afb289353dc249e82926178eac7ded78",
"holders": "18161",
"liquidity": "573690.521874861978296864780127470294686829",
"marketCap": "118167328.627636452996603343",
"price": "4810.636535713744994382",
"tagList": {
"communityRecognized": false
},
"tokenContractAddress": "0xf951e335afb289353dc249e82926178eac7ded78",
"tokenLogoUrl": "https://static.oklink.com/cdn/web3/currency/token/large/1-0xf951e335afb289353dc249e82926178eac7ded78-106/type=default_90_0?v=1756916429358",
"tokenName": "swETH",
"tokenSymbol": "swETH"
},
{
"chainIndex": "1",
"change": "1.09",
"decimal": "18",
"explorerUrl": "https://web3.okx.com/explorer/ethereum/token/0xa250cc729bb3323e7933022a67b52200fe354767",
"holders": "129",
"liquidity": "432842.271496957013794432695201924702530761",
"marketCap": "308953196.848479131339625307",
"price": "4382.323930133209063397",
"tagList": {
"communityRecognized": false
},
"tokenContractAddress": "0xa250cc729bb3323e7933022a67b52200fe354767",
"tokenLogoUrl": "https://static.oklink.com/cdn/web3/currency/token/default-logo/token_custom_logo_default_f.png/type=default_350_0",
"tokenName": "Few Wrapped Wrapped Ether",
"tokenSymbol": "fwWETH"
},
{
"chainIndex": "1",
"change": "0.86",
"decimal": "18",
"explorerUrl": "https://web3.okx.com/explorer/ethereum/token/0xfae103dc9cf190ed75350761e95403b7b8afa6c0",
"holders": "6051",
"liquidity": "94590.872589521640507013935412981213469",
"marketCap": "97299486.614255600625166281",
"price": "4562.053912037697209607",
"tagList": {
"communityRecognized": false
},
"tokenContractAddress": "0xfae103dc9cf190ed75350761e95403b7b8afa6c0",
"tokenLogoUrl": "https://static.oklink.com/cdn/web3/currency/token/large/1-0xfae103dc9cf190ed75350761e95403b7b8afa6c0-106/type=default_90_0?v=1756918311334",
"tokenName": "rswETH",
"tokenSymbol": "rswETH"
},
{
"chainIndex": "1",
"change": "",
"decimal": "18",
"explorerUrl": "https://web3.okx.com/explorer/ethereum/token/0x8e298734681adbfc41ee5d17ff8b0d6d803e7098",
"holders": "",
"liquidity": "67061.540612104310398692858222227724703",
"marketCap": "256182610.813755222831916009",
"price": "4122.319245593319382348",
"tagList": {
"communityRecognized": false
},
"tokenContractAddress": "0x8e298734681adbfc41ee5d17ff8b0d6d803e7098",
"tokenLogoUrl": "https://static.oklink.com/cdn/web3/currency/token/default-logo/token_custom_logo_default_f.png/type=default_350_0",
"tokenName": "FARM_WETH",
"tokenSymbol": "fWETH"
},
{
"chainIndex": "1",
"change": "",
"decimal": "18",
"explorerUrl": "https://web3.okx.com/explorer/ethereum/token/0x90551c1795392094fe6d29b758eccd233cfaa260",
"holders": "741",
"liquidity": "23765.1203196336624818945354471916846708",
"marketCap": "7169375.619352028020506861",
"price": "4249.361573945986551465",
"tagList": {
"communityRecognized": false
},
"tokenContractAddress": "0x90551c1795392094fe6d29b758eccd233cfaa260",
"tokenLogoUrl": "https://static.oklink.com/cdn/web3/currency/token/large/1-0x90551c1795392094fe6d29b758eccd233cfaa260-106/type=default_90_0?v=1756921635155",
"tokenName": "Fluid Wrapped Ether",
"tokenSymbol": "fWETH"
},
{
"chainIndex": "1",
"change": "",
"decimal": "18",
"explorerUrl": "https://web3.okx.com/explorer/ethereum/token/0xc585df3a8c9ca0c614d023a812624be36161502b",
"holders": "",
"liquidity": "5186.6585198126431857330171348192302664",
"marketCap": "945937.955473011322178552",
"price": "3295.093599759049722035",
"tagList": {
"communityRecognized": false
},
"tokenContractAddress": "0xc585df3a8c9ca0c614d023a812624be36161502b",
"tokenLogoUrl": "https://static.oklink.com/cdn/web3/currency/token/default-logo/token_custom_logo_default_K.png/type=default_350_0",
"tokenName": "Karak - swETH",
"tokenSymbol": "KswETH"
},
{
"chainIndex": "1",
"change": "",
"decimal": "9",
"explorerUrl": "https://web3.okx.com/explorer/ethereum/token/0x3ca992ab59d77f1f72c87617fbff89a61c8dec19",
"holders": "154",
"liquidity": "11744.312223638733976406301174289191332",
"marketCap": "8058.2964779077",
"price": "0.000080582964779077",
"tagList": {
"communityRecognized": false
},
"tokenContractAddress": "0x3ca992ab59d77f1f72c87617fbff89a61c8dec19",
"tokenLogoUrl": "https://static.oklink.com/cdn/web3/currency/token/large/1-0x3ca992ab59d77f1f72c87617fbff89a61c8dec19-106/type=default_90_0?v=1756916858337",
"tokenName": "Halloweth",
"tokenSymbol": "Heth"
},
{
"chainIndex": "1",
"change": "",
"decimal": "18",
"explorerUrl": "https://web3.okx.com/explorer/ethereum/token/0x1609d8aa20295feb8831ae0931bae14acf7a9c91",
"holders": "",
"liquidity": "28860.994451383949923801031550409468869",
"marketCap": "18528.49701055747097576",
"price": "0.000000000044043123",
"tagList": {
"communityRecognized": false
},
"tokenContractAddress": "0x1609d8aa20295feb8831ae0931bae14acf7a9c91",
"tokenLogoUrl": "https://static.oklink.com/cdn/web3/currency/token/default-logo/token_custom_logo_default_W.png/type=default_350_0",
"tokenName": "We The Pepe",
"tokenSymbol": "WTP"
},
{
"chainIndex": "1",
"change": "",
"decimal": "18",
"explorerUrl": "https://web3.okx.com/explorer/ethereum/token/0x76cddf8c2a011f6a0264363ac3f82f2993fc1fab",
"holders": "",
"liquidity": "23132.527870367083040975207711380759535",
"marketCap": "14353.657427732",
"price": "0.000014353657427732",
"tagList": {
"communityRecognized": false
},
"tokenContractAddress": "0x76cddf8c2a011f6a0264363ac3f82f2993fc1fab",
"tokenLogoUrl": "https://static.oklink.com/cdn/web3/currency/token/large/1-0x76cddf8c2a011f6a0264363ac3f82f2993fc1fab-106/type=default_90_0?v=1756920804942",
"tokenName": "We The People",
"tokenSymbol": "POPULI"
},
{
"chainIndex": "1",
"change": "",
"decimal": "9",
"explorerUrl": "https://web3.okx.com/explorer/ethereum/token/0x4a38a8089f8d33d6595ace079f999327a58c700f",
"holders": "",
"liquidity": "10307.401749556132649599477026641937954",
"marketCap": "6914.14719751533",
"price": "0.000000016435254457",
"tagList": {
"communityRecognized": false
},
"tokenContractAddress": "0x4a38a8089f8d33d6595ace079f999327a58c700f",
"tokenLogoUrl": "https://static.oklink.com/cdn/web3/currency/token/large/1-0x4a38a8089f8d33d6595ace079f999327a58c700f-106/type=default_90_0?v=1756938301307",
"tokenName": "New Ethereum Project",
"tokenSymbol": "PROTOCOL"
}
],
"msg": ""
}