Uniswap V3 liquidity depth analysis -- price impact at 1/2/5/10% levels. Slippage estimation pre-trade.
Single tool with adequate naming (verb_noun pattern: dex_analyze_orderbook_depth) and comprehensive description (280+ chars). Input schema present with proper types and descriptions for both parameters. However, output schema is documented only in the description text via example JSON, not as a formal schema definition in the tool registration. Parameter descriptions are clear but could be more prescriptive about constraints. No error handling guidance or recovery paths documented.
Use this when you need to analyze liquidity depth of a Uniswap V3 pool before a large trade. Returns depth analysis in JSON. 1. currentPrice: current pool price 2. depth1pct: USD liquidity available within 1% price impact 3. depth2pct: USD liquidity available within 2% price impact 4. depth5pct: USD liquidity available within 5% price impact 5. depth10pct: USD liquidity available within 10% price impact 6. totalLiquidity: total pool liquidity in USD 7. feeTier: pool fee tier (0.01%, 0.05%, 0.3%, 1%) 8. token0/token1: pool token pair symbols Example output: {"currentPrice":3128.50,"depth1pct":850000,"depth2pct":2100000,"depth5pct":5400000,"depth10pct":9800000,"totalLiquidity":15200000,"feeTier":"0.3%","token0":"USDC","token1":"WETH"} Use this BEFORE executing large on-chain trades to estimate slippage and determine optimal trade size. Essential for MEV-aware agents and OTC sizing. Do NOT use for swap quotes -- use dex_get_swap_quote instead. Do NOT use for token safety -- use token_check_safety instead. Do NOT use for token holders -- use token_get_holder_analysis instead.
Output schema not formally defined. Tool description includes example JSON output but no structured schema declaration for return fields. LLMs cannot reliably extract fields or plan downstream operations without formal output schema.
No error handling guidance. Tool description lacks recovery paths for common failures (invalid pool address, unsupported chain, RPC timeout). LLMs cannot self-correct or know whether to retry.
Chain parameter lacks enum constraint. Description says 'base, ethereum (default: base)' but no formal enum in schema. LLMs may pass invalid chain names.
Pool parameter format not validated. Description says 'Uniswap V3 pool address (0x...)' but no regex pattern or length constraint in schema. LLMs may pass malformed addresses.
Inferred effective spec: 2025-06-18+.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 63 | 2025-06-18+ | v2 |
Tool description includes example output values (3128.50, 850000) which LLMs may reuse literally in subsequent calls rather than adapting to actual context.