{"uid":"cap_lrb24ZW938eLiStMVv41J","slug":"blackwood-state-base-token-price-45fae1be","name":"Blackwood State Base Token Price","description":"Use when you need a crypto token price or market data for a Base token, quoted from on-chain liquidity. Do not use for tokens that only trade off Base or on other DEXs (Aerodrome is not read), price history or OHLC. Returns JSON with the USD price of a token on Base computed on-chain from its deepest Uniswap v3 pool against USDC or WETH, with pool, fee tier and depth for 0.003 USDC per call. Typical response time 1200 ms (p95). Category: Trading.","url":"https://x402-gateway.blackwoodstate8.workers.dev/v1/token-price?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["token"],"properties":{"token":{"type":"string","maxLength":42,"minLength":2,"description":"Token on Base: contract address (0x...) or a symbol like WETH, cbBTC, AERO, DEGEN, VIRTUAL"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["token","symbol","decimals","priceUsd","quote","pool","feeTier","depthUsd","blockNumber","source"],"properties":{"next":{"type":"object","required":["service","tool","method","url","useWhen","sample"],"properties":{"url":{"type":"string","description":"Paid route of the next call"},"tool":{"type":"string","description":"MCP tool name of the same call"},"method":{"enum":["GET","POST"],"type":"string"},"sample":{"type":"string","description":"Free fixed sample of the whole family"},"service":{"type":"string","description":"Service id of the suggested next paid call"},"useWhen":{"type":"string","description":"When the next call is the right one"}},"description":"Suggested next paid call in the same family (call it in a loop when the task continues)","additionalProperties":false},"pool":{"type":["string","null"]},"quote":{"enum":["USDC","WETH"],"type":"string"},"token":{"type":"string"},"source":{"type":"string"},"symbol":{"type":["string","null"]},"feeTier":{"anyOf":[{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},{"type":"null"}]},"decimals":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},"depthUsd":{"type":["number","null"]},"priceUsd":{"type":"number"},"blockNumber":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991}},"additionalProperties":false}}}}},"responseSchema":{"type":"json","example":{"pool":"0x6c561B446416E1A00E8E93E221854d6eA4171372","quote":"USDC","token":"0x4200000000000000000000000000000000000006","source":"Uniswap v3 on Base (on-chain)","symbol":"WETH","feeTier":3000,"decimals":18,"depthUsd":56610101,"priceUsd":2421.2474,"blockNumber":52713897}},"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_cOCtYY6Eu9xGV3h3fhHui","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the real-time USD price of any Base-chain token computed on-chain from its deepest Uniswap v3 pool against USDC or WETH, along with pool address, fee tier, and liquidity depth.","exampleAgentPrompt":"What's the current on-chain USD price of cbBTC on Base? Pull it from the deepest Uniswap v3 pool and also tell me the pool address and liquidity depth.","exampleUseCases":[{"title":"DeFi portfolio valuation on Base","prompt":"I hold VIRTUAL, DEGEN, and cbBTC on Base — what are their current USD prices on-chain so I can calculate my portfolio value?"},{"title":"Token arbitrage price check","prompt":"What's the Uniswap v3 on-chain price of WETH on Base right now, and which pool and fee tier is being used to compute it?"},{"title":"New token price discovery","prompt":"I just saw a new token launched on Base with contract address 0x4ed4e862860bed51a9570b96d89af5e1b0efefed — what's its current USD price from on-chain liquidity?"}],"resultDescription":"A JSON object containing the token's USD price computed from its deepest Uniswap v3 pool on Base, along with the pool contract address, fee tier (e.g. 500, 3000), liquidity depth in USD, the quote currency used (USDC or WETH), token symbol, decimals, block number, and data source. Also includes a suggested next call hint.","failureModes":["Token not found on Base or has no Uniswap v3 pool — returns null price or error","Token only trades on other DEXs (e.g. Aerodrome) — not supported, no price returned","Invalid contract address format — returns validation error","Token exists but has insufficient liquidity for a meaningful price — may return low depth or null","Network latency from on-chain RPC calls may exceed p95 of 1200ms under load"],"whenToPreferThis":"Use this endpoint when you need a real-time, on-chain USD price for a token that trades on Base via Uniswap v3. It is ideal for DeFi portfolio valuation, trade execution checks, or token discovery. Prefer it over off-chain price APIs when trustless, on-chain accuracy matters. Do not use it for tokens that only trade on Aerodrome or other Base DEXs, for tokens on other chains, or for historical prices and OHLC data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-20T15:58:56.250Z","isFirstParty":false,"canonicalSlug":"blackwood-state-base-token-price-45fae1be"}