{"uid":"cap_hit-4nmc5Yw4S_lYHdulu","slug":"agent-data-tools-erc-20-token-price-lookup-via-uniswap-v3-4b8046b2","name":"Agent Data Tools: ERC-20 Token Price Lookup via Uniswap v3","description":"Crypto token USD price by ticker (ETH, BTC, USDC, AERO, ARB, OP, LINK…) or by any ERC-20 0x address on Base, Ethereum, Arbitrum or Optimism, from the deepest Uniswap v3 pool against USDC or WETH, read live from the chain. Returns the pool, its fee tier, the quote reserve and a thin-liquidity flag. Spot price, not a time average. No pool returns 404, uncharged. Use to value a token or check a quote before a swap or payment.","url":"https://agent-data-tools.revmesh2074.workers.dev/price/token?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"chain":{"enum":["base","eth","arb","op"],"type":"string","description":"Network: base (default), eth, arb or op"},"symbol":{"type":"string","description":"Ticker such as ETH, BTC, USDC, AERO, ARB, OP or LINK (instead of address; ETH and BTC mean the wrapped tokens)"},"address":{"type":"string","description":"0x ERC-20 token contract address (instead of symbol)"}}},"responseSchema":{"type":"object","properties":{"pool":{"type":"object","properties":{"address":{"type":"string"},"feeTier":{"type":"number"},"quoteReserve":{"type":"number"},"quoteReserveUsd":{"type":"number"}}},"block":{"type":"number"},"chain":{"type":"string"},"token":{"type":"object","properties":{"symbol":{"type":"string"},"address":{"type":"string"},"decimals":{"type":"number"}}},"ethUsd":{"type":"number"},"method":{"type":"string"},"chainId":{"type":"number"},"priceUsd":{"type":"number"},"quotedIn":{"type":"string"},"thinLiquidity":{"type":"boolean"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USD","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_n-WjQWkCEJE-fFTAt_cYI","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","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 spot price of an ERC-20 token on Base, Ethereum, Arbitrum, or Optimism by querying the Uniswap v3 pool with the largest USDC or WETH reserve.","exampleAgentPrompt":"What's the current USD price of the cbBTC token at contract address 0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf on Base, and which Uniswap v3 pool is it quoted from?","exampleUseCases":[{"title":"DeFi portfolio valuation check","prompt":"I hold some AERO tokens on Base — the contract is 0x940181a94A35A4569E4529A3CDfB74e38FD98631. What's the current USD price so I can value my position?"},{"title":"Cross-chain token price comparison","prompt":"Can you get me the current USD price of USDC on Ethereum at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48, then do the same on Arbitrum, so I can compare?"},{"title":"Thin liquidity alert for new token","prompt":"Check the USD price for this new token on Base: contract 0x1234567890abcdef1234567890abcdef12345678 — and let me know if Uniswap flags it as having thin liquidity."}],"resultDescription":"A JSON object containing: the token's current USD spot price (priceUsd), the token symbol and decimals, the Uniswap v3 pool address and fee tier used for pricing, the pool's USDC reserve size and its USD value, the quote currency (USDC or WETH), the ETH/USD rate used, the current block number, chain name and chain ID, a thinLiquidity boolean warning, and the pricing method description.","failureModes":["Token contract address not found on the specified chain — returns error or empty result","No Uniswap v3 pool exists for the token — cannot determine price","thinLiquidity flag set true — price may be unreliable due to low pool reserves","Invalid or malformed contract address — request rejected","Unsupported chain specified — only base, eth, arb, op are valid","x402 payment failure — call not charged but no result returned"],"whenToPreferThis":"Use this endpoint when you need a real-time, on-chain USD spot price for any ERC-20 token on Base, Ethereum, Arbitrum, or Optimism, sourced directly from Uniswap v3 liquidity pools. It is best for DeFi agents, portfolio trackers, and trading bots that need decentralized, trustless price data rather than centralized exchange quotes. Prefer this over CoinGecko or CoinMarketCap APIs when you want the actual on-chain price a trade would execute at, or when the token is not listed on major CEXes. The thin liquidity flag helps agents avoid acting on unreliable prices for low-cap tokens.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-20T15:58:56.249Z","isFirstParty":false,"canonicalSlug":"agent-data-tools-erc-20-token-price-lookup-via-uniswap-v3-4b8046b2"}