{"uid":"cap_8A4pk9TAq-i2WVULBt85_","slug":"polygon-dex-liquidity-market-depth-api-107b774f","name":"Polygon DEX Liquidity & Market Depth API","description":"Per-venue USD liquidity and TVL for a pair on Polygon PoS across QuickSwap, SushiSwap and Uniswap v3. Returns totalTvlUsd, venueCount, deepestVenue and venues[] with each venue share and reserves. Requires ?pair=SYM/SYM (e.g. WMATIC/USDC). Errors: 400 bad_pair (malformed, or a ticker unknown on this chain), 404 no_pools, 502 upstream_read_failed. Raw pool numbers are /reserves; a one-word verdict is /risk; price is /price. Chain-pinned; bare /liquidity = BSC.","url":"https://x402.donnyautomation.com/polygon/liquidity","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_mgsvqNnj2Ljl8_uVI7weB","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 per-venue DEX liquidity, market depth, TVL, and pool reserves for a token pair on Polygon PoS across QuickSwap, SushiSwap, and Uniswap v3","exampleAgentPrompt":"What's the current liquidity depth for WMATIC/USDC across all Polygon DEXs — show me per-venue TVL, pool reserves, and which venue is deepest right now?","exampleUseCases":[{"title":"Pre-trade slippage check on Polygon","prompt":"Before I swap a large amount of WBTC for USDC on Polygon, can you check how deep the liquidity pools are across QuickSwap, SushiSwap, and Uniswap v3 so I know which venue to route through?"},{"title":"Order routing for DeFi aggregator","prompt":"I need to route a WETH/USDC trade on Polygon — pull live liquidity depth and venue market shares so I can pick the deepest DEX and minimize slippage."},{"title":"Stablecoin pool TVL monitoring","prompt":"What's the current TVL and pool reserves for the USDC/USDT pair on Polygon across all DEX venues, and which one holds the biggest share of the liquidity right now?"}],"resultDescription":"Returns a breakdown of DEX liquidity for the requested Polygon token pair: per-venue USD liquidity (QuickSwap, SushiSwap, Uniswap v3), raw pool reserves for both tokens, each venue's share of total market depth, combined TVL, and identification of the deepest venue to trade against — all reflecting live on-chain state.","failureModes":["Unsupported or misspelled token pair symbol returns an error or empty result","Pair not listed on any supported Polygon DEX returns zero liquidity","Network congestion may cause momentary stale or delayed on-chain reads","Invalid pair format (not SYM/SYM) causes schema validation failure","Low-liquidity exotic pairs may return near-zero values that appear as failures"],"whenToPreferThis":"Choose this endpoint when you need live, multi-venue DEX liquidity data specifically on Polygon PoS — especially for slippage estimation, order routing, or pool TVL monitoring across QuickSwap, SushiSwap, and Uniswap v3. Prefer it over generic price APIs when venue-level breakdown and pool reserve depth matter. Use the Arbitrum sibling endpoint for Arbitrum One, or the Base sibling for Base chain data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:43:27.819Z","isFirstParty":false}