# SPXXL — Full LLM Context

> This file provides comprehensive context about SPXXL for LLM agents, AI answer engines, and programmatic consumers. For the concise overview, see https://spxxl.com/llms.txt

---

## 1. What is SPXXL?

SPXXL is a real-time market state classification engine built exclusively for SPX (S&P 500 Index) 0DTE (zero days to expiration) options trading. It classifies each trading session into one of six archetypes using a 7-dimension scoring system, projects the closing price range via the proprietary Close Zone™ algorithm, and recommends options structures calibrated to the session type.

The engine processes live market data throughout the trading session (9:30 AM – 4:00 PM ET) and provides pre-market classification before the opening bell. Every session is graded at 4:05 PM ET against actual price action and published to a public track record.

Website: https://spxxl.com
Founded: 2025
Focus: SPX 0DTE options trading intelligence

---

## 2. The Six Session Types

### Balanced Day
- Frequency: ~35-40% of sessions
- Color code: #a9a9a9 (gray)
- Characteristics: Price oscillates around a central value area. Narrow range relative to ATR. IB (Initial Balance) rarely broken. Volume concentrated around VWAP.
- Best structures: Iron condors, butterflies, credit spreads (premium selling)
- Scoring signals: Low net move (<0.25%), expansion ratio 0.5-0.95× ADR, low VWAP bias

### Trend Day
- Frequency: ~15-20% of sessions
- Color code: #00ff00 (green)
- Characteristics: Sustained directional movement from open to close. Strong IB break in one direction. Expanding volume on continuation. Range often exceeds 1.5× ATR.
- Best structures: Directional debit spreads aligned with trend direction
- Scoring signals: High net move (>0.3%), VWAP bias >0.25, relative volume >1.05

### Expansion Day
- Frequency: ~8-12% of sessions
- Color code: #4d79ff (blue)
- Characteristics: Abnormal range expansion, typically 2×+ ATR. Multiple IB extensions. Elevated VIX. Often triggered by FOMC, CPI, or major earnings.
- Best structures: Wide defined-risk structures, or cash
- Scoring signals: Expansion ratio >1.2, relative volume >1.3, net move >0.5%

### Short Covering Rally
- Frequency: ~5-8% of sessions
- Color code: #00ffff (cyan)
- Characteristics: Sharp upward move driven by short sellers closing positions. Accelerating buying pressure as stops cascade. Asymmetric excursion (up >> down).
- Best structures: Call debit spreads with aggressive timing
- Scoring signals: Bullish net move >0.35%, asymmetry >2.5× (openToHigh >> openToLow), lower wick ratio <0.12

### Liquidity Sweep
- Frequency: ~5-8% of sessions
- Color code: #ffff00 (yellow)
- Characteristics: Price probes beyond key levels to trigger stop-loss orders, then reverses. "V" or inverted-V pattern. Volume spike at sweep point.
- Best structures: Cautious defined-risk positioning
- Scoring signals: Low body ratio (<0.40), significant wick presence on both sides

### Volatility Compression
- Frequency: ~10-15% of sessions
- Color code: #ff8000 (orange)
- Characteristics: Abnormally narrow range (<50% of ATR). Low volume. Price hugs VWAP. Often precedes significant directional moves.
- Best structures: Tight iron condors and butterflies (premium selling)
- Scoring signals: Expansion ratio <0.65, relative volume <0.9, net move <0.15%

---

## 3. Scoring Methodology

The engine evaluates each session across 7 dimensions:

1. **Price**: Net move, range, expansion ratio relative to ADR/ATR
2. **Time**: Session phase progression, IB formation, time-weighted momentum
3. **Volume**: Relative volume vs 14-day average, volume profile distribution
4. **Value**: VWAP deviation, value area migration, auction balance
5. **Momentum**: Directional persistence, VWAP bias, consecutive bar trends
6. **Volatility**: VIX level and regime, ATM IV, realized vs implied spread
7. **Liquidity**: Bid-ask spreads, market depth, GEX regime

All six session types are scored simultaneously (0-100 each). Cross-type penalties prevent archetype overlap. A minimum score floor of 28 caps confidence for weak signals. VIX regime applies Bayesian priors (±6-10 points). Breadth intelligence modifies scores based on sector participation.

The highest-scoring type becomes the classification. Confidence (0-100%) is derived from score separation, alignment checks, and temporal stability.

---

## 4. Engine Performance (Live)

- Total sessions graded: 298
- Correct: 257 (86.2%)
- Partial: 37
- Missed: 4
- Win rate (Correct + Partial): 98.7%
- Grading schedule: Daily at 4:05 PM ET
- Public track record: https://spxxl.com/track-record
- Session archive: https://spxxl.com/sessions

Grade definitions:
- **CORRECT**: Session type accurately described the dominant price action pattern
- **PARTIAL**: Classification captured some characteristics but missed key aspects
- **MISSED**: Actual session was substantially different from classification

---

## 5. API Specification

### Endpoint
```
GET https://spxxl.com/api/v1/classification
```

### Authentication
```
Authorization: Bearer spxxl_<your_api_key>
```
Keys are generated in the Account page. Requires Elite subscription ($299/mo or $2,870/yr).

### Rate Limit
- 30 requests per minute per API key (sliding window)
- Headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

### Response Schema
```json
{
  "sessionType": "Trend Day",
  "confidence": 78.4,
  "closeZone": {
    "center": 5482.15,
    "upper": 5498.30,
    "lower": 5466.00,
    "width": 32.30,
    "confidence": 72
  },
  "gexRegime": "NEGATIVE",
  "gexContext": "Trending",
  "projectionAge": "Post-IB",
  "historicalAccuracy": {
    "correctRate": 81.1,
    "winRate": 93.6,
    "totalGraded": 297,
    "gradeBreakdown": {
      "CORRECT": 241,
      "PARTIAL": 37,
      "MISSED": 19
    },
    "engineEdge": {
      "engineEdge": 87.2,
      "edgeRating": "ELITE"
    }
  },
  "market": {
    "price": 5482.15,
    "previousClose": 5465.42,
    "change": 16.73,
    "changePercent": 0.31,
    "vix": 14.8,
    "dailyRange": 28.45,
    "volume": 1284500000
  },
  "metadata": {
    "timestamp": "2026-06-19T15:30:00.000Z",
    "dataSource": "live",
    "sessionDate": "2026-06-19",
    "nextUpdate": "~60s",
    "version": "v1"
  }
}
```

### Response Fields

| Field | Type | Description |
|-------|------|-------------|
| sessionType | string | Current classification: Balanced Day, Trend Day, Expansion Day, Short Covering Rally, Liquidity Sweep, or Volatility Compression |
| confidence | number | Classification confidence (0-100). Higher = stronger signal conviction |
| closeZone.center | number | Close Zone™ projected closing price |
| closeZone.upper | number | Upper bound of projected range |
| closeZone.lower | number | Lower bound of projected range |
| closeZone.width | number | Range width in SPX points |
| closeZone.confidence | number | Zone projection confidence (0-95) |
| gexRegime | string | Gamma Exposure regime: POSITIVE (mean-reverting), NEGATIVE (trending), NEUTRAL |
| gexContext | string | Plain-English GEX interpretation |
| projectionAge | string | Classification recency: Pre-IB, IB-Forming, Post-IB, Core, Power-Hour, Close-Zone |
| historicalAccuracy | object | Engine accuracy statistics |
| market | object | Current SPX market data |
| metadata | object | Response metadata including data source and timestamp |

### Code Examples

**cURL:**
```bash
curl -s https://spxxl.com/api/v1/classification \
  -H "Authorization: Bearer spxxl_your_api_key" | jq .
```

**Python:**
```python
import requests

headers = {"Authorization": "Bearer spxxl_your_api_key"}
resp = requests.get("https://spxxl.com/api/v1/classification", headers=headers)
data = resp.json()

print(f"Session: {data['sessionType']} ({data['confidence']}%)")
print(f"Close Zone: {data['closeZone']['lower']} — {data['closeZone']['upper']}")
print(f"GEX: {data['gexRegime']}")
```

**JavaScript:**
```javascript
const res = await fetch('https://spxxl.com/api/v1/classification', {
  headers: { Authorization: 'Bearer spxxl_your_api_key' }
});
const data = await res.json();
console.log(data.sessionType, data.confidence + '%');
```

### Error Codes
| Status | Meaning |
|--------|---------|
| 200 | Success |
| 401 | Missing/invalid API key |
| 403 | Insufficient tier (Elite required) |
| 429 | Rate limit exceeded (30/min) |
| 500 | Server error |

---

## 6. Glossary (22 Terms)

### Balanced Day
- Slug: balanced-day
- Category: session-type
- Definition: A session where price oscillates around a central value area with no directional conviction — the most common session type for SPX.
- Related: trend-day, initial-balance, iron-condor, theta-decay
- Learn more: https://spxxl.com/learn/balanced-day

### Trend Day
- Slug: trend-day
- Category: session-type
- Definition: A session with sustained directional movement from open to close — price trends in one direction with minimal retracement.
- Related: balanced-day, expansion-day, initial-balance, debit-spread
- Learn more: https://spxxl.com/learn/trend-day

### Expansion Day
- Slug: expansion-day
- Category: session-type
- Definition: A volatile session with range expansion beyond normal boundaries — often triggered by macro catalysts or institutional repositioning.
- Related: trend-day, vix, atm-implied-volatility, gamma-exposure
- Learn more: https://spxxl.com/learn/expansion-day

### Short Covering Rally
- Slug: short-covering-rally
- Category: session-type
- Definition: A sharp upward session driven by short sellers closing positions — creates aggressive buying pressure that accelerates as stops are triggered.
- Related: trend-day, liquidity-sweep, gamma-exposure, debit-spread
- Learn more: https://spxxl.com/learn/short-covering-rally

### Liquidity Sweep
- Slug: liquidity-sweep
- Category: session-type
- Definition: A session where price probes beyond key levels to trigger clustered stop-loss orders before reversing — designed to trap directional traders.
- Related: balanced-day, short-covering-rally, initial-balance, iron-condor
- Learn more: https://spxxl.com/learn/liquidity-sweep

### Volatility Compression
- Slug: volatility-compression
- Category: session-type
- Definition: A session with unusually low range and volume — price consolidates tightly as the market coils before a potential expansion move.
- Related: balanced-day, expansion-day, theta-decay, iron-condor
- Learn more: https://spxxl.com/learn/volatility-compression

### Close Zone™
- Slug: close-zone
- Category: concept
- Definition: SPXXL's proprietary projected closing price range for SPX, computed using session classification, gamma exposure, and intraday momentum.
- Related: theta-decay, gamma-exposure, debit-spread, 0dte
- Learn more: https://spxxl.com/learn/close-zone

### Engine Edge
- Slug: engine-edge
- Category: metric
- Definition: SPXXL's composite accuracy score measuring classification quality, structure recommendations, and calibration across confidence levels.
- Related: close-zone, session-archive, track-record
- Learn more: https://spxxl.com/learn/engine-edge

### Initial Balance (IB)
- Slug: initial-balance
- Category: concept
- Definition: The price range established during the first 30 minutes of trading (9:30-10:00 AM ET) — a key reference for the entire session.
- Related: balanced-day, trend-day, liquidity-sweep, market-profile
- Learn more: https://spxxl.com/learn/initial-balance

### Theta Decay
- Slug: theta-decay
- Category: concept
- Definition: The rate at which an option loses value as time passes — accelerates dramatically for 0DTE options as expiration approaches.
- Related: 0dte, close-zone, gamma-exposure, iron-condor, debit-spread
- Learn more: https://spxxl.com/learn/theta-decay

### Gamma Exposure (GEX)
- Slug: gamma-exposure
- Category: concept
- Definition: The aggregate gamma positioning of options market makers — determines how dealer hedging amplifies or dampens SPX price moves.
- Related: close-zone, expansion-day, balanced-day, vix
- Learn more: https://spxxl.com/learn/gamma-exposure

### 0DTE (Zero Days to Expiration)
- Slug: 0dte
- Category: concept
- Definition: Options that expire on the same day they are traded — the fastest-growing segment of the options market with unique risk/reward characteristics.
- Related: theta-decay, gamma-exposure, debit-spread, close-zone
- Learn more: https://spxxl.com/learn/0dte

### Debit Spread
- Slug: debit-spread
- Category: structure
- Definition: A defined-risk options strategy that profits from directional movement — SPXXL's primary recommended structure for most session types.
- Related: iron-condor, butterfly-spread, 0dte, theta-decay
- Learn more: https://spxxl.com/learn/debit-spread

### Iron Condor
- Slug: iron-condor
- Category: structure
- Definition: A four-leg credit spread that profits when price stays within a defined range — ideal for Balanced Day and Volatility Compression sessions.
- Related: balanced-day, volatility-compression, butterfly-spread, theta-decay
- Learn more: https://spxxl.com/learn/iron-condor

### Butterfly Spread
- Slug: butterfly-spread
- Category: structure
- Definition: A three-strike options strategy that profits when price settles near a target price — precision tool for the Close Zone phase.
- Related: close-zone, iron-condor, debit-spread, theta-decay
- Learn more: https://spxxl.com/learn/butterfly-spread

### VIX (Volatility Index)
- Slug: vix
- Category: metric
- Definition: The CBOE Volatility Index measuring expected 30-day SPX volatility — the market's "fear gauge" and key input to session classification.
- Related: atm-implied-volatility, expansion-day, gamma-exposure, balanced-day
- Learn more: https://spxxl.com/learn/vix

### ATM Implied Volatility
- Slug: atm-implied-volatility
- Category: metric
- Definition: The implied volatility of at-the-money SPX options — reflects the market's real-time pricing of expected movement for the current session.
- Related: vix, theta-decay, gamma-exposure, 0dte
- Learn more: https://spxxl.com/learn/atm-implied-volatility

### Market Profile
- Slug: market-profile
- Category: concept
- Definition: A charting methodology that organizes price by time and volume to reveal value areas, balance, and auction theory — the foundation of session classification.
- Related: initial-balance, balanced-day, trend-day, close-zone
- Learn more: https://spxxl.com/learn/market-profile

### Liquidity Regime
- Slug: liquidity-regime
- Category: concept
- Definition: The current state of market depth and order flow quality — determines how easily large orders can be executed without moving the market.
- Related: vix, gamma-exposure, expansion-day, 0dte
- Learn more: https://spxxl.com/learn/liquidity-regime

### Session Archive
- Slug: session-archive
- Category: concept
- Definition: SPXXL's public database of every classified trading session — a searchable, transparent record of engine accuracy across 297+ trading days.
- Related: engine-edge, track-record, balanced-day, trend-day
- Learn more: https://spxxl.com/learn/session-archive

### Track Record
- Slug: track-record
- Category: concept
- Definition: SPXXL's public accuracy dashboard showing win rate, streak data, and Engine Edge score — graded daily at 4:05 PM ET.
- Related: engine-edge, session-archive, balanced-day, close-zone
- Learn more: https://spxxl.com/learn/track-record

### SPX (S&P 500 Index)
- Slug: spx
- Category: concept
- Definition: The Standard & Poor's 500 Index — the benchmark U.S. equity index and the underlying for the world's most liquid options market.
- Related: 0dte, gamma-exposure, vix, debit-spread
- Learn more: https://spxxl.com/learn/spx

---

## 7. Key Features

- **Real-time session classification** with 7-dimension scoring engine
- **Close Zone™ projection** — dynamic closing price range with confidence bands
- **Engine Edge scoring** — composite accuracy metric (0-100) graded daily
- **Session Archive** — 298+ graded sessions, fully searchable
- **Strategy Backtester** — filter and analyze historical sessions by type, confidence, VIX, and more
- **Gamma Exposure (GEX) analysis** — real-time dealer positioning from live option chain data
- **SPX 500 Index Movers** — constituent-level contribution analysis
- **Congressional Flow Intelligence** — politician trade tracking overlaid with session data
- **Trading Journal** — personal trade logging with engine comparison
- **Achievement System** — 15 achievements across 4 categories
- **Pre-Market Brief** — daily intelligence digest with transition probabilities
- **Public API** — programmatic access to classifications (Elite tier)

---

## 8. Pricing

- **Free Trial**: 5 live trading sessions, full Elite access, no credit card required
- **0DTE Special Pass**: $19/day — full Elite access for 24 hours
- **SPXXL Elite**: $299/month or $2,870/year — unlimited access including API

---

## 9. Technical Details

- SPX-exclusive (no SPY, no ES futures)
- Cash-settled, European-style options only
- Section 1256 60/40 tax treatment applies
- Market hours: 9:30 AM – 4:00 PM ET (NYSE)
- Data sources: Yahoo Finance (price), Tradier (option chain), FRED (economic calendar)
- Classification updates: continuous during market hours
- Grading: automated at 4:05 PM ET daily
- Historical data: April 2025 – present

---

## 10. Links

- Website: https://spxxl.com
- Track Record: https://spxxl.com/track-record
- Session Archive: https://spxxl.com/sessions
- Backtester: https://spxxl.com/backtest
- Glossary: https://spxxl.com/learn
- API Docs: https://spxxl.com/api-docs
- Blog: https://spxxl.com/blog
- Market Status: https://spxxl.com/market-status
- Pricing: https://spxxl.com/pricing
- LLMs.txt (concise): https://spxxl.com/llms.txt