{"uid":"cap_b-c-XTQv_TG5AtG7whtB9","slug":"arbitrum-one-amm-pool-reserves-live-pool-state-04fd5392","name":"Arbitrum One AMM Pool Reserves & Live Pool State","description":"Raw AMM pool state for a pair on Arbitrum One: 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/arbitrum/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 Arbitrum One (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":42161,"network":"arbitrum"}},"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_RkyWE6xI5qloufowSA2_p","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 Arbitrum One at the current block.","exampleAgentPrompt":"Pull the raw AMM pool reserves, mid price, and USD TVL for WETH/USDC across SushiSwap and Uniswap v3 pools on Arbitrum One so I can compute slippage for a large trade.","exampleUseCases":[{"title":"Price impact calculation before large trade","prompt":"I'm about to swap 500,000 USDC for WBTC on Arbitrum — can you fetch the raw pool reserves and TVL for WBTC/USDC across all Uniswap v3 fee tiers and SushiSwap on Arbitrum One so I can calculate my price impact?"},{"title":"Cross-venue arbitrage opportunity detection","prompt":"Get me the live pool state and mid price for ARB/USDC on every available venue on Arbitrum One — I want to see if there's a spread between SushiSwap and the different Uniswap v3 fee tiers I can exploit."},{"title":"Onchain liquidity snapshot for reporting","prompt":"Fetch the current pool reserves and USD TVL for WETH/USDC across all Arbitrum One AMM pools and tell me which venue has the deepest liquidity right now."}],"resultDescription":"Returns per-venue pool data for each fee tier and AMM on Arbitrum One: both token reserves, the pool mid price, fee tier in basis points, USD TVL, and the block number at which data was captured. Covers constant-product (SushiSwap) and concentrated-liquidity Uniswap v3 pools in a single response.","failureModes":["Unknown or unsupported token pair symbol returns an error or empty result","Token pair with no deployed pools on Arbitrum One returns empty venues array","Malformed pair string (e.g. missing slash separator) returns a validation error","Temporary RPC or onchain data unavailability may cause timeout or stale data","Unsupported token ticker not resolvable to a contract address returns an error"],"whenToPreferThis":"Choose this endpoint when you need the raw underlying pool reserve numbers on Arbitrum One to do your own quote, price impact, slippage, or arbitrage math — rather than a pre-computed best price. It covers multiple venues (SushiSwap + Uniswap v3 multi-tier) in one call and is L2 Arbitrum-specific. Prefer sibling endpoints for pre-computed best execution price or thin-liquidity warnings.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:52:02.233Z","isFirstParty":false}