{"uid":"cap_934EYz9sPcPDHqxsf0qKA","slug":"base-onchain-tools-token-price-e5ee8a33","name":"Base Onchain Tools – Token Price","description":"Eleven read-only endpoints answering questions about Base mainnet that are tedious to assemble from raw RPC: what an unverified contract is actually able to do, whether a token transfer will revert and for what reason, what an arbitrary token is worth, and whether an address is safe to pay. Priced $0.001-$0.04 per call in USDC over x402. No account, no API key, no signup, no minimum, no rate limit to negotiate — the payTo address in the 402 response is the whole integration. Failed calls are not billed. The payment middleware cancels settlement on any 4xx or 5xx, so a malformed parameter or an upstream outage costs nothing. Answers are read live from Base mainnet at request time, with failover across five independent RPC providers. A batch that comes back incomplete is treated as a failure rather than returned with the missing entries as zeros, because a confident wrong answer costs a caller more than an error does. Scope is deliberately narrow: Base mainnet only, reads only, no keys held, nothing stored between requests.","url":"https://base-onchain-tools.dolerite.workers.dev/v1/base/token-price?utm_source=zero.xyz","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":{"address":{"type":"string","description":"ERC-20 token address on Base mainnet"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"symbol":"AERO","verdict":"caution","warnings":["liquid pool prices disagree by 5.5%; thin or manipulated liquidity"],"price_usd":0.4838,"pools_found":8,"liquid_pools":7,"price_source":"uniswap-v3 WETH pool @ 0.3% fee"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.006","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.006/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_dPUJKl0NA6FhbSpo_7Wtd","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.006","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the current USD price of any ERC-20 token on Base mainnet, sourced from live DEX pool data with a safety verdict and liquidity warnings.","exampleAgentPrompt":"What's the current USD price of the AERO token at 0x940181a94A35A4569E4529a3CDfB74e38FD98631 on Base mainnet, and is the price trustworthy given current liquidity?","exampleUseCases":[{"title":"Pre-swap token price check","prompt":"Before I swap on Aerodrome, can you tell me the current USD price of the token at 0x940181a94A35A4569E4529a3CDfB74e38FD98631 on Base and whether the liquidity pools agree on the price?"},{"title":"DeFi portfolio valuation","prompt":"I need to value my Base mainnet holdings — what's the current USD price of the token at 0x4200000000000000000000000000000000000006, and is the price data solid or should I be cautious?"},{"title":"Rug pull / manipulation check","prompt":"I'm about to buy a new token on Base at address 0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA — can you check its current price and tell me if there are any liquidity warnings or signs the price might be manipulated?"}],"resultDescription":"A JSON object containing the token's symbol, current USD price (price_usd), a verdict ('safe', 'caution', or 'warning'), an array of human-readable warnings (e.g. pool disagreement, thin liquidity), the number of pools found and how many are liquid, and the specific pool used as the price source.","failureModes":["Invalid or non-ERC-20 contract address returns a 4xx error (not billed)","Token with no DEX liquidity on Base returns an error rather than a zero price","Incomplete pool data treated as failure rather than partial result (not billed)","Upstream RPC outage across all 5 providers returns a 5xx error (not billed)","Non-Base-mainnet addresses return an error since scope is Base mainnet only"],"whenToPreferThis":"Choose this endpoint when you need a live, DEX-sourced USD price for any ERC-20 token on Base mainnet with built-in liquidity quality signals and manipulation warnings — especially before executing swaps, valuing portfolio holdings, or assessing unfamiliar tokens. It is preferable to raw RPC calls because it aggregates multiple pools, flags disagreements, and provides a safety verdict rather than a bare number. No API key or account is needed; pay $0.006 USDC per successful call via x402.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:34:02.772Z","isFirstParty":false,"canonicalSlug":"base-onchain-tools-token-price-e5ee8a33"}