# Nami OI History — Perpetual Open Interest Timeseries

> Nami OI History — Perpetual Open Interest Timeseries is a paid API for AI agents from api.usenami.io, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-16).

Returns historical open interest timeseries data (1h/4h/1d resolution) for a given perpetual futures ticker and venue, covering up to a 30–90 day window.

## Facts

- Endpoint: GET https://api.usenami.io/v1/perp/oi-history
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-usenami-io-84440de9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zHfJ5aHoHgg9NKWKbaJt5

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 api-usenami-io-84440de9
```

Example prompt: Show me the 4-hour open interest history for BTC-PERP on Binance over the last 30 days — I want to see how OI has trended to spot accumulation or distribution signals.

## When to prefer this

Use this endpoint when you need historical OI trend data — e.g., to detect accumulation/distribution phases, validate breakout setups, or build time-series charts of positioning. Prefer this over the OI delta endpoint when you need the full timeseries rather than a single point-in-time change, and over the raw OI snapshot when temporal context is required.

## Known failure modes

- Invalid ticker or venue returns 404 or empty dataset
- Requested window exceeds the 30–90d cap, returning truncated data or error
- Unsupported resolution value returns validation error
- Venue does not report open interest, resulting in empty or null response
- Rate limiting or payment failure (x402) if USDC balance is insufficient

## How this service works

Historical open-interest timeseries for one crypto perpetual on one venue, aggregated 1h/4h/1d — positioning over time for backtests and regime studies. 30–90d window cap.

## Output

A timeseries array of open interest values at the requested resolution (1h, 4h, or 1d) for the specified ticker and venue, including timestamps, raw OI figures, mark price at each point, and a units note explaining the denomination used by that venue. Window is capped at 30–90 days depending on resolution.

## 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"
    },
    "method": {
     "type": "string"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-usenami-io-84440de9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.usenami.io](https://www.zero.xyz/host/api.usenami.io/llms.txt)