{"uid":"cap_Bi8TafgcYFEYaheLrJ7E8","slug":"op-mainnet-amm-pool-reserves-live-pool-state-api-592c14b2","name":"OP Mainnet AMM Pool Reserves & Live Pool State API","description":"Raw AMM pool state for a pair on OP Mainnet: v2 reserves and v3 concentrated liquidity across SushiSwap and Uniswap v3 fee tiers. Returns pools[] with venue, surface, feeBps, reserveA, reserveB, price and tvlUsd at a stated blockNumber. Requires ?pair=SYM/SYM (e.g. WETH/USDC). Errors: 400 bad_pair, 404 no_pools, 502 upstream_read_failed. For USD depth already computed use /liquidity. This is the underlying numbers. Chain-pinned; bare /reserves = BSC.","url":"https://x402.donnyautomation.com/optimism/reserves","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_HVR-DehZFinH-Ugl9nruQ","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 raw AMM pool reserves, mid price, fee tier, and USD TVL for a token pair across SushiSwap and Uniswap v3 fee tiers on Optimism (OP Mainnet) at the current block.","exampleAgentPrompt":"Pull the raw AMM pool reserves and live pool state for WETH/USDC across SushiSwap and Uniswap v3 fee tiers on OP Mainnet — I need the mid price, fee tiers in bps, and USD TVL per venue so I can compute my own slippage estimates.","exampleUseCases":[{"title":"Pre-trade slippage estimation on Optimism","prompt":"Before I swap 50 WETH for USDC on Optimism, can you pull the current pool reserves and TVL across Uniswap v3 and SushiSwap on OP Mainnet so I can calculate the expected slippage and price impact?"},{"title":"Cross-venue arbitrage math on OP L2","prompt":"I want to check for arbitrage opportunities between SushiSwap and Uniswap v3 on Optimism for the WETH/USDC pair — can you get me the raw pool reserves and mid prices at the current block for both venues?"},{"title":"DEX pool TVL monitoring on Optimism","prompt":"What's the current USD TVL and fee tier for WETH/USDC pools across all Uniswap v3 fee tiers and SushiSwap on OP Mainnet right now?"}],"resultDescription":"Returns per-venue pool data for the requested token pair on OP Mainnet including: token reserve amounts for both assets, pool mid price in quote terms, fee tier expressed in basis points, USD total value locked (TVL), pool type (constant-product or concentrated liquidity), and the block number at which the snapshot was taken — across SushiSwap and Uniswap v3 fee tiers (0.05%, 0.3%, 1%).","failureModes":["Unsupported or unrecognized token pair symbol returns an error or empty result","Pair with no liquidity on OP Mainnet returns empty venue list","Malformed pair string (missing slash, wrong format) returns validation error","Network congestion on Optimism may cause stale or delayed block data","Token contract not deployed on OP Mainnet returns not-found error"],"whenToPreferThis":"Choose this endpoint when you need the raw underlying pool state on Optimism (OP Mainnet) specifically — reserve amounts, tick data, mid price, fee tier, and TVL — to perform your own quote, price impact, slippage, or arbitrage calculations. Prefer this over higher-level best-execution or price endpoints when you need the foundational on-chain numbers rather than a pre-computed recommendation. Use the sibling Arbitrum or Polygon reserves endpoints for those respective chains.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:57:35.720Z","isFirstParty":false}