{"uid":"cap_-gmRcD33HpCDmet-hDk3q","slug":"x402-base-tools-erc-20-token-usd-price-on-base-0305fe11","name":"x402 Base Tools – ERC-20 Token USD Price on Base","description":"The USD price of any ERC-20 on Base, read from its Uniswap v3 and Aerodrome pools against USDC and WETH (ETH/USD from Chainlink). The deepest pool sets the price; each pool's price and depth is listed, and thin markets are flagged. Accepts an address or a symbol such as ETH, USDC, cbBTC, AERO, DEGEN, VIRTUAL.","url":"https://base.kagurazaka.dev/v1/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":["token"],"properties":{"token":{"type":"string","description":"token address, or a symbol: ETH, WETH, USDC, CBBTC, AERO, DAI, USDT, DEGEN, BRETT, VIRTUAL, CBETH, WSTETH, EURC"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"token":{},"source":{},"price_usd":{},"low_liquidity":{}}}}}}},"responseSchema":{"type":"json","example":{"token":{"symbol":"AERO","address":"0x9401...","decimals":18},"source":{"dex":"aerodrome","pool":"0x...","quote":"USDC","depth_usd":5000000},"price_usd":0.83,"low_liquidity":false}},"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_hLWr1qAm5-Jdha1uWxGrG","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 USD price of any ERC-20 token on Base by reading its deepest Uniswap v3 or Aerodrome liquidity pool, with per-pool depth and liquidity quality flags.","exampleAgentPrompt":"What's the current USD price of AERO on Base — pull it from the deepest on-chain pool and tell me if liquidity is thin?","exampleUseCases":[{"title":"DeFi portfolio USD valuation","prompt":"What's the current USD price of VIRTUAL on Base? I want to value my holdings and need to know which pool is being used and whether liquidity is deep enough to trust the price."},{"title":"Low-liquidity risk check before trade","prompt":"Before I swap, can you check the USD price of DEGEN on Base and flag it if the pool liquidity is too thin to get a reliable quote?"},{"title":"cbBTC on-chain price verification","prompt":"Get me the on-chain USD price of cbBTC on Base from its Uniswap v3 or Aerodrome pool — I want to see the pool address and depth so I can verify it against my off-chain feed."}],"resultDescription":"A JSON object containing the token's symbol, address, and decimals; the source DEX (Uniswap v3 or Aerodrome), pool address, quote currency, and pool depth in USD; the computed USD price; and a boolean flag indicating whether the market is thin (low_liquidity).","failureModes":["Unknown or unsupported token symbol returns an error or empty result","Token with no Uniswap v3 or Aerodrome pool returns no price data","Very new tokens with no liquidity may be flagged as low_liquidity or return null","Stale Chainlink ETH/USD feed could cause slightly inaccurate WETH-quoted prices","Malformed contract address input may return a validation error"],"whenToPreferThis":"Use this endpoint when you need a real-time, on-chain USD price for an ERC-20 token on the Base network, especially when you want pool-level transparency (which DEX, which pool, how deep). Prefer it over off-chain price oracles or centralized exchange APIs when auditability and on-chain sourcing matter, or when dealing with Base-native tokens like AERO, DEGEN, BRETT, or VIRTUAL that may not be listed on major CEXs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:37:14.144Z","isFirstParty":false,"canonicalSlug":"x402-base-tools-erc-20-token-usd-price-on-base-0305fe11"}