{"uid":"cap_VniOEBGdK2tWZTxsQyOCy","slug":"base-token-info-lookup-8ff2a3fc","name":"Base Token Info Lookup","description":"The cheapest way to look up a Base token: name, symbol, decimals, total supply, holder count, price, liquidity, pool count, largest pool, FDV and 24h volume, from Blockscout and DexScreener. Deterministic, no LLM, seconds per call. It is the data half of token_check; for contract ownership, holder concentration and a honeypot simulation, buy that instead. Informational only.","url":"https://aiworker.duckdns.org/v1/token/info","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"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"chain":{"enum":["base"],"type":"string","description":"chain to look up; only \"base\" is supported in v1"},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"a Base (chain id 8453) token contract address"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"chain":{"type":"string"},"token":{"type":["object","null"],"properties":{"name":{"type":"string"},"symbol":{"type":"string"},"decimals":{"type":"integer"},"total_supply":{"type":"string"},"holders_count":{"type":"integer"}}},"market":{"type":["object","null"],"properties":{"pools":{"type":"integer"},"fdv_usd":{"type":["number","null"]},"price_usd":{"type":["number","null"]},"largest_pool":{"type":["object","null"],"properties":{"dex":{"type":"string"},"pair_address":{"type":"string"},"liquidity_usd":{"type":"number"}}},"volume_24h_usd":{"type":["number","null"]},"liquidity_usd_total":{"type":"number"}}},"address":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"ok":{"type":"boolean"},"url":{"type":"string"},"name":{"type":"string"}}}},"disclaimer":{"type":"string"},"attribution":{"type":"string"},"generated_at":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"chain":"eip155:8453","token":{"name":"Brett","symbol":"BRETT","decimals":18,"total_supply":"9999997544340006294456944163","holders_count":948041},"market":{"pools":8,"fdv_usd":53458106,"price_usd":0.005394,"largest_pool":{"dex":"uniswap","pair_address":"0xBA3F945812a83471d709BCe9C3CA699A19FB46f7","liquidity_usd":1207067.33},"volume_24h_usd":8578.98,"liquidity_usd_total":2418020.38},"address":"0x532f27101965dd16442E59d40670FaF5eBB142E4","sources":[{"ok":true,"url":"https://base.blockscout.com/api/v2/tokens/0x532f27101965dd16442E59d40670FaF5eBB142E4","name":"blockscout_token"}],"disclaimer":"Informational only; not investment advice. A data lookup, not a safety check: contract, holder and honeypot analysis is token_check.","attribution":"Data: Blockscout (Base), DexScreener (derived)","generated_at":"2026-09-09T00:00:00.000Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_uT6rs2kHxxTPKp4q0zu2l","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns name, symbol, decimals, total supply, holder count, price, liquidity, pool count, largest pool, FDV, and 24h volume for any Base chain token contract address.","exampleAgentPrompt":"Can you look up the token at 0x532f27101965dd16442E59d40670FaF5eBB142E4 on Base and tell me its name, price, total liquidity, 24h volume, and how many holders it has?","exampleUseCases":[{"title":"Pre-trade token research","prompt":"Before I buy, can you pull the market data for the Base token at 0xBA3F945812a83471d709BCe9C3CA699A19FB46f7 — I want to see the price, FDV, total liquidity, 24h volume, and how many pools it's trading on?"},{"title":"Holder count monitoring","prompt":"How many holders does the BRETT token at 0x532f27101965dd16442E59d40670FaF5eBB142E4 on Base currently have, and what's its total supply?"},{"title":"Largest pool identification","prompt":"Which DEX has the biggest liquidity pool for the Base token at 0x532f27101965dd16442E59d40670FaF5eBB142E4, and how much liquidity is in it?"}],"resultDescription":"A JSON object with: chain identifier, token metadata (name, symbol, decimals, total_supply, holders_count), market data (price_usd, fdv_usd, liquidity_usd_total, volume_24h_usd, pools count, largest_pool with DEX name/pair address/liquidity), data sources with health status, attribution, disclaimer, and generated_at timestamp.","failureModes":["Invalid contract address format returns validation error","Token not found on Blockscout returns null token object","Token has no DEX pools returns null market object","Blockscout or DexScreener API unavailable returns partial data with source ok:false flags","Only Base (chain id 8453) is supported; other chains are rejected"],"whenToPreferThis":"Choose this endpoint when you need fast, cheap ($0.005/call), deterministic token metadata and market data for a Base chain token — especially price, liquidity, FDV, volume, and holder count — without needing safety analysis. Use the sibling token_check endpoint instead if you also need contract ownership analysis, holder concentration risk, or honeypot simulation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:44:10.803Z","isFirstParty":false}