# Agent402 Perpetual DEX Open Interest Limits

> Agent402 Perpetual DEX Open Interest Limits is a paid API for AI agents from agent402.tools, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-29).

Returns open interest caps and limits for coins on a specified perpetual DEX (e.g. Hyperliquid HIP-3 venues)

## Facts

- Endpoint: POST https://agent402.tools/api/perp-dex-limits?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent402-perpetual-dex-open-interest-limits-0af46cb8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_BvknHmktgtlRjEMVL9Bu8

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agent402-perpetual-dex-open-interest-limits-0af46cb8 -d '<json body>'
```

Example prompt: Pull the open interest caps for all coins on the xyz perp DEX, returning the top 100 by cap size.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent402-perpetual-dex-open-interest-limits-0af46cb8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)