# Nami OI Delta — Open Interest Change Signal

> Nami OI Delta — Open Interest Change Signal is a paid API for AI agents from api.usenami.io, paid per call via x402, $0.003000/call, status unknown (last checked 2026-09-15).

Returns the change in open interest for a given ticker and venue between now and N hours ago, serving as an accumulation/distribution signal.

## Facts

- Endpoint: GET https://api.usenami.io/v1/perp/oi-delta
- Price: $0.003000/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-usenami-io-6a38e65d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dCpjWyCow5Td18E6h0A6I

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-6a38e65d
```

Example prompt: What's the open interest delta for BTC-USDT perps on Binance over the last 4 hours — is there net accumulation or distribution happening?

## When to prefer this

Use this endpoint when you need a quick directional signal on whether open interest is growing (accumulation) or shrinking (distribution) over a specific time window for a perpetual futures ticker, rather than needing a full historical timeseries. Prefer this over the historical OI timeseries endpoint when you only need the delta between now and a lookback point, not the full data series.

## Known failure modes

- Unknown ticker or venue returns a 404 or empty result
- Lookback window too large or outside supported range returns an error
- Venue data unavailable or delayed may return stale or null OI values
- Payment not included or invalid x402 payment header results in 402 error
- Malformed input schema returns 400 validation error

## How this service works

Open-interest delta for one crypto perpetual on one venue — current OI against OI N hours ago. Accumulation or distribution signal: whether positioning is building or unwinding.

## Output

Returns the current open interest, the open interest N hours ago, and the delta between them for the specified ticker and venue, along with a directional signal indicating accumulation or distribution pressure.

## Example request

```json
{
 "type": "GET",
 "hours": 4,
 "venue": "binance",
 "method": "perp/oi-delta",
 "ticker": "BTC"
}
```

## 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-6a38e65d/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)
