{"uid":"cap_k8tKL8j4tA_iqk-Q2Y6Tz","slug":"blockscout-token-list-api-fc7ef079","name":"Blockscout Token List API","description":"Explore crypto activities with Blockscout's multichain search. Find transactions, addresses, tokens, and dapps across top blockchain networks — your go-to explorer for cross-chain blockchain data","url":"https://api.blockscout.com/%7Bchain_id%7D/api/v2/tokens","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"pathParams":{"type":"object","properties":{"chain_id":{"type":"string"}}},"queryParams":{"type":"object","properties":{"q":{"type":"string"},"name":{"type":"string"},"sort":{"type":"string"},"type":{"type":"string"},"limit":{"type":"integer"},"order":{"type":"string"},"fiat_value":{"type":"string"},"market_cap":{"type":"string"},"items_count":{"type":"integer"},"is_name_null":{"type":"boolean"},"holders_count":{"type":"string"},"contract_address_hash":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"items":[{"name":"string","type":{},"symbol":"string","decimals":"string","icon_url":"string","reputation":"string","volume_24h":"string","bridge_type":"string","address_hash":"string","total_supply":"string","exchange_rate":"string","holders_count":"string","foreign_address":"string","origin_chain_id":"string","circulating_supply":"string","circulating_market_cap":"string"}],"next_page_params":{}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_sO4H9XEOIRxZ_saty-7EJ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves a paginated list of tokens on a specified blockchain network, with filtering and sorting options","exampleAgentPrompt":"Can you use Blockscout to list the top ERC-20 tokens by market cap on Base (chain ID 8453), showing up to 25 results sorted descending?","exampleUseCases":[{"title":"Discover top tokens on a chain","prompt":"Show me the top 20 tokens on Arbitrum sorted by market cap — I want to see their symbols, circulating supply, and exchange rates."},{"title":"Find a token by contract address","prompt":"Look up the token at contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum mainnet using Blockscout and give me its name, decimals, and holder count."},{"title":"Research bridged tokens on L2","prompt":"Can you pull a list of bridged tokens on Optimism from Blockscout and tell me their origin chain IDs and foreign addresses?"}],"resultDescription":"A paginated JSON response containing an array of token objects, each with fields including name, symbol, decimals, type, icon URL, exchange rate, holders count, total supply, circulating supply, circulating market cap, 24h volume, bridge type, and contract address hash; plus next_page_params for cursor-based pagination.","failureModes":["Invalid or unsupported chain_id returns an error or empty result","Malformed contract_address_hash returns no results","Pagination with stale next_page_params may return unexpected data","Rate limiting or payment failure returns 402 or 429 status","No tokens match the given filter criteria, returning an empty items array"],"whenToPreferThis":"Use this endpoint when you need to enumerate or search for tokens on a specific blockchain supported by Blockscout, especially when you need rich metadata like market cap, holder counts, exchange rates, and bridge information. Prefer this over generic explorers when working with EVM-compatible chains and needing multichain coverage in a single API family.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-12T00:56:14.036Z","isFirstParty":false}