# zdte.ai

> Real-time SPX / 0DTE options market-structure analytics — a proprietary read of dealer positioning, gamma exposure, pins, walls, and volatility regime. zdte.ai is a software analytics product for options traders (it is not the Defiance ZDTE ETF or a fund). For informational and educational purposes only; not investment advice.

## Research
Market-structure forensics reconstructed from zdte.ai's own live SPX options telemetry.

- [The Expiry — June 2026 SPX structure](https://zdte.ai/research/june-2026-spx-expiry-full): how the long-gamma pin rolled off and June round-tripped $7,600 → $7,238 → $7,499; the dealer book rotating pinned → expand → decay.
- [The Pin That Climbed — May 2026 SPX structure](https://zdte.ai/research/may-2026-spx-pin-hold-full): how the long-gamma pin survived the April-CPI and monthly-OPEX tests and migrated the call wall $7,400 → $7,750.
- [After the V — April 18–May 8, 2026](https://zdte.ai/research/april-may-2026-spx-pin-full): how a long-gamma dealer book absorbed its first downside test.
- [The V in 23 Sessions — March 17–April 17, 2026](https://zdte.ai/research/march-april-2026-spx-rally-full): an 8-part reconstruction of the rally to new all-time highs.
- [Research index](https://zdte.ai/research)

## Learn
- [Options market structure explained](https://zdte.ai/learn): dealer gamma (GEX), positioning, pins, walls, and volatility regime in plain terms.
- [Gamma Exposure, Explained — the complete guide](https://zdte.ai/learn/gamma-exposure-explained): how dealer hedging creates volatility regimes, walls, pins, and squeezes.
- [What Is a Zero-DTE Option?](https://zdte.ai/learn/what-is-a-0dte-option): same-day SPX contracts from first principles (Field Guide, Ch. I).
- [Calls and Puts](https://zdte.ai/learn/calls-and-puts): rights, obligations, intrinsic and time value (Field Guide, Ch. II).
- [The Greeks](https://zdte.ai/learn/the-greeks): delta, gamma, theta, vega for 0DTE traders (Field Guide, Ch. III).
- [Understanding Implied Volatility](https://zdte.ai/learn/understanding-implied-volatility): IV, skew, term structure, and IV crush (Field Guide, Ch. IV).
- [Reading the Pulse](https://zdte.ai/learn/reading-the-pulse): the live market state — flow, regime, GEX/DEX (Field Guide, Ch. V).
- [Why Dealer Hedging Moves the Market](https://zdte.ai/learn/why-dealer-hedging-moves-the-market): the mechanics of dealer flow (Field Guide, Ch. VI).
- [Call Walls and Put Walls](https://zdte.ai/learn/call-walls-and-put-walls): how open interest becomes ceilings and floors (Field Guide, Ch. VIII).
- [Zero Gamma and Max Pain](https://zdte.ai/learn/zero-gamma-and-max-pain): the flip level and the max-pain strike (Field Guide, Ch. IX).
- [Charm and Vanna](https://zdte.ai/learn/charm-and-vanna): the second-order flows that move hedges when price is flat (Field Guide, Ch. X).
- [VIX and the Term Structure](https://zdte.ai/learn/vix-and-the-term-structure): what the VIX measures; contango vs. backwardation (Field Guide, Ch. XI).
- [Market Regimes](https://zdte.ai/learn/market-regimes): chop, trend, and breakout from options structure (Field Guide, Ch. XII).
- [Direction and Conviction](https://zdte.ai/learn/direction-and-conviction): reading a structural direction call, and the discipline of NEUTRAL (Field Guide, Ch. XIII).
- [Options market structure glossary](https://zdte.ai/glossary): 25 plain-language definitions (GEX, walls, pin risk, charm, vanna, OPEX, and more).

## About
- [zdte.ai home](https://zdte.ai/): what the platform does and how the analytics work.

## For Agents / API
zdte.ai is callable, not just readable. The same real-time SPX market-structure analytics behind this site are exposed as an MCP server for AI agents and a REST v1 mirror for scripts, both on one API key. Informational and educational data only; not investment advice.

- MCP endpoint: `https://api.zdte.ai/mcp` (Streamable HTTP transport), authenticated with an `X-API-Key: YOUR_KEY` request header. Any MCP client that speaks Streamable HTTP can connect - no OAuth flow, no session negotiation.
- Add to Claude Code or Claude Desktop in one line: `claude mcp add --transport http zdte https://api.zdte.ai/mcp --header "X-API-Key: YOUR_KEY"`
- REST v1 mirror: every REST-mapped MCP tool has a thin REST route under `https://api.zdte.ai` (same key, same auth header, byte-identical JSON body) for scripts and non-agent clients.
- [Developers - full API docs, connect guides, and response schemas](https://zdte.ai/developers): setup for Claude Code, Claude Desktop, and any MCP client, with curl and Python examples and full example payloads.
- Free access: call get_field_guide without a key; get_regime and get_market_structure offer delayed headline previews. Check as_of and data_mode: outside market hours the retained preview can be historical.
- Paid access: subscription or prepaid credits, one key covering MCP and REST. Current prices and accountless agent onboarding availability: https://api.zdte.ai/api/agent/pricing. A website account is not required when guest_access.available is true. Follow the returned key-generation and funding instructions; save the credential before registration and reuse it on retries.
- Stripe Checkout may require human approval. When guest_access.machine_payments_available is true, agents with delegated spending authority can buy credits using Stripe Shared Payment Tokens over MPP. Use X-API-Key for the accountless key and Payment-Authorization for the payment credential. Buying credits does not purchase a subscription.
- Market structure is recomputed roughly every 10 seconds during market hours. Failed or unavailable data responses do not consume credits.

Tools (MCP tool -> REST route -> what it returns):
- `get_market_structure` -> `GET /v1/market-structure`: current SPX dealer market structure - call/put walls, gamma flip, net GEX and gamma-profile depth, dealer regime, scored pressure points, forecast band, per-strike activity, VIX term structure with IV/skew, and realized-vol stats.
- `get_regime` -> `GET /v1/regime`: current SPX dealer regime label and confidence only.
- `list_history_dates` -> `GET /v1/history/dates`: available historical replay dates.
- `get_day` -> `GET /v1/history/{date}`: per-day market-structure timeline and summary for one replay date.
- `get_regime_segments` -> `GET /v1/history/{date}/segments`: compressed dealer-regime segment tape for one date.
- `subscribe_event` -> `POST /v1/subscriptions`: register an HTTPS callback for an event (webhooks - zero-gamma flip, new wall, regime transition).
- `unsubscribe` -> `DELETE /v1/subscriptions/{id}`: remove a webhook subscription.
- `list_subscriptions` -> `GET /v1/subscriptions`: list active webhook subscriptions.
- `get_field_guide` -> MCP only: a static, versioned dictionary of every field this surface emits - unit, value set where there is one, and a one-sentence meaning - plus the shared response conventions (tier, delay, timestamps, and how missing data is reported). No inputs; call once per session.