overview

The gexbot API delivers real-time options analytics — including Gamma Exposure (GEX), Delta Exposure (DEX), second-order Greeks (Vanna, Charm, Convexity), classified orderflow, research charts, and streaming WebSockets — over standard REST and WebSocket protocols.

Authentication

All authenticated requests require an API key passed in the Authorization header as a Bearer token, along with a descriptive User-Agent:

Authorization: Bearer <YOUR_API_KEY>
User-Agent: <YOUR_APP_NAME>/1.0
Accept: application/json

Paths on these pages are relative to the base URL. Prefix every path with the host and the API version you use, for example https://api.gex.bot/v2.

Manage and generate API keys directly in the web portal:

Access Tiers

• Public & Base Endpoints: GET /tickers, GET /tickers/quant and GET /{package}/categories require no authentication. Every request still requires a User-Agent header.
• Package-Gated Endpoints: Core endpoints require an active subscription corresponding to the package (Classic, State, Orderflow or Quant). The Research endpoints need the Research add-on and a Research API key. GET /futures/conversion accepts any gexbot API key from a paid tier (Classic and above). A Research API key cannot call it.
• Daily EOD Reports: Every gexbot subscription tier (Classic and above) includes GET /hist/eod/{ticker}.

Permitted Use & Commercial Licensing

• Personal Non-Commercial Use: Subscriptions cover personal trading and research scripts.
• Local Caching: Local caching of API responses for your own analysis is permitted.
• Commercial Redistribution: You cannot redistribute, broadcast, or resell API data without a commercial license. Contact admin@gexbot.com for commercial agreements.
• Synthetic Futures Levels: Composite index feeds (ES_SPX, NQ_NDX) are pre-adjusted to front-month futures prices using live basis models.

Data Availability Summary

Rate Limits & Quotas

gexbot applies tiered query quotas and concurrency limits to maintain low-latency infrastructure for all users.

Policy & Reset Schedule

• Endpoint Isolation: Quotas track independently per endpoint. Exceeding a limit on one endpoint does not block your account on other endpoints or live WebSockets. Quotas count per account. All API keys of one account share each pool.
• Midnight ET Rollover: Daily quotas reset every night at 12:00 AM ET (Midnight Eastern Time) to align with US trading session boundaries. Monthly quotas reset at 12:00 AM ET on the first day of the month.
• Market Hours (NYSE RTH): Spot prices, trade classifications, and live calculation feeds operate from 9:30 AM to 4:00 PM ET. GEX by Open Interest refreshes daily at 8:30 AM ET.
• Server Calculation Frequency: Live calculations refresh at most once per second (1/sec) during market hours. Polling a single ticker more frequently than 1/second returns identical data.
• Email Notifications: On the first breach of an endpoint quota, gexbot sends an alert to your registered account email (maximum 1 notification per endpoint per window).

Handling 429 Responses

When you exceed a rate limit quota, the server returns HTTP 429 Too Many Requests:

{
  "error": "Rate limit exceeded."
}

Use exponential backoff before retrying.

Developer Resources & OpenAPI

Use official specifications, schemas, and client libraries to accelerate your integration:

Endpoint Groups