{"uid":"cap_j7_i6LFnqnCVP7GS5U9Yb","slug":"base-dex-liquidity-market-depth-by-venue-d3ac2e2a","name":"Base DEX Liquidity & Market Depth by Venue","description":"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.","url":"https://x402.donnyautomation.com/base/liquidity","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":{"type":"json","example":{"ts":"2026-07-31T00:00:00.000Z","chainId":8453,"network":"base"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_rCrxiFRvqkYQ9NhQMhEjR","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Pre-trade slippage check for large order","prompt":"Before I swap 50 WETH for USDC on Base, check how deep the liquidity is across BaseSwap, SushiSwap, and Uniswap v3 so I can estimate slippage and pick the best venue."},{"title":"Order routing agent venue selection","prompt":"I need to route a big cbBTC/USDC trade on Base — tell me which DEX has the deepest pool and what share of total liquidity each venue holds right now."},{"title":"DeFi dashboard TVL monitoring","prompt":"What's the current total value locked in the WETH/DAI pools across all DEXs on Base, and how is it split between venues?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T12:36:21.670Z","isFirstParty":false}