# OI History - Open Interest & Volume History for Crypto

> OI History - Open Interest & Volume History for Crypto is a paid API for AI agents from api.x402node.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns time-series open interest and volume history for a cryptocurrency over a chosen period, including latest value and percentage change, built from OKX aggregated derivatives data.

## Facts

- Endpoint: GET https://api.x402node.dev/market/oi-history
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/oi-history-open-interest-volume-history-for-crypto-95e9d9cc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QGMBJRtqXHK7B92LcdYSZ

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 oi-history-open-interest-volume-history-for-crypto-95e9d9cc
```

Example prompt: Can you pull the open interest history for ETH over the last 30 days and tell me whether positioning is building or unwinding, including the latest OI value and percentage change over the window?

## When to prefer this

Use this endpoint when you need historical open interest and volume trend data for a specific crypto asset, particularly for derivatives positioning analysis, trend detection, or squeeze identification based on OKX aggregated contract data. Prefer this over generic price endpoints when the focus is on futures/derivatives market structure rather than spot price.

## Known failure modes

- Invalid or unsupported coin symbol returns an error
- Unsupported time period or window parameter returns a validation error
- OKX data source temporarily unavailable causes upstream failure
- Missing required query parameters may return 400 Bad Request
- Rate limiting or payment failure may result in 402 Payment Required

## How this service works

Open-interest and volume history for a coin over a chosen period, with the latest value and percentage change across the window. Built from OKX aggregated contract data to show whether positioning is building or unwinding. Live time series for trend and squeeze analysis. open interest history, OI trend, derivatives positioning

## Output

A time series of open interest and volume data for the requested coin over the chosen period, along with the latest OI value and the percentage change across the window, sourced from OKX aggregated contract data.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "period": {
       "type": "string",
       "description": "5m/1H/1D (default 1D)"
      },
      "symbol": {
       "type": "string",
       "description": "coin symbol e.g. BTC (default BTC)"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/oi-history-open-interest-volume-history-for-crypto-95e9d9cc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.x402node.dev](https://www.zero.xyz/host/api.x402node.dev/llms.txt)