{"uid":"cap_uHm8o7t-ekp98d_uoxM2K","slug":"beggar-bot-token-price-94a03097","name":"Beggar Bot Token Price","description":"Paid: /v1/verify, /v1/risk, /v1/receipt cost $0.01 USDC per call on Base mainnet via x402 (payTo 0x719227f384b66BFEF00093D6d8d32fA9dC2B40e7); utilities analyze Base mainnet (USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) by default, network=base-sepolia optional; /v1/receipt/verify and discovery files are free. Operator: Beggar Bot.","url":"https://beggar-bot-demand.beggarbot.workers.dev/v1/tokenprice?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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["tokens"],"properties":{"chain":{"type":"string","description":"base (default) or ethereum"},"tokens":{"type":"string","description":"comma list of token addresses (≤4)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_jTxqVV9sgv_RIg4gDCmgw","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns on-chain spot USD price for up to 4 ERC-20 tokens using Uniswap v3 slot0 and Aerodrome reserve data on Base or Ethereum, with liquidity confidence flags.","exampleAgentPrompt":"What's the current on-chain USD spot price for WETH and USDC on Base — and flag if either has thin liquidity or a big cross-pool spread?","exampleUseCases":[{"title":"DeFi trade entry price check","prompt":"Before I swap, pull the on-chain USD price for 0x4200000000000000000000000000000000000006 on Base and tell me if liquidity looks solid or if there's a divergence warning."},{"title":"Multi-token portfolio valuation","prompt":"Get me the current spot USD prices for these four tokens on Base: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, 0x4200000000000000000000000000000000000006, 0x2Ae3F1Ec7F1F5012CFEab0185bfc7aa3cf0DEc22, 0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA — and flag any thin liquidity."},{"title":"Arbitrage spread monitoring","prompt":"Check the cross-pool spread on Uniswap v3 and Aerodrome for token 0x940181a94A35A4569E4529A3CDfB74e38FD98631 on Base and let me know if the spread is unusually wide."}],"resultDescription":"A JSON response containing the spot USD price for each requested token, the deepest pool identified by quote-side liquidity, cross-pool spread between DEX sources, boolean flags for thin liquidity and price divergence, and an overall confidence score. Pools are derived via CREATE2 — no external indexer or API key required.","failureModes":["Invalid or non-existent token address returns error or null price","More than 4 tokens requested in a single call exceeds limit","Unsupported chain identifier returns validation error","Token with no Uniswap v3 or Aerodrome pool returns no price data","Network RPC failure causes timeout or empty response","Extremely low liquidity token may return price with low confidence flag"],"whenToPreferThis":"Choose this endpoint when you need trustless, on-chain token prices without relying on centralized price oracles, CoinGecko, or API keys. Ideal for DeFi agents that need real-time Uniswap v3 and Aerodrome prices with liquidity quality signals on Base or Ethereum. Prefer it over off-chain price APIs when you need cross-pool spread awareness and thin-liquidity flags for safe trade execution.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T18:33:25.628Z","isFirstParty":false,"canonicalSlug":"beggar-bot-token-price-94a03097"}