# LoneStar Oracle Open Interest

> LoneStar Oracle Open Interest is a paid API for AI agents from oi.lonestaroracle.xyz, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Returns perpetual futures open interest data for BTC, ETH, SOL, AVAX, LINK, and ARB across OKX, Hyperliquid, and dYdX, with a market signal (ACCUMULATING/DELEVERAGING/MIXED), USD totals, per-exchange breakdown, 5-minute OI delta, and dominant exchange.

## Facts

- Endpoint: GET https://oi.lonestaroracle.xyz/oi
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/lonestar-oracle-open-interest-c424f528
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OFgwJIgSnNG02hTLiymed

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 lonestar-oracle-open-interest-c424f528
```

Example prompt: What's the current open interest signal for BTC across OKX, Hyperliquid, and dYdX — is it accumulating or deleveraging, and which exchange is dominant right now?

## When to prefer this

Choose this endpoint when you need real-time perpetual futures open interest data aggregated across OKX, Hyperliquid, and dYdX with a pre-computed directional signal (ACCUMULATING/DELEVERAGING/MIXED) and per-exchange dominance breakdown. Ideal for trading agents that need a quick, opinionated market structure read rather than raw tick data. Best for the 6 supported assets (BTC, ETH, SOL, AVAX, LINK, ARB). Prefer this over generic market data APIs when you specifically need cross-exchange OI aggregation with signal generation for perp markets.

## Known failure modes

- Payment not processed (x402 payment required on Base network, $0.05 USDC)
- Exchange data temporarily unavailable for one or more venues (partial data returned)
- Asset not in supported list (BTC/ETH/SOL/AVAX/LINK/ARB only)
- Rate limit or upstream data feed delay causing stale OI figures
- Network timeout if Base x402 payment confirmation is slow

## How this service works

Full OI report — all assets, all exchanges, 5-min delta

## Output

Returns a JSON object with an array of assets (each containing asset ticker, total OI in USD, dominant exchange, and 5-min delta percentage), an overall market signal string (ACCUMULATING, DELEVERAGING, or MIXED), and the aggregate total OI in USD across all tracked assets and exchanges.

## Request schema (JSON Schema)

```json
{
 "name": "LoneStarOracle — OpenInterest",
 "tags": [
  "open-interest",
  "oi",
  "perps",
  "futures",
  "positioning",
  "crypto",
  "trading"
 ],
 "type": "object",
 "version": "1.0.0",
 "category": "trading",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "assets": [
      {
       "asset": "BTC",
       "oi_usd": 1300000000,
       "dominant": "hyperliquid",
       "delta_pct": 1.2
      }
     ],
     "signal": "ACCUMULATING",
     "total_oi_usd": 2400000000
    }
   }
  }
 },
 "description": "Perp futures open interest across OKX, Hyperliquid, dYdX for BTC/ETH/SOL/AVAX/LINK/ARB. Signal-first: ACCUMULATING/DELEVERAGING/MIXED. USD totals, per-exchange breakdown, 5-min OI delta, dominant exchange. 5-min cache. Pairs with FundingRates for full positioning picture."
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "format": "json",
 "example": {
  "assets": [
   {
    "asset": "BTC",
    "oi_usd": 1300000000,
    "dominant": "hyperliquid",
    "delta_pct": 1.2
   }
  ],
  "signal": "ACCUMULATING",
  "total_oi_usd": 2400000000
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/lonestar-oracle-open-interest-c424f528/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from oi.lonestaroracle.xyz](https://www.zero.xyz/host/oi.lonestaroracle.xyz/llms.txt)