USENAMI / API

Open interest API

Per-venue open interest, cross-venue OI delta, and anomaly flags for major CEX and DEX perpetual venues. Built for positioning analysis, regime detection, and OI-vs-funding divergence studies.

See full API docsTry the sandbox →
x402 micropayments on Base · USDC per call · no signup · MCP-server option available

What this is

Open interest tells you whether new money is entering a perp or whether longs are unwinding. Across venues it tells you where that money is. This API exposes per-venue OI snapshots, a cross-venue delta endpoint that surfaces the largest movers, OI history for backtests, and anomaly flags that surface unusual volume + OI combos worth a second look.

Endpoints

The endpoints below are live on api.usenami.io. Prices are per call in USDC, settled on Base via x402 — no signup, no API key, no monthly minimum. Full spec at /.well-known/x402.json.

EndpointUSDCReturns
/v1/perp/open-interest$0.001Current per-venue, per-symbol open-interest snapshot.
/v1/perp/oi-delta$0.003Largest cross-venue OI changes over recent windows — biggest movers up and down.
/v1/perp/oi-history$0.005Historical OI time series for backtest and regression studies.
/v1/perp/volume-anomalies$0.003Volume + OI combos flagged as statistically unusual — entry-screening filter.

Often used alongside (same API, same pricing model):

EndpointUSDCReturns
/v1/perp/volume-24h$0.00124h volume per venue — denominator for many positioning ratios.
/v1/perp/volume-history$0.005Historical volume time series.
/v1/funding/current$0.001Funding rates — combine with OI to spot crowded carries.

Quickstart

Typical positioning workflow: snapshot + delta + cross-check with funding. The free endpoints (/v1/health, /v1/venues/list, /v1/venues/health, and the preview routes) return without payment so you can validate connectivity before any USDC moves.

# current OI snapshot, all venues
curl -X POST <x402-pay> https://api.usenami.io/v1/perp/open-interest

# top 20 OI changes in the last 4h
curl -X POST <x402-pay> "https://api.usenami.io/v1/perp/oi-delta?window=4h&limit=20"

# python sketch — crowded longs filter
oi      = pay("/v1/perp/open-interest")
funding = pay("/v1/funding/current")
crowded = [
    s for s in oi
    if s["oi_delta_24h_pct"] > 30
    and funding[s["symbol"]]["rate_8h_bps"] > 3
]

What you actually get

Per-venue + cross-venue
Both views in the same schema — drop into any positioning model without joins.
OI delta
Windowed change view (1h / 4h / 24h) ranks movers without polling every symbol.
Anomaly flags
Volume + OI combos that depart from their recent distribution — screen entries cheaply.
Historical depth
Time-series endpoint goes back as far as we have venue data; cited per-row.

The honest disclaimer: OI methodology varies per venue (notional vs contract count, USDC-margin vs coin-margin). We normalize to USDC notional where possible and disclose the source-of-truth per row. If a venue stops publishing OI, the row returns null — we don't fill from a stale snapshot.

FAQ

Next steps

Read the full API reference, try a request from the in-browser sandbox, or wire it into a Claude / Cursor / ElizaOS agent via our MCP server.

API docsTry the sandbox