# OP Mainnet DEX Liquidity & Market Depth by Venue

> OP Mainnet DEX Liquidity & Market Depth by Venue 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, pool reserves, and TVL for a trading pair on Optimism (OP Mainnet), covering SushiSwap and Uniswap v3 fee tiers.

## Facts

- Endpoint: GET https://x402.donnyautomation.com/optimism/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/op-mainnet-dex-liquidity-market-depth-by-venue-7e07c3c5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_bkY3SZe43n1KFLMSSiARE

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 op-mainnet-dex-liquidity-market-depth-by-venue-7e07c3c5
```

Example prompt: What's the current liquidity depth for WETH/USDC on Optimism — break it down by DEX venue so I can see which pool is deepest and where to route my trade?

## When to prefer this

Choose this endpoint when you need live, per-venue DEX liquidity data specifically on Optimism (OP Mainnet) for order routing, slippage estimation, or liquidity analysis across SushiSwap and Uniswap v3 fee tiers. Prefer it over generic price endpoints when you need pool reserves, market depth shares, and TVL rather than just a mid-price. Use sibling endpoints for Arbitrum, Polygon, Avalanche, or BSC chains.

## Known failure modes

- Unsupported token pair returns an error or empty result — only WETH, OP, WBTC, USDC, USDT, DAI pairs are reliably supported
- Malformed pair symbol (e.g. missing slash or wrong ticker) causes a validation error
- Payment failure (x402 protocol) blocks the response if USDC balance is insufficient
- Transient RPC or onchain data lag may cause stale or missing pool state
- Pair not found on either SushiSwap or Uniswap v3 returns zero or null liquidity fields

## How this service works

Per-venue USD liquidity and TVL for a pair on OP Mainnet across SushiSwap and Uniswap v3 fee tiers. Returns totalTvlUsd, venueCount, deepestVenue and venues[] with each venue share and reserves. Requires ?pair=SYM/SYM (e.g. WETH/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 liquidity for the requested trading pair on OP Mainnet, including per-venue USD liquidity across SushiSwap and Uniswap v3 fee tiers, both pool token reserves, each venue's share of total market depth, the deepest venue to trade against, and aggregate TVL. Covers major tokens: WETH, OP, WBTC, USDC, USDT, DAI.

## 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 OP Mainnet (e.g. WETH/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": 10,
  "network": "optimism"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/op-mainnet-dex-liquidity-market-depth-by-venue-7e07c3c5/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)