{"uid":"cap_BvknHmktgtlRjEMVL9Bu8","slug":"agent402-perpetual-dex-open-interest-limits-0af46cb8","name":"Agent402 Perpetual DEX Open Interest Limits","description":"Risk limits and status of ONE builder-deployed perp dex (HIP-3): total open-interest cap, per-perp OI size cap, max transfer notional, the per-coin OI caps, the coins currently AT their OI cap, and the dex's total net deposit. Three keyless reads (perpDexLimits, perpDexStatus, perpsAtOpenInterestCap) in one call.","url":"https://agent402.tools/api/perp-dex-limits?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"dex":{"type":"string","description":"HIP-3 dex name, e.g. xyz (list them with perp-dexs)."},"limit":{"type":"number","description":"Per-coin cap rows to return, largest first (default 50, max 500)."}}},"responseSchema":{"type":"json","example":{"dex":"xyz","count":1,"source":"hyperliquid","atOiCap":{"coins":[],"count":0},"fetchedAt":"2026-09-18T12:00:00.000Z","coinOiCaps":[{"coin":"xyz:SP500","oiCapUsd":1250000000}],"totalCoins":122,"totalOiCapUsd":10000000000,"maxTransferNtlUsd":3000000000,"oiSzCapPerPerpUsd":20000000000,"totalNetDepositUsd":1089269477.99}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_tndkjG1hfV9vHgGxkrxY7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns open interest caps and limits for coins on a specified perpetual DEX (e.g. Hyperliquid HIP-3 venues)","exampleAgentPrompt":"Pull the open interest caps for all coins on the xyz perp DEX, returning the top 100 by cap size.","exampleUseCases":[{"title":"Risk check before large perp trade","prompt":"Before I open a big position on xyz DEX, can you fetch the OI caps for that exchange so I can see if BTC-PERP is near its limit?"},{"title":"Screener for uncapped perp coins","prompt":"Show me all the perpetual coins on xyz DEX that have NOT hit their open interest cap yet — give me the top 50 by cap size."},{"title":"Monitor DEX-wide risk parameters","prompt":"What are the total OI cap, max transfer notional, and net deposit figures for the xyz perpetual DEX right now?"}],"resultDescription":"Returns a JSON object with the DEX name, total coin count, total OI cap in USD, per-coin OI caps sorted largest first, list of coins currently at their OI cap, max transfer notional, OI size cap per perp, total net deposit USD, and the timestamp the data was fetched.","failureModes":["Unknown DEX name returns empty or error response — use perp-dexs endpoint first to enumerate valid HIP-3 DEX names","Limit value exceeding 500 may be clamped or rejected","Network or upstream Hyperliquid API unavailability causes fetch failure","Invalid input types (e.g. non-numeric limit) cause schema validation errors"],"whenToPreferThis":"Use this endpoint when you need structured open interest limit data for a specific HIP-3 perpetual DEX, particularly for pre-trade risk checks, position sizing, or monitoring which coins are at their OI caps. Prefer this over generic market data APIs when targeting Hyperliquid-style on-chain perp venues with per-coin OI caps.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T07:09:14.610Z","isFirstParty":false,"canonicalSlug":"agent402-perpetual-dex-open-interest-limits-0af46cb8"}