# ByKaranteli Open Interest 5m History

> ByKaranteli Open Interest 5m History is a paid API for AI agents from bykaranteli.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Returns five-minute interval open interest history for major perpetual contracts in both base units and USD, normalised across symbols and exchanges.

## Facts

- Endpoint: GET https://bykaranteli.com/api/x402/oi-history
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bykaranteli-open-interest-5m-history-9386f3f0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__S337FTpGffd8YclUeyGO

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 bykaranteli-open-interest-5m-history-9386f3f0
```

Example prompt: Pull the 5-minute open interest history for BTCUSDT on Binance from January 10 to January 15 2025, denominated in USD, up to 500 rows.

## When to prefer this

Choose this endpoint when you need pre-aggregated, exchange-normalised 5-minute open interest history for perpetuals without having to paginate individual exchange APIs. It is especially valuable for quant workflows, backtesting, and feature engineering where consistent cross-venue OI time series are needed in a single call. Prefer it over raw exchange endpoints when you want both base-unit and USD-denominated OI already joined and retained server-side.

## Known failure modes

- Invalid or unsupported symbol returns empty rows or an error message
- Date range too wide may be silently capped by the per-dataset row limit
- Missing required query parameters may return an empty result set
- Unsupported exchange filter returns no data without an explicit error
- Payment failure (x402) results in a 402 response before any data is returned
- Very recent windows may have incomplete data if ingestion lag exists

## How this service works

Five minute open interest history for the major perpetuals in base units and USD, normalised across symbols and retained on our side, so one query replaces per-symbol paginated pulls against exchange endpoints.

## Output

A JSON object with an `ok` boolean, a `dataset` label (`oi-history`), a `count` of returned rows, and a `rows` array — each row containing timestamped open interest values in both base units and USD for the requested symbol and exchange, normalised to a consistent schema across venues.

## 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": {
      "to": {
       "type": "string",
       "description": "iso, optional"
      },
      "from": {
       "type": "string",
       "description": "iso, optional"
      },
      "limit": {
       "type": "number",
       "description": "number, optional, max 20000"
      },
      "symbol": {
       "type": "string",
       "description": "string, optional"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "rows": [],
  "count": 500,
  "dataset": "oi-history"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bykaranteli-open-interest-5m-history-9386f3f0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from bykaranteli.com](https://www.zero.xyz/host/bykaranteli.com/llms.txt)