# GammaFlip API - [Introduction](https://docs.gammaflip.io/introduction.md): Programmatic access to Gamma Exposure (GEX) data for crypto and US options - [Quickstart](https://docs.gammaflip.io/quickstart.md): From zero to your first GEX request in 5 minutes - [Claude and ChatGPT (MCP)](https://docs.gammaflip.io/claude-and-chatgpt.md): Use GammaFlip data from an AI assistant: connect once, sign in, ask in plain words - [Authentication](https://docs.gammaflip.io/authentication.md): API keys, access, and security - [Rate Limits](https://docs.gammaflip.io/rate-limits.md): Daily quotas, headers, and 429 handling - [Errors](https://docs.gammaflip.io/errors.md): Error codes and how to handle them - [Markets and exchanges](https://docs.gammaflip.io/markets-and-exchanges.md): Crypto venues, TradFi tickers, aliases, subsets and expiration cutoffs - [Data dictionary](https://docs.gammaflip.io/data-dictionary.md): Units, sign convention, every field in the levels object and the daily history files - [Historical data](https://docs.gammaflip.io/history.md): Stored GEX snapshots: levels time series, per-strike snapshots and daily bulk files - [List Exchanges](https://docs.gammaflip.io/api-reference/exchanges.md): Returns available exchanges grouped by market. Free: not counted against the quota - [List Coins](https://docs.gammaflip.io/api-reference/coins.md): Returns available symbols across all exchanges, split by market. Free: not counted against the quota - [Me](https://docs.gammaflip.io/api-reference/me.md): Your plan, markets and today's quota. Free: not counted against the quota - [List Expirations](https://docs.gammaflip.io/api-reference/expirations.md): Returns sorted, non-expired option expirations with ISO date, DTE and cutoff. Free: not counted against the quota - [Levels](https://docs.gammaflip.io/api-reference/levels.md): Where are we now: flip, regime, walls and totals for the latest snapshot - [GEX Term Structure](https://docs.gammaflip.io/api-reference/term-oi.md): Open Interest and Gamma Exposure per expiration, broken down by exchange - [GEX by Strike (Enhanced)](https://docs.gammaflip.io/api-reference/by-strike-enhanced.md): GEX data by strike price with key markers (gamma flip, max pain, walls) and aggregate totals - [History: Levels](https://docs.gammaflip.io/api-reference/history-levels.md): Time series of the TOTAL levels: flip, regime, walls and totals per capture - [History: Timestamps](https://docs.gammaflip.io/api-reference/history-timestamps.md): Capture timestamps of one session date - [History: Snapshot](https://docs.gammaflip.io/api-reference/history-snapshot.md): The full per-strike picture at one moment in the past - [History: Coverage](https://docs.gammaflip.io/api-reference/history-coverage.md): What history exists for each exchange and symbol. Free: not counted against the quota - [History: Files](https://docs.gammaflip.io/api-reference/history-files.md): List and download daily CSV files with the full stored history - [List available exchanges](https://docs.gammaflip.io/api-reference/discovery/list-available-exchanges.md): Returns the exchanges currently available, plus the virtual `all` aggregator and the same exchanges grouped by market. **Free**: not counted against the quota. - [List available coins](https://docs.gammaflip.io/api-reference/discovery/list-available-coins.md): Returns the union of symbols across all exchanges (crypto coins and TradFi tickers), plus the same list split by market. **Free**: not counted against the quota. - [Your plan, markets and quota](https://docs.gammaflip.io/api-reference/discovery/your-plan-markets-and-quota.md): Returns your tier, the markets your plan includes, `api_access`, and today's quota for both buckets (`requests` and `history_files`). **Free**: not counted against the quota. Use it to find out when the quota resets (a 429 carries no `Retry-After`). - [List expirations](https://docs.gammaflip.io/api-reference/discovery/list-expirations.md): Returns sorted, non-expired option expirations for a given exchange and coin. `expirations` keeps the `DDMMMYY` codes; `expirations_detail` adds the ISO date, days to the cutoff, the cutoff instant and a 0DTE flag. The cutoff is 08:00 UTC for crypto and 16:00 US Eastern for TradFi. **Free**: not cou… - [Levels for the latest snapshot](https://docs.gammaflip.io/api-reference/data/levels-for-the-latest-snapshot.md): Where are we now: flip, regime, walls, totals, stability and volatility levels, max pain and ATM IV for the latest snapshot, as one flat object. Small payload, the first call for a script or an LLM agent. Counts as 1 request. - [GEX term structure and Open Interest](https://docs.gammaflip.io/api-reference/data/gex-term-structure-and-open-interest.md): Returns OI and GEX per expiration date, broken down by exchange. - [GEX by strike with key markers](https://docs.gammaflip.io/api-reference/data/gex-by-strike-with-key-markers.md): Returns GEX data broken down by strike price, plus key markers (gamma flip, max pain, positive/negative walls, max-volatility and max-stability price levels, spot reference, aggregate totals) and a flat `levels` object. - [Levels time series](https://docs.gammaflip.io/api-reference/history/levels-time-series.md): The `TOTAL` levels over a time window, oldest first: one row per capture (`15m`), per UTC hour (`1h`) or per session (`close`). `start` is inclusive, `end` exclusive. A response has at most 5,000 rows plus an opaque `meta.next_cursor`. Counts as 1 request. See https://docs.gammaflip.io/history for s… - [Capture timestamps of a session date](https://docs.gammaflip.io/api-reference/history/capture-timestamps-of-a-session-date.md): The capture times (ISO 8601 UTC) of one session date, oldest first. The session date is the UTC date for crypto and the New York trading date for TradFi. Counts as 1 request. - [Per-strike snapshot at a past moment](https://docs.gammaflip.io/api-reference/history/per-strike-snapshot-at-a-past-moment.md): The stored snapshot nearest to `at` (within 15 minutes): snapshot-level fields and the strikes within +/- 25% of spot. When nothing is that close the answer is `404 no_snapshot` with `nearest_timestamps` from the `TOTAL` captures. Counts as 1 request. - [What history exists](https://docs.gammaflip.io/api-reference/history/what-history-exists.md): Per exchange and symbol: first and last capture, number of sessions and the date range of the daily files. **Free**: not counted against the quota. Cached for up to an hour. - [List daily history files](https://docs.gammaflip.io/api-reference/history/list-daily-history-files.md): The manifest of daily CSV.gz files, newest first, at most 400 rows. Counts as 1 request. Download a file with `/history/files/{exchange}/{coin}/{date}/{file}`. - [Download a daily history file](https://docs.gammaflip.io/api-reference/history/download-a-daily-history-file.md): Answers `302` with a presigned link, valid for up to 15 minutes, to a gzip-compressed CSV (`application/gzip`, downloaded as `_.csv.gz`). Costs one **file credit** from the separate `history_files` daily bucket, not a request. A 400, 404 or 503 costs nothing. Follow the redirect without… ## OpenAPI Specs - [openapi](/openapi.yaml) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.