{"uid":"cap_In_sLW5Wv2J7J9X2PUHYo","slug":"agenttoll-base-token-usd-price-a3cd45f3","name":"AgentToll Base Token USD Price","description":"Base token price lookup by contract address: the onchain USD price for any token on Base","url":"https://agenttoll.app/api/base/token/:address","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"},"pathParams":{"type":"object","required":["address"],"properties":{"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}}},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_L0hqBPZmd8w82Eg1pCK5S","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the current on-chain USD price for any Base network token identified by its contract address","exampleAgentPrompt":"What's the current USD price of the Base token at contract address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913?","exampleUseCases":[{"title":"Portfolio valuation for Base tokens","prompt":"I hold some USDC on Base at address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 — what's it currently worth in USD per token?"},{"title":"DeFi arbitrage price check","prompt":"Can you fetch the live on-chain USD price for the Base token at 0x4200000000000000000000000000000000000006 so I can compare it to what I'm seeing on a CEX?"},{"title":"Token price alert evaluation","prompt":"Look up the current USD price for the Base token at contract 0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb — I want to know if it's moved since I last checked."}],"resultDescription":"Returns the current on-chain USD price (in USD) for the specified Base network ERC-20 token contract address, sourced from on-chain liquidity data.","failureModes":["Invalid contract address format (not a valid 0x hex address) — validation error","Contract address does not exist on Base or has no liquidity — price unavailable or null response","Token has insufficient on-chain liquidity for a reliable price — may return stale or zero price","Network or RPC issues causing price fetch failure — service error response","Payment not processed correctly (x402) — 402 Payment Required error"],"whenToPreferThis":"Use this endpoint when you need an on-chain USD price for any ERC-20 token specifically deployed on the Base network and you have the contract address. It is ideal for DeFi agents, portfolio trackers, and arbitrage bots that need token prices anchored to actual on-chain state rather than centralized exchange feeds. Prefer this over CEX price APIs when Base-specific liquidity data matters or when the token is not listed on major exchanges.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:51:55.750Z","isFirstParty":false}