API Reference

RESTful API for accessing Ohey's options analytics data programmatically

Base URL

https://oheyinc.com/api

All API requests must be made over HTTPS. API calls over plain HTTP will fail.

Authentication

Authenticate your requests using a Bearer token in the Authorization header:

curl https://oheyinc.com/api/gamma-exposure/SPY \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

Get your API token from your account dashboard

Gamma Exposure Endpoints

GET /api/gamma-exposure/:ticker

Get real-time gamma exposure levels across all strikes for a given ticker

Parameters

ticker (required) - Symbol to query (e.g., SPY, AAPL)
expiration (optional) - Filter by expiration date (YYYY-MM-DD)
min_strike (optional) - Minimum strike price
max_strike (optional) - Maximum strike price

Response Example

{
  "ticker": "SPY",
  "timestamp": "2026-01-22T19:45:00Z",
  "spot_price": 478.50,
  "gamma_flip_level": 475.00,
  "strikes": [
    {
      "strike": 480.0,
      "total_gamma": 1250000,
      "call_gamma": 850000,
      "put_gamma": 400000,
      "open_interest": 125000
    }
  ],
  "summary": {
    "total_gamma_exposure": 45000000,
    "net_gamma": 12000000,
    "largest_strike": 480.0
  }
}

GET /api/gamma-flip/:ticker

Get the gamma flip level (zero gamma point) for a ticker

Response Example

{
  "ticker": "SPY",
  "timestamp": "2026-01-22T19:45:00Z",
  "spot_price": 478.50,
  "gamma_flip_level": 475.00,
  "above_flip": true,
  "flip_distance_percent": 0.73,
  "implication": "Market dealers are short gamma above this level"
}

Volatility Surface Endpoints

GET /api/iv-surface/:ticker

Get complete implied volatility surface data for 3D visualization

Parameters

ticker (required) - Symbol to query
resolution (optional) - Grid resolution: low, medium, high (default: medium)

Response Example

{
  "ticker": "SPY",
  "timestamp": "2026-01-22T19:45:00Z",
  "spot_price": 478.50,
  "surface_data": [
    {
      "strike": 480.0,
      "dte": 7,
      "implied_volatility": 0.185,
      "moneyness": 1.003,
      "call_iv": 0.19,
      "put_iv": 0.18
    }
  ],
  "atm_iv": 0.165,
  "iv_rank": 45.2,
  "skew_metrics": {
    "25_delta_skew": 3.5,
    "put_call_skew": 2.1
  }
}

Real-Time WebSocket API

For real-time streaming data, connect to our WebSocket endpoints:

wss://oheyinc.com/ws/gamma-insights/ws/:ticker?token=YOUR_TOKEN

WebSocket Message Format

{
  "type": "gamma_update",
  "ticker": "SPY",
  "timestamp": "2026-01-22T19:45:23Z",
  "data": {
    "spot_price": 478.52,
    "gamma_exposure": 45200000,
    "delta_change": 150000
  }
}

View complete WebSocket documentation →

Rate Limits

100

requests/minute

BASIC tier

500

requests/minute

PRO tier

Unlimited

Custom limits

ENTERPRISE tier

Official SDKs Coming Soon

We're building official client libraries for Python, JavaScript, and more to make integration even easier.

Follow on GitHub for updates

Back to Documentation Authentication Details