REST API · v1

SPXXL Public API

One endpoint. Real-time SPX session classification, confidence scores, Close Zone™ projections, GEX regime, and an auditable track record — all as JSON.

Single Endpoint:/api/v1/classification

Rate Limit:30 req/min

Auth:Bearer API Key

Access:Elite Tier

Quick Start

Get Your API Key

Generate your key from Account Settings → API Access. Keys start with spxxl_ and are shown once — save it securely.

bash

curl -s https://spxxl.com/api/v1/classification \
  -H "Authorization: Bearer spxxl_your_api_key_here" | jq .

Endpoint

GEThttps://spxxl.com/api/v1/classification

Returns the current (or most recent) SPX session classification with all supporting analytics. No query parameters required.

Authentication

All requests require a valid API key passed in the Authorization header:

header

Authorization: Bearer spxxl_your_api_key_here

Key Format

spxxl_ + 48 hex characters

Required Tier

Elite or Basic (paid subscribers)

sessionTypestringCurrent session classification: Balanced Day, Trend Day, Expansion Day, Short Covering Rally, Liquidity Sweep, or Volatility Compression.

confidencenumberClassification confidence (0–100). Higher values mean stronger signal conviction.

closeZoneobjectClose Zone™ projection — predicted closing range with center, upper, lower bounds, width (points), and zone confidence (0–95).

gexRegimestringCurrent Gamma Exposure regime: POSITIVE (mean-reverting), NEGATIVE (trending), or NEUTRAL.

gexContextstringPlain-English GEX interpretation: Mean-reverting, Trending, or Neutral.

projectionAgestringMarket phase: Pre-Market, IB Forming, Post-IB, Power Hour, Near Close, or After Hours.

historicalAccuracyobjectAuditable track record — correct rate (%), win rate (%), total graded sessions, grade breakdown (CORRECT/PARTIAL/MISSED), and Engine Edge™ composite score.

marketobjectCurrent market snapshot — SPX price, previous close, change, change %, VIX, daily range, volume.

metadataobjectResponse metadata — timestamp, data source (live or snapshot), session date, refresh interval, API version.

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"
  }
}

What You Can Build

Automated Execution

Feed session type and confidence into your execution bot. Open positions only when the engine agrees with your thesis.

Portfolio Alerts

Poll every minute and trigger Slack/Discord/Telegram alerts when session type transitions or confidence crosses your threshold.

Strategy Backtesting

Pull historical classifications and correlate against your own P&L data to find your highest-edge session types.

AI Agent Integration

Give your AI trading agent access to SPXXL classifications. The JSON schema is designed for LLM consumption.

Ready to Integrate?

Generate your API key in Account Settings. Your first call returns live data in under 200ms.