U

Usenami · Perp OI History

by Usenami

GETBase

$0.005

per call · USD Coin on Base

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.

Endpoint

GET https://api.usenami.io/v1/perp/oi-history

3

Calls / 30d

1

Unique payers / 30d

Sep 1

Last called

exact

Payment scheme

Call this service

TypeScript · @x402/fetch
import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const fetchWithPay = wrapFetchWithPayment(fetch, account);

const res = await fetchWithPay("https://api.usenami.io/v1/perp/oi-history", {
  method: "GET",
});
const data = await res.json();
cURL
curl -X GET \
  "https://api.usenami.io/v1/perp/oi-history?aggr=%5Bobject+Object%5D&from=%5Bobject+Object%5D&ticker=%5Bobject+Object%5D&to=%5Bobject+Object%5D&venue=%5Bobject+Object%5D" \
  -H "X-PAYMENT: <signed x402 payment>"

Example response

{
  "aggregation": "1h",
  "buckets": [
    {
      "bucket_start": "2026-05-24T00:00:00Z",
      "samples": 1,
      "value": 95012.5,
      "venue": "binance"
    }
  ],
  "ticker": "BTC",
  "venue": "binance",
  "window_end": "2026-05-31T00:00:00Z",
  "window_start": "2026-05-24T00:00:00Z"
}

Payment details

Pay to0x1538726707212f4db3eb67cec0910422a310475c
AssetUSD Coin · 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913
NetworksBase
Schemesexact

Is this your API?

Pin it to the top of Market Data and the homepage with a featured placement.

Get featured →

More from Usenami & similar services

U

Usenami · Funding Current

api.usenami.io

Live perpetual-futures funding rates per venue for one crypto symbol, or the whole cross-venue set in one call. Major CEX and DEX perp venues — Binance, Bybit, OKX, Bitget, Gate.io, KuCoin, Hyperliquid, Paradex, Drift, Orderly, Lighter and more. Each row carries the venue's current rate, its funding interval and the 8h-equivalent rate (venues quote on 1h/4h/8h schedules, so the raw rates are not comparable without it), plus canonical_id, asset_class and mark_price so a ticker that names two…

GETBaseMarket Data
$0.001 / call7 calls / 30d
U

Usenami · Perp Basis

api.usenami.io

Per-venue basis for one crypto perpetual — mark versus index price, basis_bps = (mark−index)/index×10000, and contango/backwardation structure, across tracked CEX and DEX perp venues. Every venue comes with an index except Crypto.com, Variational and dYdX; dYdX publishes one oracle price, and that price is its mark. `venues_without_index` names the ones missing from your response. Each venue also carries liquidity_state (live/dead/unknown), and a market with no trading is flagged unreliable however clean its basis looks.

GETBaseMarket Data
$0.005 / call7 calls / 30d
U

Usenami · Perp Open Interest

api.usenami.io

Open interest per venue for one crypto perpetual, with mark_price alongside — positioning and crowding across tracked CEX and DEX perp venues. Raw value: units vary per venue, see units_note in the response.

GETBaseMarket Data
$0.001 / call6 calls / 30d