{"uid":"cap_yY75TaQRSDZQsMrHqHMF8","slug":"polygon-dex-amm-pool-reserves-live-pool-state-api-91ff91af","name":"Polygon DEX AMM Pool Reserves & Live Pool State API","description":"Raw AMM pool state for a pair on Polygon PoS: v2 reserves and v3 concentrated liquidity across QuickSwap, 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. WMATIC/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/polygon/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 Polygon PoS (e.g. WMATIC/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":137,"network":"polygon"}},"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_JahRDbgEKamWM-t8u-rdu","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 across QuickSwap, SushiSwap, and Uniswap v3 on Polygon PoS at a stated block.","exampleAgentPrompt":"What are the current raw pool reserves, mid price, fee tier, and TVL for the WMATIC/USDC pair across QuickSwap, SushiSwap, and Uniswap v3 on Polygon right now?","exampleUseCases":[{"title":"Pre-trade slippage estimation on Polygon","prompt":"Before I swap 50,000 USDC for WMATIC on Polygon, can you pull the raw pool reserves and TVL across all venues so I can estimate price impact and slippage?"},{"title":"Cross-DEX arbitrage math setup","prompt":"I want to run arbitrage between QuickSwap and Uniswap v3 on Polygon for the WETH/USDC pair — fetch the live on-chain reserves and mid prices from both pools so I can do the math."},{"title":"TVL monitoring for a Polygon pool","prompt":"What is the current USD TVL and reserve breakdown for the WBTC/WETH pool on Polygon across QuickSwap, SushiSwap, and Uniswap v3?"}],"resultDescription":"Returns per-venue pool data for the requested token pair on Polygon PoS, including: raw token reserves for both assets, pool mid price, fee tier in basis points, USD TVL at the queried block, and the block number at which the snapshot was taken — covering constant-product (QuickSwap, SushiSwap) and concentrated-liquidity (Uniswap v3) pool types.","failureModes":["Unknown or unsupported token pair symbol returns an error or empty result","Token pair not listed on any supported Polygon DEX returns no pool data","Malformed pair string (e.g. missing slash separator) causes a 400 bad request","Temporary RPC or node unavailability may cause stale or failed responses","Very low-liquidity pairs may return near-zero TVL with unreliable mid prices"],"whenToPreferThis":"Choose this endpoint when you need raw, on-chain AMM pool reserves and state specifically on Polygon PoS for computing your own quotes, price impact, slippage, or arbitrage calculations across QuickSwap, SushiSwap, and Uniswap v3. Prefer it over higher-level price or best-execution endpoints when you need the underlying numbers rather than a pre-computed best price. Use sibling endpoints for Arbitrum One or Base if your trading pair is on a different chain.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T18:44:29.219Z","isFirstParty":false}