{"uid":"cap_MX3ZWVhtqaPRJMyEacxzu","slug":"base-erc-20-single-token-on-chain-spot-price-e16fb1b5","name":"Base ERC-20 Single Token On-Chain Spot Price","description":"Price of ONE token: on-chain USD spot price for a single ERC-20 on Base, from the deepest Uniswap v3 pool vs USDC/WETH (slot0), with the pool/fee tier used and its USD depth. No off-chain feed; thin pools are easy to manipulate. To price MANY tokens at once, use multi-token-price instead (one cheaper call).","url":"https://auditor-x402.onrender.com/api/token-spot-price?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"tokenAddress":{"type":"string","description":"ERC-20 token contract address (0x...) on Base"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_qBSPdHtBMfbCmt0VRaOrd","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the on-chain USD spot price for a single ERC-20 token on Base, sourced from the deepest Uniswap v3 pool against USDC or WETH, including pool address, fee tier, and USD liquidity depth.","exampleAgentPrompt":"What's the current on-chain USD spot price for the token at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base — and which Uniswap v3 pool and fee tier is being used to price it?","exampleUseCases":[{"title":"Token valuation for DeFi portfolio tracker","prompt":"Can you get me the current on-chain USD price for the ERC-20 token at 0x2Ae3F1Ec7F1F5012CFEab0185bfc7aa3cf0DEc22 on Base, including which Uniswap v3 pool is being used?"},{"title":"Liquidity depth check before a swap","prompt":"Before I swap, what's the current on-chain spot price of the token at 0x4200000000000000000000000000000000000006 on Base, and how deep is the liquidity in that Uniswap pool in USD terms?"},{"title":"Smart contract audit price sanity check","prompt":"I'm auditing a contract that references 0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb — can you tell me what the on-chain Uniswap v3 spot price is in USD for that token on Base and which fee tier pool is used?"}],"resultDescription":"Returns the USD spot price for the requested ERC-20 token on Base, derived from the deepest Uniswap v3 pool (slot0 read). Also includes the pool contract address, the fee tier (e.g. 500, 3000, 10000 bps), and the pool's USD liquidity depth. Thin pools are flagged implicitly by low depth values, which signals manipulation risk.","failureModes":["Token address not found on Base — no Uniswap v3 pool exists for the token, returns error or null price","Token is only traded in very thin pools — price returned but depth is very low, indicating high manipulation risk","Invalid or malformed ERC-20 address input — returns a validation error","Token has no USDC or WETH pairing on Uniswap v3 — cannot compute USD price","RPC/node timeout reading slot0 on-chain — may return a transient error","Render cold-start latency — service may be slow to respond if instance was idle"],"whenToPreferThis":"Use this endpoint when you need the on-chain USD spot price for a single ERC-20 token on Base and want full transparency into which Uniswap v3 pool and fee tier is used, along with liquidity depth context. Prefer this over off-chain price feeds when trustlessness and auditability matter. If you need prices for multiple tokens, use the sibling multi-token-price batch endpoint instead to save on call costs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:03:57.141Z","isFirstParty":false,"canonicalSlug":"base-erc-20-single-token-on-chain-spot-price-e16fb1b5"}