{"uid":"cap_ZRedkKFY-_AFY_LH5-E8t","slug":"erc-20-token-usd-spot-price-onchain-8b4f34fb","name":"ERC-20 Token USD Spot Price (Onchain)","description":"Crypto token price: live USD price, 24h change, total supply and FDV for any token, read onchain from DEX pools (Uniswap v3 on Ethereum, Base, Arbitrum, Polygon; Orca, Raydium, PumpSwap on Solana), so every number is verifiable. Pass token (ETH, BTC, SOL, PEPE... or contract/mint address), optional chain. Returns price, change, pools, depth, spread, confidence, block. 0.002 USDC/call; failed calls are free.","url":"https://x402-seller-pmlm.onrender.com/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":{"chain":{"enum":["ethereum","base","arbitrum","polygon","solana"],"type":"string","description":"Chain for an address (default ethereum); symbols use their deepest chain"},"token":{"type":"string","maxLength":42,"minLength":1,"description":"Symbol (ETH, WETH, BTC, WBTC, CBBTC, USDC, USDT, DAI, LINK, UNI, AAVE, PEPE, ...) or ERC-20 contract address"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["token","priceUsd","pools","block"],"properties":{"block":{"type":"object","properties":{"number":{"type":"integer"},"timestamp":{"type":"string"}}},"pools":{"type":"array","items":{"type":"object"}},"token":{"type":"object","properties":{"name":{"type":["string","null"]},"chain":{"type":"string"},"symbol":{"type":["string","null"]},"address":{"type":"string"},"decimals":{"type":"integer"}}},"fdvUsd":{"type":"number","description":"Fully diluted valuation = price x total supply (not circulating market cap)"},"method":{"type":"string"},"priceUsd":{"type":"number"},"confidence":{"enum":["high","medium","low"],"type":"string"},"generatedAt":{"type":"string"},"totalSupply":{"type":"number","description":"Token total supply read from the contract / mint"},"change24hPct":{"type":["number","null"],"description":"% change vs ~24 h ago (EVM: pool oracle or archive node; null on Solana)"},"poolSpreadPct":{"type":"number"},"totalDepthUsd":{"type":"number"},"priceUsd24hAgo":{"type":"number"}}}}}}},"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_fnkd_Hk8uG09SH1zO-O6Q","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 current USD spot price of any ERC-20 token (by symbol or contract address) using Uniswap v3 pools on Ethereum, Base, Arbitrum, or Polygon, along with pool depth, spread, and confidence.","exampleAgentPrompt":"What's the current onchain USD price of LINK on Arbitrum? I need the Uniswap v3 spot price with confidence level and pool depth.","exampleUseCases":[{"title":"DeFi portfolio valuation agent","prompt":"I need the current USD price of PEPE on Ethereum — include the pool depth and confidence level so I know how reliable the price is."},{"title":"Arbitrage bot price check","prompt":"What's the onchain spot price of UNI on Base right now? I want to see the cross-pool spread percentage to check for arbitrage opportunities."},{"title":"Onchain price verification for a trade","prompt":"Before I execute this swap, can you look up the current USD price of the token at address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum so I can verify I'm getting a fair rate?"}],"resultDescription":"Returns a JSON object with: token metadata (name, symbol, address, chain, decimals), current USD price (priceUsd as a number), array of Uniswap v3 pools used for pricing, total liquidity depth in USD (totalDepthUsd), cross-pool spread percentage (poolSpreadPct), a confidence rating ('high', 'medium', or 'low'), the pricing method used, block number and timestamp at which the price was captured, and a generatedAt timestamp.","failureModes":["400 Bad Request — invalid or malformed token symbol/address input","422 Unprocessable Entity — token not found on specified chain or no Uniswap v3 pool exists for it","503 Service Unavailable — upstream node or pricing service temporarily busy; not charged","Token with very low liquidity may return 'low' confidence and wide pool spread","Providing an address on the wrong chain returns 422 or incorrect pricing"],"whenToPreferThis":"Choose this endpoint when an agent needs a verifiable, onchain-sourced USD price for any ERC-20 token — especially when trust and auditability matter (block number and pool data are returned). Prefer this over centralized exchange price feeds when the token is DeFi-native, not listed on major CEXes, or when the agent needs pool depth and spread data for trading decisions. Ideal for DeFi agents, arbitrage bots, portfolio valuations, and trade pre-checks on Ethereum, Base, Arbitrum, or Polygon.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T06:33:54.437Z","isFirstParty":false,"canonicalSlug":"erc-20-token-usd-spot-price-onchain-8b4f34fb"}