# Polygon DEX Liquidity & Market Depth API

> Polygon DEX Liquidity & Market Depth 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 per-venue DEX liquidity, market depth, TVL, and pool reserves for a token pair on Polygon PoS across QuickSwap, SushiSwap, and Uniswap v3

## Facts

- Endpoint: GET https://x402.donnyautomation.com/polygon/liquidity
- 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-liquidity-market-depth-api-107b774f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8A4pk9TAq-i2WVULBt85_

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-liquidity-market-depth-api-107b774f
```

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

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## 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-liquidity-market-depth-api-107b774f/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)