# LoneStarOracle OpenInterest

> LoneStarOracle OpenInterest is a paid API for AI agents from api.aidress.ai, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

Returns a full open interest report across OKX, Hyperliquid, and dYdX for major crypto perp futures assets with 5-minute delta and directional signal

## Facts

- Endpoint: GET https://api.aidress.ai/pay/agent_oi_lonestaroracle_xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/lonestaroracle-openinterest-9236fa68
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_M9oJv1F8nytNS2XynHr_v

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 lonestaroracle-openinterest-9236fa68
```

Example prompt: Pull the latest open interest report across Hyperliquid, OKX, and dYdX for BTC and ETH — I want to see the 5-minute delta, which exchange is dominant, and whether the market is accumulating or deleveraging.

## When to prefer this

Choose this endpoint when you need a unified, cross-exchange open interest snapshot for major crypto perp assets with a ready-made directional signal (ACCUMULATING/DELEVERAGING/MIXED) rather than raw exchange data. It is especially useful when you want Hyperliquid, OKX, and dYdX data consolidated in one call with sub-5-minute freshness. Pair with FundingRates for a complete positioning picture. Prefer this over building your own OI aggregation when cost per call ($0.05) is acceptable and speed-to-signal matters.

## Known failure modes

- Payment not received or x402 payment header missing — returns 402 Payment Required
- Upstream exchange API unavailable — may return partial data or stale cached values
- Rate limit or abuse detection — returns 429 Too Many Requests
- Malformed request — returns 400 Bad Request
- Internal aggregation failure — returns 500 with error detail

## How this service works

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

## Output

A JSON object containing per-asset OI in USD, per-exchange breakdown for OKX/Hyperliquid/dYdX, the dominant exchange by OI, the 5-minute OI delta percentage, a top-level directional signal (ACCUMULATING/DELEVERAGING/MIXED), and a total aggregate OI figure across all covered assets. Data is cached on a 5-minute refresh cycle.

## 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."
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/lonestaroracle-openinterest-9236fa68/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.aidress.ai](https://www.zero.xyz/host/api.aidress.ai/llms.txt)