# Perpetual Open Interest Aggregator (Hyperliquid + dYdX v4)

> Perpetual Open Interest Aggregator (Hyperliquid + dYdX v4) is a paid API for AI agents from api.agentstools.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns normalized open interest for a perpetual asset across Hyperliquid and dYdX v4, including per-venue coin amounts, USD notional, total aggregate USD OI, and each venue's share.

## Facts

- Endpoint: GET https://api.agentstools.dev/derivs/oi
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/perpetual-open-interest-aggregator-hyperliquid-dydx-v4-8a187d75
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_SGjE7_nkTjtJdi8Y1rwok

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 perpetual-open-interest-aggregator-hyperliquid-dydx-v4-8a187d75
```

Example prompt: What's the current total open interest for BTC perpetuals across Hyperliquid and dYdX v4, and how is it split between the two venues?

## When to prefer this

Use this endpoint when you need a single normalized view of perpetual open interest across both Hyperliquid and dYdX v4 simultaneously, rather than querying each venue's API separately and reconciling units and pricing yourself. Ideal for market structure analysis, venue dominance tracking, and cross-protocol OI comparison with a single cheap call.

## Known failure modes

- Unknown or unsupported ticker symbol returns a 4xx error or empty result
- Venue API downtime may cause partial results or degraded response
- Malformed symbol input (e.g. unsupported format) is normalized server-side but extreme edge cases may fail
- Rate limiting or payment failure (x402) returns 402 Payment Required

## How this service works

Open interest for a perpetual asset across decentralized venues (Hyperliquid, dYdX v4): per-venue open interest in coins and in USD notional (via each venue's mark or oracle price), the total aggregate USD open interest and each venue's share. One call, normalized across protocols.

## Output

A JSON object containing per-venue open interest for each decentralized exchange (in native coin units and USD notional using mark/oracle price), the total aggregate USD open interest across all venues, and each venue's percentage share of total OI.

## Request schema (JSON Schema)

```json
{
 "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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "symbol"
     ],
     "properties": {
      "symbol": {
       "type": "string",
       "description": "Base asset ticker (BTC, ETH, SOL). A quote suffix such as BTC-USD or BTC-PERP is accepted and normalized server-side."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/perpetual-open-interest-aggregator-hyperliquid-dydx-v4-8a187d75/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.agentstools.dev](https://www.zero.xyz/host/api.agentstools.dev/llms.txt)