# Polygon DEX AMM Pool Reserves & Live Pool State API

> Polygon DEX AMM Pool Reserves & Live Pool State API is a paid API for AI agents from x402.donnyautomation.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

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.

## Facts

- Endpoint: GET https://x402.donnyautomation.com/polygon/reserves
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/polygon-dex-amm-pool-reserves-live-pool-state-api-91ff91af
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yY75TaQRSDZQsMrHqHMF8

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability polygon-dex-amm-pool-reserves-live-pool-state-api-91ff91af
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ts": "2026-07-31T00:00:00.000Z",
  "chainId": 137,
  "network": "polygon"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/polygon-dex-amm-pool-reserves-live-pool-state-api-91ff91af/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.donnyautomation.com](https://www.zero.xyz/host/x402.donnyautomation.com/llms.txt)