# Arbitrum One DEX Liquidity & Market Depth API

> Arbitrum One 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-16).

Returns per-venue DEX liquidity, market depth, TVL, and pool reserves for a token pair on Arbitrum One across SushiSwap and Uniswap v3 fee tiers.

## Facts

- Endpoint: GET https://x402.donnyautomation.com/arbitrum/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/arbitrum-one-dex-liquidity-market-depth-api-cef958d3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__sUny0Wpimt_JTxszz3qQ

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 arbitrum-one-dex-liquidity-market-depth-api-cef958d3
```

Example prompt: How deep is the WETH/USDC liquidity pool on Arbitrum One right now — show me the breakdown by DEX venue including SushiSwap and all Uniswap v3 fee tiers, and tell me which venue has the most liquidity?

## When to prefer this

Choose this endpoint when you need per-venue liquidity depth and TVL breakdown for a specific Arbitrum One trading pair, especially for slippage estimation or optimal order routing across SushiSwap and Uniswap v3 fee tiers. Prefer it over generic price APIs when you need to know WHERE liquidity lives, not just what the price is. Use over the thin-liquidity-warning sibling when you need raw USD depth numbers rather than a simple DEEP/MODERATE/THIN classification.

## Known failure modes

- Unsupported token pair returns an error or empty result — only WETH, ARB, WBTC, USDC, USDT, LINK pairs are supported
- Malformed pair format (e.g. missing slash or wrong ticker) causes a validation error
- Pair with no active liquidity pools returns zero values or empty venue list
- RPC/onchain data latency may cause stale pool state during network congestion
- Payment failure (insufficient USDC balance) blocks the request under x402 protocol

## How this service works

Per-venue USD liquidity and TVL for a pair on Arbitrum One 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 USD liquidity per DEX venue (SushiSwap, Uniswap v3 0.05%/0.3%/1% fee tiers), both token pool reserves, each venue's share of total market depth, total TVL, and identification of the deepest venue for the requested token pair on Arbitrum One.

## 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 Arbitrum One (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": 42161,
  "network": "arbitrum"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/arbitrum-one-dex-liquidity-market-depth-api-cef958d3/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)