{"uid":"cap_ZaERTQz1t7Aip3AAjxCvQ","slug":"base-amm-pool-reserves-live-pool-state-api-45f1cc3f","name":"Base AMM Pool Reserves & Live Pool State API","description":"Raw AMM pool state for a pair on Base: v2 reserves and v3 concentrated liquidity across BaseSwap, SushiSwap and Uniswap v3. Returns pools[] with venue, surface, feeBps, reserveA, reserveB, price and tvlUsd at a stated blockNumber. Requires ?pair=SYM/SYM (e.g. WETH/USDC). Errors: 400 bad_pair, 404 no_pools, 502 upstream_read_failed. For USD depth already computed use /liquidity. This is the underlying numbers. Chain-pinned; bare /reserves = BSC.","url":"https://x402.donnyautomation.com/base/reserves","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":["pair"],"properties":{"pair":{"type":"string","description":"Token pair as SYM/SYM on Base (e.g. WETH/USDC)."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"ts":"2026-07-31T00:00:00.000Z","chainId":8453,"network":"base"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_m-AmcEupOEMomCT7pKNBH","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns raw AMM pool reserves, mid price, fee tier, and USD TVL for a token pair on Base L2 across BaseSwap, SushiSwap, and Uniswap v3","exampleAgentPrompt":"Pull the live pool reserves, mid price, and TVL for WETH/USDC across all DEXs on Base so I can calculate price impact and slippage before executing my trade.","exampleUseCases":[{"title":"Pre-trade slippage estimation on Base","prompt":"Before I swap 50 ETH for USDC on Base, can you get me the current pool reserves and mid price across BaseSwap, SushiSwap, and Uniswap v3 so I can estimate my slippage?"},{"title":"Cross-venue arbitrage math on Base","prompt":"I think there's an arbitrage opportunity between BaseSwap and Uniswap v3 for the WETH/USDC pair on Base — can you pull the raw pool reserves and fee tiers for both venues right now so I can do the math?"},{"title":"TVL and liquidity snapshot for DeFi dashboard","prompt":"Get me the current TVL and pool state for the USDC/DAI pair on all supported DEXs on Base, including fee tiers and both reserve amounts, so I can update my liquidity dashboard."}],"resultDescription":"Returns per-venue pool data for the requested trading pair on Base, including: both token reserves (raw onchain amounts), pool mid price, fee tier in basis points, and USD TVL — scoped to a specific block — for each of BaseSwap, SushiSwap, and Uniswap v3 pools where the pair exists.","failureModes":["Invalid or unrecognized token pair symbol returns an error or empty result","Pair not listed on any supported Base DEX returns no pool data","Network or RPC node issues on Base L2 may cause timeouts","Stale block data if the chain is experiencing congestion","Payment failure (402) if USDC payment is not included or insufficient"],"whenToPreferThis":"Use this endpoint when you need raw on-chain AMM pool state on Base L2 specifically — reserves, mid price, fee tier, and TVL across BaseSwap, SushiSwap, and Uniswap v3 — to power your own quote math, price impact calculations, slippage models, or arbitrage detection. Prefer this over higher-level quote endpoints when you need the underlying numbers rather than a pre-computed best execution price.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:45:25.964Z","isFirstParty":false}