Order Book Depth API README
The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Order Book Depth API listing page.
Order Book Depth API
Uniswap V3 liquidity depth analysis -- price impact at 1/2/5/10% levels. Slippage estimation pre-trade. Pay-per-call via x402 (USDC on Base L2) -- no API key, no signup, no rate-limit wall.
Part of the klymax402 marketplace -- 100 x402 micropayment APIs for AI agents, one wallet, USDC on Base.
Quickstart -- MCP
Add to your MCP client config (Claude Desktop, Cursor, ElizaOS, etc.):
Quickstart -- HTTP (x402)
Any x402-aware client (@x402/fetch, x402-agent-tools, ATXP) handles the 402 -> sign -> retry cycle automatically.
Tools
| Tool | Method | Path | Price | Description |
|---|---|---|---|---|
dex_analyze_orderbook_depth | GET | /api/depth | $0.012 | Analyze orderbook depth for a Uniswap V3 pool |
dex_analyze_orderbook_depth | POST | /api/depth | $0.012 | Analyze orderbook depth for a Uniswap V3 pool (POST variant) |
dex_analyze_orderbook_depth
Use this when you need to analyze liquidity depth of a Uniswap V3 pool before a large trade. Returns depth analysis in JSON.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
pool | string | yes | Uniswap V3 pool address (0x...) |
chain | string | no | Chain name: base, ethereum (default: base) |
Returns
currentPrice-- current pool pricedepth1pct-- USD liquidity available within 1% price impactdepth2pct-- USD liquidity available within 2% price impactdepth5pct-- USD liquidity available within 5% price impactdepth10pct-- USD liquidity available within 10% price impacttotalLiquidity-- total pool liquidity in USDfeeTier-- pool fee tier (0.01%, 0.05%, 0.3%, 1%)token0/token1-- pool token pair symbols
Example response:
When to use: executing large on-chain trades to estimate slippage and determine optimal trade size. Essential for MEV-aware agents and OTC sizing.
Not for: swap quotes (use dex_get_swap_quote), token safety (use token_check_safety), token holders (use token_get_holder_analysis).
dex_analyze_orderbook_depth
Use this when you need to analyze liquidity depth of a Uniswap V3 pool before a large trade. Returns depth analysis in JSON. POST variant of dex_analyze_orderbook_depth -- same params passed as JSON body instead of query string.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
pool | string | yes | Uniswap V3 pool address (0x...) |
chain | string | no | Chain name: base, ethereum (default: base) |
Returns
currentPrice-- current pool pricedepth1pct-- USD liquidity available within 1% price impactdepth2pct-- USD liquidity available within 2% price impactdepth5pct-- USD liquidity available within 5% price impactdepth10pct-- USD liquidity available within 10% price impacttotalLiquidity-- total pool liquidity in USDfeeTier-- pool fee tier (0.01%, 0.05%, 0.3%, 1%)token0/token1-- pool token pair symbols
Example response:
When to use: executing large on-chain trades to estimate slippage and determine optimal trade size. Essential for MEV-aware agents and OTC sizing.
Not for: swap quotes (use dex_get_swap_quote), token safety (use token_check_safety), token holders (use token_get_holder_analysis).
Example agent prompts
- "Analyze liquidity depth of a Uniswap V3 pool before a large trade"
- "Analyze liquidity depth of a Uniswap V3 pool before a large trade"
Payment
- Protocol: x402 -- HTTP-native pay-per-call, no signup, no API key
- Network: Base L2 (
eip155:8453) - Asset: USDC
- Facilitator: Coinbase CDP (primary), PayAI (fallback)
- Also reachable via ATXP (OAuth-wrapped x402, RFC 9728 protected-resource metadata)
Part of klymax402
100 x402 micropayment APIs for AI agents -- one wallet, USDC on Base, zero signup.
- Catalog: https://klymax402.com/llms.txt
- Full API reference: https://klymax402.com/llms-full.txt
- Live stats: https://klymax402.com/stats
License
MIT