{"uid":"cap_6drc-aZ2OWzfWIX9DEhGv","slug":"tollkit-on-chain-token-price-42640edb","name":"Tollkit On-Chain Token Price","description":"Token price in USD from on-chain pools, on Base, Ethereum or Solana: give a token, get its current price from its deepest Uniswap v3 pool (Orca Whirlpool on Solana) against USDC or WETH/SOL, with the pool and its depth, and a flag when liquidity is thin. Read live from the chain, not a price API. $0.003 per call; a token with no pool is not charged.","url":"https://extract.tollkit.dev/chain/price?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"chain":{"enum":["base","ethereum","solana"],"type":"string","default":"base","description":"Which chain to read: \"base\" (default), \"ethereum\" or \"solana\"."},"token":{"type":"string","pattern":"^(0x[0-9a-fA-F]{40}|[1-9A-HJ-NP-Za-km-z]{32,44})$","description":"ERC-20 contract or SPL mint to price."}}},"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.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_r6CytRTDSZz_AnqdS-FYk","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 price of an ERC-20 or SPL token by reading live from its deepest Uniswap v3 or Orca Whirlpool on-chain pool on Base, Ethereum, or Solana.","exampleAgentPrompt":"What's the current on-chain price in USD for the token at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum — read it straight from its Uniswap v3 pool, not a price feed.","exampleUseCases":[{"title":"DeFi portfolio valuation agent","prompt":"Get me the live on-chain price in USD for the token at 0x4200000000000000000000000000000000000006 on Base — I need the pool it's trading in and how deep the liquidity is."},{"title":"Solana token arbitrage check","prompt":"What's the current Orca Whirlpool price for the SPL token with mint Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB on Solana?"},{"title":"Thin liquidity warning before swap","prompt":"Before I swap, can you check the on-chain price and liquidity depth for the Ethereum token 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984 — I want to know if the pool is thin so I don't get slipped."}],"resultDescription":"Returns the token's current USD price derived from its deepest Uniswap v3 (or Orca Whirlpool on Solana) pool against USDC or WETH/SOL, along with the pool address, pool liquidity depth, and a boolean flag indicating whether liquidity is thin. No result or charge is returned if the token has no qualifying pool.","failureModes":["Token has no on-chain pool — endpoint returns no price and no charge is made","Invalid contract address format — rejected by input pattern validation","Chain not supported — must be 'base', 'ethereum', or 'solana'","Pool exists but is extremely thin — result is returned with thin-liquidity flag set to true","Network RPC timeout — live chain read may occasionally fail under congestion"],"whenToPreferThis":"Choose this endpoint when you need a trustless, live on-chain price not sourced from a centralized price oracle or aggregator API. Ideal when you want the actual AMM pool price with liquidity context (pool address, depth, thin-liquidity warning) for Base, Ethereum, or Solana tokens. Prefer it over CoinGecko or CoinMarketCap when the token is newly launched, obscure, or when you need to verify the price hasn't diverged from on-chain reality.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T12:36:39.505Z","isFirstParty":false,"canonicalSlug":"tollkit-on-chain-token-price-42640edb"}