# Lone Star Oracle Options Flow Intelligence

> Lone Star Oracle Options Flow Intelligence is a paid API for AI agents from options.lonestaroracle.xyz, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

Returns real-time options flow data for a given ticker including unusual activity, put/call ratio, top puts/calls with volume and IV, and a directional sentiment summary

## Facts

- Endpoint: GET https://options.lonestaroracle.xyz/flow
- 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/options-lonestaroracle-xyz-50a44d47
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_e-rvj2wj6g8aPsNFWamBb

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 options-lonestaroracle-xyz-50a44d47
```

Example prompt: What's the current options flow for AAPL using the nearest expiry — is there more call buying or put buying, and what strikes are seeing unusual volume?

## When to prefer this

Use this endpoint when you need real-time options flow intelligence including put/call ratios, large block trade detection, and unusual activity signals for a specific equity ticker. Prefer this over generic market data APIs when directional sentiment inference from options activity is the goal, especially for identifying institutional positioning via volume and open interest spikes.

## Known failure modes

- Invalid or unrecognized ticker symbol returns an error or empty flow data
- No unusual activity detected for a low-volume stock may yield minimal results
- Expiry filter 'nearest' may return no data outside market hours or on non-trading days
- Payment failure (402) if USDC balance is insufficient or x402 header is missing
- Rate limiting or timeout if the underlying data feed is delayed or unavailable

## How this service works

Options flow intelligence — unusual activity put/call ratios large block trades

## Output

Returns a JSON object containing the ticker, a human-readable flow summary (e.g. 'dominant CALL side | PCR 0.57 (bullish)'), the put/call ratio with sentiment label, a list of top put contracts and top call contracts each with strike, expiry, volume, open interest, IV percentage, and in-the-money status.

## Example request

```json
{
 "expiry": "nearest",
 "ticker": "AAPL"
}
```

## Request schema (JSON Schema)

```json
{
 "name": "LoneStarOracle — OptionsFlow",
 "tags": [
  "options",
  "flow",
  "derivatives",
  "unusual-activity",
  "iv",
  "iv-skew",
  "put-call-ratio",
  "sentiment",
  "crypto",
  "btc",
  "eth",
  "sol",
  "deribit",
  "trading"
 ],
 "type": "object",
 "version": "1.0.0",
 "category": "finance",
 "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": {
      "expiry": {
       "type": "string",
       "title": "Expiry",
       "default": "nearest"
      },
      "symbol": {
       "type": "string",
       "title": "Symbol"
      },
      "ticker": {
       "type": "string",
       "title": "Ticker"
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "ticker": "AAPL",
     "summary": "AAPL options flow: 7 unusual strikes — dominant CALL | PCR 0.72 (bullish)",
     "pcr_signal": "bullish (heavy call buying)",
     "iv_skew_pct": 2.1,
     "unusual_count": 7,
     "iv_skew_signal": "put skew — market pricing in downside protection",
     "put_call_ratio": 0.55,
     "total_put_volume": 204000,
     "unusual_activity": [
      {
       "type": "CALL",
       "expiry": "2026-04-24",
       "iv_pct": 3.1,
       "strike": 275,
       "volume": 68611,
       "in_the_money": false,
       "vol_oi_ratio": 3.2,
       "open_interest": 21443
      }
     ],
     "put_call_ratio_oi": 0.61,
     "total_call_volume": 284000
    }
   }
  }
 },
 "description": "Unusual options and derivatives activity scanner for any US stock, ETF, or major crypto (BTC / ETH / SOL via Deribit). Returns put/call volume and OI ratios, top strikes by volume, unusual activity (volume/OI > 3x), implied volatility skew, and a directional signal. Supports nearest expiry or multi-expiry scan. Ideal for agents reading market sentiment and positioning across US equities and crypto derivatives."
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/options-lonestaroracle-xyz-50a44d47/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from options.lonestaroracle.xyz](https://www.zero.xyz/host/options.lonestaroracle.xyz/llms.txt)