{"uid":"cap_bkY3SZe43n1KFLMSSiARE","slug":"op-mainnet-dex-liquidity-market-depth-by-venue-7e07c3c5","name":"OP Mainnet DEX Liquidity & Market Depth by Venue","description":"Per-venue USD liquidity and TVL for a pair on OP Mainnet 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.","url":"https://x402.donnyautomation.com/optimism/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 OP Mainnet (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":10,"network":"optimism"}},"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_DFXTSq-jbe-pQnK7eZ9V7","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 DEX liquidity, market depth, pool reserves, and TVL for a trading pair on Optimism (OP Mainnet), covering SushiSwap and Uniswap v3 fee tiers.","exampleAgentPrompt":"What's the current liquidity depth for WETH/USDC on Optimism — break it down by DEX venue so I can see which pool is deepest and where to route my trade?","exampleUseCases":[{"title":"Route large swap on Optimism","prompt":"I'm about to swap a large amount of WETH for USDC on Optimism — can you tell me which DEX has the deepest liquidity and the biggest share of total market depth so I know where to route it?"},{"title":"Stablecoin pool depth check","prompt":"Before I provide liquidity, can you check the current TVL and pool reserves for USDC/DAI on OP Mainnet across SushiSwap and Uniswap v3?"},{"title":"Slippage risk assessment for OP token","prompt":"I need to estimate slippage for a trade in the OP/USDC pair on Optimism — can you pull the live market depth and per-venue liquidity so I can see if the pool is thin or well-funded?"}],"resultDescription":"Returns a breakdown of liquidity for the requested trading pair on OP Mainnet, including per-venue USD liquidity across SushiSwap and Uniswap v3 fee tiers, both pool token reserves, each venue's share of total market depth, the deepest venue to trade against, and aggregate TVL. Covers major tokens: WETH, OP, WBTC, USDC, USDT, DAI.","failureModes":["Unsupported token pair returns an error or empty result — only WETH, OP, WBTC, USDC, USDT, DAI pairs are reliably supported","Malformed pair symbol (e.g. missing slash or wrong ticker) causes a validation error","Payment failure (x402 protocol) blocks the response if USDC balance is insufficient","Transient RPC or onchain data lag may cause stale or missing pool state","Pair not found on either SushiSwap or Uniswap v3 returns zero or null liquidity fields"],"whenToPreferThis":"Choose this endpoint when you need live, per-venue DEX liquidity data specifically on Optimism (OP Mainnet) for order routing, slippage estimation, or liquidity analysis across SushiSwap and Uniswap v3 fee tiers. Prefer it over generic price endpoints when you need pool reserves, market depth shares, and TVL rather than just a mid-price. Use sibling endpoints for Arbitrum, Polygon, Avalanche, or BSC chains.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:57:56.914Z","isFirstParty":false}