Summary
Analyzes liquidity depth for Uniswap V3 pools by calculating price impact at 1%, 2%, 5%, and 10% levels. Built by Br0ski777 and hosted at orderbook-depth.api.klymax402.com, it connects via SSE transport to give you a read on how much slippage you'd face on different trade sizes. Useful when you're evaluating execution risk on DEX trades or building tools that need to estimate how deep a pool really is beyond the spot price. The x402 suffix suggests this is part of a broader toolkit, though the repo itself is sparse on implementation details. Reach for this when you need programmatic access to liquidity curves without scraping the chain yourself.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Tools
Public tool metadata for what this MCP can expose to an agent.
1 tools
dex_analyze_orderbook_depthUse this when you need to analyze liquidity depth of a Uniswap V3 pool on Base. Returns current price, liquidity at 1%/2%/5%/10% price impact levels (in USD), total liquidity, and fee tier. Useful for2 params
Use this when you need to analyze liquidity depth of a Uniswap V3 pool on Base. Returns current price, liquidity at 1%/2%/5%/10% price impact levels (in USD), total liquidity, and fee tier. Useful for
Parameters* required
chainstringChain name: base, ethereum (default: base)
poolstringUniswap V3 pool address (0x...)
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.):
{
"mcpServers": {
"orderbook-depth": {
"url": "https://orderbook-depth.api.klymax402.com/mcp"
}
}
}
Quickstart -- HTTP (x402)
curl "https://orderbook-depth.api.klymax402.com/api/depth?pool=..."
# -> 402 Payment Required, with an x402 payment challenge in the response body
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:
{"currentPrice":3128.50,"depth1pct":850000,"depth2pct":2100000,"depth5pct":5400000,"depth10pct":9800000,"totalLiquidity":15200000,"feeTier":"0.3%","token0":"USDC","token1":"WETH"}
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:
{"currentPrice":3128.50,"depth1pct":850000,"depth2pct":2100000,"depth5pct":5400000,"depth10pct":9800000,"totalLiquidity":15200000,"feeTier":"0.3%","token0":"USDC","token1":"WETH"}
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
Featured
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →