# Base DEX Liquidity & Market Depth by Venue

> Base 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-16).

Returns per-venue liquidity depth, pool reserves, TVL, and market share for a token pair across BaseSwap, SushiSwap, and Uniswap v3 on the Base L2 network.

## Facts

- Endpoint: GET https://x402.donnyautomation.com/base/liquidity
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/base-dex-liquidity-market-depth-by-venue-d3ac2e2a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_j7_i6LFnqnCVP7GS5U9Yb

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 base-dex-liquidity-market-depth-by-venue-d3ac2e2a
```

Example prompt: How deep is the WETH/USDC pool on Base right now, and which DEX — BaseSwap, SushiSwap, or Uniswap v3 — has the most liquidity so I know where to route my trade?

## When to prefer this

Choose this endpoint when you need per-venue DEX liquidity breakdown specifically on the Base (Coinbase L2) network, especially for slippage estimation, order routing decisions, or comparing pool depth across BaseSwap, SushiSwap, and Uniswap v3. Prefer it over generic price endpoints when the question is about market depth and venue selection rather than just spot price.

## Known failure modes

- Unsupported token pair returns an error or empty result — only pairs involving WETH, cbBTC, USDC, DAI are well-supported
- Malformed pair symbol (e.g. missing slash separator) causes a 400-level error
- Pair with no liquidity on any venue returns zero or null depth values
- Network congestion on Base may cause stale or delayed pool state reads
- x402 payment failure (insufficient USDC balance) returns 402 Payment Required before data is delivered

## How this service works

Per-venue USD liquidity and TVL for a pair on Base across BaseSwap, SushiSwap and Uniswap v3. 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 in USD for each supported DEX venue (BaseSwap, SushiSwap, Uniswap v3) for the requested pair on Base, including both pool token reserves, each venue's share of total market depth, the deepest venue to trade against, and stablecoin liquidity figures. All data reflects live onchain pool 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 Base (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": 8453,
  "network": "base"
 }
}
```

## More

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