Skip to content
GET /v1/meta

Service metadata & live sample

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/tokenlist-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/tokenlist-api/v1/meta" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/tokenlist-api/v1/meta", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/tokenlist-api/v1/meta");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/tokenlist-api/v1/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "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
}