{"openapi":"3.1.0","info":{"title":"Token List API","version":"1.0.0","description":"A live ERC-20 token metadata directory aggregated from the curated, on-chain token lists that wallets and dApps actually trust — Uniswap Labs Default, CoinGecko, 1inch, Aave and the Optimism Superchain list — read keyless from their public endpoints. Resolve any token contract address on any chain to its canonical name, symbol, decimals and logo; list a curated set in full (paged, filterable by chain); search across every list by symbol or name; and discover a token's bridged addresses on other chains. The metadata layer every wallet, swap UI and portfolio tracker needs before it can safely display or transact a token. Live, short cache only — nothing stored.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/tokenlist-api","description":"oanor gateway"}],"tags":[{"name":"Tokens"},{"name":"Lists"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Tokens"],"summary":"Search tokens by symbol or name across all curated lists","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Symbol or name to search (min 2 chars)","schema":{"type":"string"},"example":"usdc"},{"name":"chain","in":"query","required":false,"description":"EVM chain id filter","schema":{"type":"string"},"example":"1"},{"name":"limit","in":"query","required":false,"description":"Max results (1-200)","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Tokens whose symbol or name matches, deduped by chain id + address across all curated lists. found_in lists where each appears.","count":10,"query":"usdc","source":"tokenlists.org ecosystem","results":[{"name":"USDCoin","symbol":"USDC","address":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","chain_id":1,"decimals":6,"found_in":["uniswap","coingecko","oneinch","aave","optimism"],"logo_uri":"https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png"},{"name":"Aave v2 USDC","symbol":"AUSDC","address":"0xbcca60bb61934080951369a648fb03df4f96263c","chain_id":1,"decimals":6,"found_in":["coingecko","oneinch","aave"],"logo_uri":"https://assets.coingecko.com/coins/images/14318/thumb/aUSDC.e260d492.png?1696514006"},{"name":"Aave v3 USDC","symbol":"AUSDC","address":"0x98c23e9d8f34fefb1b7bd6a91b7ff122f4e16f5c","chain_id":1,"decimals":6,"found_in":["coingecko","oneinch"],"logo_uri":"https://assets.coingecko.com/coins/images/32847/thumb/usdc_%281%29.png?1699619355"},{"name":"Aave v1 USDC","symbol":"AUSDC","address":"0x9ba00d6856a4edf4665bca2c2309936572473b7e","chain_id":1,"decimals":6,"found_in":["coingecko","aave"],"logo_uri":"https://assets.coingecko.com/coins/images/11674/thumb/aUSDC.png?1696511564"},{"name":"Compound USDC","symbol":"CUSDC","address":"0x39aa39c021dfbae8fac545936693ac917d5e7563","chain_id":1,"decimals":8,"found_in":["coingecko","oneinch"],"logo_uri":"https://assets.coingecko.com/coins/images/9442/thumb/Compound_USDC.png?1696509534"},{"name":"Instadapp USDC","symbol":"IUSDC","address":"0xc8871267e07408b89aa5aecc58adca5e574557f8","chain_id":1,"decimals":6,"found_in":["coingecko"],"logo_uri":"https://assets.coingecko.com/coins/images/25820/thumb/iUSDC_100x100.png?1696524905"},{"name":"Spark USDC","symbol":"SUSDC","address":"0xbc65ad17c5c0a2a4d159fa5a503f4992c7b545fe","chain_id":1,"decimals":18,"found_in":["coingecko"],"logo_uri":"https://assets.coingecko.com/coins/images/102173690/thumb/spUSDC_%281%29.png?1781003574"},{"name":"Curve.fi FRAX/USDC","symbol":"CRVFRAX","address":"0x3175df0976dfa876431c2e9ee6bc45b65d3473cc","chain_id":1,"decimals":18,"found_in":["coingecko"],"logo_uri":"https://assets.coingecko.com/coins/images/26829/thumb/W1sQNVWo_400x400.jpeg?1696525888"},{"name":"Aave AMM USDC","symbol":"AAMMUSDC","address":"0xd24946147829deaa935be2ad85a3291dbf109c80","chain_id":1,"decimals":6,"found_in":["coingecko"],"logo_uri":"https://assets.coingecko.com/coins/images/17226/thumb/aAMMUSDC_2x.png?1696516780"},{"name":"aarna atv USDC (Ethereum)","symbol":"ATVUSDC","address":"0xf30f62963cce132f32306d7f18a8587958b30ea9","chain_id":1,"decimals":18,"found_in":["coingecko"],"logo_uri":"https://assets.coingecko.com/coins/images/67895/thumb/atvUSDC_ethereum.png?1765613458"}],"chain_id":1},"meta":{"timestamp":"2026-06-14T08:04:13.749Z","request_id":"5bf19159-60a9-4b4a-9483-74388c3639eb"},"status":"ok","message":"Token search completed successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/token":{"get":{"operationId":"get_v1_token","tags":["Tokens"],"summary":"Resolve a token by contract address (metadata + lists + bridges)","description":"","parameters":[{"name":"address","in":"query","required":true,"description":"Token contract address (0x + 40 hex)","schema":{"type":"string"},"example":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"},{"name":"chain","in":"query","required":false,"description":"EVM chain id to disambiguate (1=Ethereum, 8453=Base, 42161=Arbitrum...)","schema":{"type":"string"},"example":"1"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"name":"USDCoin","note":"Canonical metadata for the token, the curated lists it appears in, and (where published) its bridged addresses on other chains keyed by chain id.","source":"tokenlists.org ecosystem","symbol":"USDC","address":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","chain_id":1,"decimals":6,"found_in":["uniswap","coingecko","oneinch","aave","optimism"],"logo_uri":"https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png","list_count":5,"bridged_addresses":{"10":"0x0b2c639c533813f4aa9d7837caf62653d097ff85","56":"0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d","130":"0x078d782b760474a361dda0af3839290b0ef57ad6","143":"0x754704bc059f8c67012fed69bc8a327a5aafb603","1868":"0xba9986d2381edf1da03b0b9c1f8b00dc4aacc369","42161":"0xaf88d065e77c8cc2239327c5edb3a432268e5831","42220":"0xceba9300f2b948710d2653dd7b07f33a8b32118c","43114":"0xb97ef9ef8734c71904d8002f8b6bc66dd9c48a6e"}},"meta":{"timestamp":"2026-06-14T08:04:13.839Z","request_id":"9682b558-4a8d-45c9-878c-8d535bd3a107"},"status":"ok","message":"Token retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/lists":{"get":{"operationId":"get_v1_lists","tags":["Lists"],"summary":"The curated token lists and their token counts","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Curated, trusted token lists. Use the key with /v1/tokens?list=<key>.","count":5,"lists":[{"key":"uniswap","name":"Uniswap Labs Default","version":"22.1.0","timestamp":"2026-06-11T20:12:01.724Z","source_url":"https://tokens.uniswap.org","token_count":1472},{"key":"coingecko","name":"CoinGecko","version":"1516.0.0","timestamp":"2026-06-13T11:03:02.238+00:00","source_url":"https://tokens.coingecko.com/uniswap/all.json","token_count":4922},{"key":"oneinch","name":"1inch default token list","version":"146.0.0","timestamp":"2025-01-28T16:04:53.109+00:00","source_url":"https://tokens.1inch.eth.limo","token_count":2570},{"key":"aave","name":"Aave Token List","version":"1.3.0","timestamp":"2020-12-11T17:08:18.941Z","source_url":"https://tokenlist.aave.eth.link","token_count":81},{"key":"optimism","name":"Superchain Token List","version":"10.0.1762","timestamp":"2026-06-02T15:26:23.327Z","source_url":"https://static.optimism.io/optimism.tokenlist.json","token_count":1168}],"source":"tokenlists.org ecosystem"},"meta":{"timestamp":"2026-06-14T08:04:13.917Z","request_id":"cdfabace-12ba-4e47-a08c-87c9d7d80214"},"status":"ok","message":"Token lists retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/tokens":{"get":{"operationId":"get_v1_tokens","tags":["Lists"],"summary":"Tokens of one curated list, filterable by chain and paged","description":"","parameters":[{"name":"list","in":"query","required":true,"description":"List key: uniswap, coingecko, 1inch, aave, optimism","schema":{"type":"string"},"example":"uniswap"},{"name":"chain","in":"query","required":false,"description":"EVM chain id filter","schema":{"type":"string"},"example":"1"},{"name":"limit","in":"query","required":false,"description":"Page size (1-1000)","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"list":"uniswap","count":25,"limit":25,"total":390,"offset":0,"source":"tokenlists.org ecosystem","tokens":[{"name":"1inch","symbol":"1INCH","address":"0x111111111117dc0aa78b770fa6a738034120c302","chain_id":1,"decimals":18,"logo_uri":"https://assets.coingecko.com/coins/images/13469/thumb/1inch-token.png?1608803028"},{"name":"Ancient8","symbol":"A8","address":"0x3e5a19c91266ad8ce2477b91585d1856b84062df","chain_id":1,"decimals":18,"logo_uri":"https://assets.coingecko.com/coins/images/39170/standard/A8_Token-04_200x200.png?1720798300"},{"name":"Aave","symbol":"AAVE","address":"0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9","chain_id":1,"decimals":18,"logo_uri":"https://assets.coingecko.com/coins/images/12645/thumb/AAVE.png?1601374110"},{"name":"Arcblock","symbol":"ABT","address":"0xb98d4c97425d9908e66e53a6fdf673acca0be986","chain_id":1,"decimals":18,"logo_uri":"https://assets.coingecko.com/coins/images/2341/thumb/arcblock.png?1547036543"},{"name":"Alchemy Pay","symbol":"ACH","address":"0xed04915c23f00a313a544955524eb7dbd823143d","chain_id":1,"decimals":8,"logo_uri":"https://assets.coingecko.com/coins/images/12390/thumb/ACH_%281%29.png?1599691266"},{"name":"Across Protocol Token","symbol":"ACX","address":"0x44108f0223a3c3028f5fe7aec7f9bb2e66bef82f","chain_id":1,"decimals":18,"logo_uri":"https://assets.coingecko.com/coins/images/28161/large/across-200x200.png?1696527165"},{"name":"ADI","symbol":"ADI","address":"0x8b1484d57abbe239bb280661377363b03c89caea","chain_id":1,"decimals":18,"logo_uri":"https://coin-images.coingecko.com/coins/images/68846/large/ADI_Token-min.png?1765296433"},{"name":"heyAura","symbol":"ADX","address":"0xade00c28244d5ce17d72e40330b1c318cd12b7c3","chain_id":1,"decimals":18,"logo_uri":"https://assets.coingecko.com/coins/images/847/thumb/Ambire_AdEx_Symbol_color.png?1655432540"},{"name":"Aergo","symbol":"AERGO","address":"0x91af0fbb28aba7e31403cb457106ce79397fd4e6","chain_id":1,"decimals":18,"logo_uri":"https://assets.coingecko.com/coins/images/4490/thumb/aergo.png?1647696770"},{"name":"Aevo","symbol":"AEVO","address":"0xb528edbef013aff855ac3c50b381f253af13b997","chain_id":1,"decimals":18,"logo_uri":"https://assets.coingecko.com/coins/images/35893/standard/aevo.png"},{"name":"agEur","symbol":"agEUR","address":"0x1a7e4e63778b4f12a199c062f3efdd288afcbce8","chain_id":1,"decimals":18,"logo_uri":"https://assets.coingecko.com/coins/images/19479/standard/agEUR.png?1696518915"},{"name":"Adventure Gold","symbol":"AGLD","address":"0x32353a6c91143bfd6c7d363b546e62a9a2489a20","chain_id":1,"decimals":18,"logo_uri":"https://assets.coingecko.com/coins/images/18125/thumb/lpgblc4h_400x400.jpg?1630570955"},{"name":"Gensyn","symbol":"AI","address":"0x4d7078ddd6ccfed2f85db5b7d3ff16828d378d48","chain_id":1,"decimals":18,"logo_uri":"https://s2.coinmarketcap.com/static/img/coins/64x64/39883.png"},{"name":"AIOZ Network","symbol":"AIOZ","address":"0x626e8036deb333b408be468f951bdb42433cbf18","chain_id":1,"decimals":18,"logo_uri":"https://assets.coingecko.com/coins/images/14631/thumb/aioz_logo.png?1617413126"},{"name":"Alchemix","symbol":"ALCX","address":"0xdbdb4d16eda451d0503b854cf79d55697f90c8df","chain_id":1,"decimals":18,"logo_uri":"https://assets.coingecko.com/coins/images/14113/thumb/Alchemix.png?1614409874"},{"name":"Aleph im","symbol":"ALEPH","address":"0x27702a26126e0b3702af63ee09ac4d1a084ef628","chain_id":1,"decimals":18,"logo_uri":"https://assets.coingecko.com/coins/images/11676/thumb/Monochram-aleph.png?1608483725"},{"name":"Alethea Artificial Liquid Intelligence","symbol":"ALI","address":"0x6b0b3a982b4634ac68dd83a4dbf02311ce324181","chain_id":1,"decimals":18,"logo_uri":"https://assets.coingecko.com/coins/images/22062/thumb/alethea-logo-transparent-colored.png?1642748848"},{"name":"My Neighbor Alice","symbol":"ALICE","address":"0xac51066d7bec65dc4589368da368b212745d63e8","chain_id":1,"decimals":6,"logo_uri":"https://assets.coingecko.com/coins/images/14375/thumb/alice_logo.jpg?1615782968"},{"name":"Allora","symbol":"ALLO","address":"0x8408d45b61f5823298f19a09b53b7339c0280489","chain_id":1,"decimals":18,"logo_uri":"https://coin-images.coingecko.com/coins/images/70609/large/allo-token.png?1763451165"},{"name":"Alpha Venture DAO","symbol":"ALPHA","address":"0xa1faa113cbe53436df28ff0aee54275c13b40975","chain_id":1,"decimals":18,"logo_uri":"https://assets.coingecko.com/coins/images/12738/thumb/AlphaToken_256x256.png?1617160876"},{"name":"AltLayer","symbol":"ALT","address":"0x8457ca5040ad67fdebbcc8edce889a335bc0fbfb","chain_id":1,"decimals":18,"logo_uri":"https://assets.coingecko.com/coins/images/34608/standard/Logomark_200x200.png"},{"name":"Amp","symbol":"AMP","address":"0xff20817765cb7f73d4bde2e66e067e58d11095c2","chain_id":1,"decimals":18,"logo_uri":"https://assets.coingecko.com/coins/images/12409/thumb/amp-200x200.png?1599625397"},{"name":"Ankr","symbol":"ANKR","address":"0x8290333cef9e6d528dd5618fb97a76f268f3edd4","chain_id":1,"decimals":18,"logo_uri":"https://assets.coingecko.com/coins/images/4324/thumb/U85xTl2.png?1608111978"},{"name":"Aragon","symbol":"ANT","address":"0xa117000000f279d81a1d3cc75430faa017fa5a2e","chain_id":1,"decimals":18,"logo_uri":"https://assets.coingecko.com/coins/images/681/thumb/JelZ58cv_400x400.png?1601449653"},{"name":"ApeCoin","symbol":"APE","address":"0x4d224452801aced8b2f0aebe155379bb5d594381","chain_id":1,"decimals":18,"logo_uri":"https://assets.coingecko.com/coins/images/24383/small/apecoin.jpg?1647476455"}],"chain_id":1,"list_name":"Uniswap Labs Default"},"meta":{"timestamp":"2026-06-14T08:04:13.985Z","request_id":"5332a97e-e969-4223-91d8-50c1ed0da584"},"status":"ok","message":"Tokens retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata & live sample","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"sample":{"lists":5,"uniswap_tokens":1472},"source":"tokenlists.org ecosystem (Uniswap, CoinGecko, 1inch, Aave, Optimism), live","service":"tokenlist-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/lists":"The curated token lists and their token counts.","GET /v1/token":"Resolve a token by address (chain optional): metadata + which lists + bridged addresses.","GET /v1/search":"Search tokens by symbol or name across all lists (q=usdc, optional chain).","GET /v1/tokens":"Tokens of one list (list=uniswap), filterable by chain and paged (limit, offset)."},"chains_note":"chain is an EVM chain id (1=Ethereum, 10=Optimism, 56=BNB, 137=Polygon, 8453=Base, 42161=Arbitrum, 43114=Avalanche).","description":"A live ERC-20 token metadata directory aggregated from the curated on-chain token lists wallets and dApps trust (Uniswap, CoinGecko, 1inch, Aave, Optimism). Resolve any token address to its name/symbol/decimals/logo, list a curated set (paged, chain-filterable), search by symbol or name across every list, and discover a token's bridged addresses on other chains. The metadata layer every wallet, swap UI and portfolio tracker needs. Live, short cache only.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-14T08:04:14.062Z","request_id":"3286f8af-ee35-4150-a7fd-4b9f8901f5de"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":5000,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1190,"monthly_call_quota":110000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3900,"monthly_call_quota":700000,"rps_limit":20,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":11500,"monthly_call_quota":4500000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/tokenlist-api"}