# derivs-oi: Decentralized Perpetuals Open Interest

> derivs-oi: Decentralized Perpetuals Open Interest is a paid API for AI agents from payai.agentstools.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns per-venue and aggregate USD open interest for a perpetual asset across Hyperliquid and dYdX v4 in a single normalized call.

## Facts

- Endpoint: GET https://payai.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/derivs-oi-decentralized-perpetuals-open-interest-feea1441
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YmbsVoL4pC-oNVb-hIQIk

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 derivs-oi-decentralized-perpetuals-open-interest-feea1441
```

Example prompt: What's the current open interest for ETH across Hyperliquid and dYdX — give me per-venue breakdown in USD and the total aggregate?

## When to prefer this

Choose this endpoint when you need a single normalized view of decentralized perpetuals open interest across Hyperliquid and dYdX v4 without having to query each protocol separately and reconcile their different data formats. It is ideal for agents building risk dashboards, order routing logic, or market analysis that depends on DeFi derivatives positioning data.

## Known failure modes

- Unsupported ticker symbol returns an error or empty result
- Upstream venue API outage may cause stale or partial data
- Network timeout if decentralized venue RPC is congested
- Malformed symbol input not normalized correctly despite server-side handling

## 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 the requested asset in both native coin units and USD notional (calculated via each venue's mark or oracle price), the total aggregate USD open interest summed across venues, and each venue's percentage share of that total.

## 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/derivs-oi-decentralized-perpetuals-open-interest-feea1441/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from payai.agentstools.dev](https://www.zero.xyz/host/payai.agentstools.dev/llms.txt)