{"uid":"cap_2t8OmjrL3hoXhswpu2kWW","slug":"routheus-token-search-api-bcfc5515","name":"Routheus Token Search API","description":"Routheus: live DEX token prices and best-route swap quotes from a real-time pool-state engine, executable routes with calldata (Permit2), simulation-verified outputs, token metadata, search and pool data on 13+ EVM chains. Pay per call in USDC via x402 — no API keys, no subscription.","url":"https://routheus.xyz/%7Bchain%7D/api/tokens/search?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["query"],"properties":{"page":{"type":"string","description":"Page number"},"query":{"type":"string","description":"Address, symbol or name fragment"},"page_size":{"type":"string","description":"Page size"}}},"responseSchema":{"type":"object","required":["ok"],"properties":{"ok":{"type":"boolean"},"page":{"type":"integer"},"total":{"type":"integer"},"tokens":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"is_hub":{"type":"boolean"},"symbol":{"type":"string"},"address":{"type":"string"},"decimals":{"type":"integer"},"pool_count":{"type":"integer"}}}},"page_size":{"type":"integer"},"total_pages":{"type":"integer"}}},"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_xJ5kq3hFeXxinsMfHkeep","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":"Search for EVM tokens by address, symbol, or name fragment across 13+ chains, returning paginated token metadata from live DEX pool data","exampleAgentPrompt":"Search Routheus on the Base chain for tokens matching 'USDC' — I want to see the contract address, decimals, and how many DEX pools it appears in.","exampleUseCases":[{"title":"Resolve token address before swap","prompt":"On Arbitrum, search for the token symbol 'ARB' using Routheus and give me its contract address and decimals so I can set up a swap route."},{"title":"Discover new tokens on a chain","prompt":"I want to explore what tokens matching 'pepe' are available on Ethereum DEXes — can you search Routheus and show me the top results with pool counts?"},{"title":"Validate token before DeFi workflow","prompt":"Before I build a swap transaction, use Routheus to find the contract address and pool count for 'WETH' on Optimism so I can confirm it's actively traded."}],"resultDescription":"Returns a paginated list of tokens matching the query on the specified chain. Each token entry includes its name, symbol, contract address, decimals, pool count, and whether it is a hub token. Also includes total result count, current page, page size, and total pages for pagination.","failureModes":["Query returns empty token list if symbol or name has no match on the specified chain","Invalid or unsupported chain identifier returns an error or empty result","Malformed address fragment may return zero results","Payment failure via x402 protocol blocks the request before execution","Rate or quota issues if payment is not processed correctly","Pagination out of bounds (page number exceeds total_pages) returns empty tokens array"],"whenToPreferThis":"Use this endpoint when you need to resolve a token symbol, name, or partial address to a verified contract address and metadata on a specific EVM chain before constructing a swap or price query. It is especially useful in agentic DeFi workflows where the downstream swap or quote endpoint requires an exact contract address. Prefer this over generic blockchain explorers when you need DEX-specific signals like pool count and hub status, or when operating across 13+ EVM chains without managing separate API keys.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T06:42:19.201Z","isFirstParty":false,"canonicalSlug":"routheus-token-search-api-bcfc5515"}