Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.stratalerts.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Fields and Fetch Reference

The StratAlerts market bundle is a structured snapshot of every tracked symbol delivered as an NDJSON file — one JSON object per line, one line per symbol. It refreshes every 300 seconds (5 minutes), so the data your LLM receives always reflects current market conditions. This page covers the exact bundle format, every available field, how to fetch the bundle, and how to parse it in code.

​
File format

The bundle is NDJSON (Newline-Delimited JSON). Each line is a valid, self-contained JSON object representing one symbol. This format is intentional: it streams efficiently, parses line by line without loading the entire file into memory, and works cleanly as LLM context input.
bundle-0001.ndjson
{"Symbol":"SPY","Sector":"ETF","LastPrice":561.40,...}
{"Symbol":"QQQ","Sector":"ETF","LastPrice":477.83,...}
{"Symbol":"AAPL","Sector":"Technology","LastPrice":213.57,...}
Refresh cadence: Every 300 seconds. The bundle URL does not change — the same URL always returns the latest snapshot.

​
Fields

​
Identity and price

FieldTypeDescription
SymbolstringTicker symbol (e.g., SPY, NQ=F, BTC-USD)
SectorstringSector classification (e.g., Technology, Financials, ETF)
LastPricenumberMost recent trade price
LastTradeTimestampstring (ISO 8601)Timestamp of the last trade
LastPriceSourcestringData source for the last price

​
TFC state

Timeframe continuity (TFC) state is provided for five higher timeframes. Each value is one of green, red, or na.
FieldTimeframeValues
TFC_DDailygreen, red, na
TFC_WWeeklygreen, red, na
TFC_MMonthlygreen, red, na
TFC_QQuarterlygreen, red, na
TFC_YYearlygreen, red, na

​
Candles (OHLCV)

OHLCV bars are included for nine timeframes. Each timeframe block contains: Time, Open, High, Low, Close, Volume.
Timeframe keyTimeframe
Candle_1515-minute
Candle_3030-minute
Candle_6060-minute
Candle_4H4-hour
Candle_DDaily
Candle_WWeekly
Candle_MMonthly
Candle_QQuarterly
Candle_YYearly
Each candle object looks like:
candle object
{
  "Time": "2026-04-10T09:30:00Z",
  "Open": 558.20,
  "High": 563.80,
  "Low": 557.40,
  "Close": 561.40,
  "Volume": 42871200
}

​
Setup fields

Setup fields reflect the current Strat setup state on the daily timeframe by default.
FieldTypeDescription
C2stringCandle 2 scenario — the prior candle type (e.g., 1, 2U, 2D, 3)
C1stringCandle 1 scenario — the current candle type
CCstringCurrent candle scenario
SetupTargetstringThe identified setup target (price level or label)
TriggerGreennumber | nullPrice level that triggers the bullish side of the setup
TriggerRednumber | nullPrice level that triggers the bearish side of the setup
ContinuationbooleanWhether the setup is a continuation setup
InForcebooleanWhether the setup is currently in-force (trigger has been breached)
P3booleanWhether the setup is a P3 (potential 3)
PMGbooleanWhether a PMG (potential major gap) flag is set

​
Sample bundle row

This shows a complete single-symbol row from the bundle:
sample row (SPY)
{
  "Symbol": "SPY",
  "Sector": "ETF",
  "LastPrice": 561.40,
  "LastTradeTimestamp": "2026-04-10T14:35:22Z",
  "LastPriceSource": "consolidated",
  "TFC_D": "green",
  "TFC_W": "green",
  "TFC_M": "red",
  "TFC_Q": "red",
  "TFC_Y": "green",
  "Candle_D": {
    "Time": "2026-04-10T09:30:00Z",
    "Open": 558.20,
    "High": 563.80,
    "Low": 557.40,
    "Close": 561.40,
    "Volume": 42871200
  },
  "Candle_W": {
    "Time": "2026-04-07T09:30:00Z",
    "Open": 549.10,
    "High": 564.90,
    "Low": 546.30,
    "Close": 561.40,
    "Volume": 198450000
  },
  "C2": "1",
  "C1": "2U",
  "CC": "2U",
  "SetupTarget": "564.90",
  "TriggerGreen": 563.80,
  "TriggerRed": 557.40,
  "Continuation": false,
  "InForce": false,
  "P3": false,
  "PMG": false
}

​
Fetching the bundle

Send an HTTP GET to your bundle URL with your API key in the X-API-Key header: 
curl -H "X-API-Key: YOUR_API_KEY" \
  https://app.stratalerts.com/api/v1/bundles/latest.ndjson
Your bundle URL and API key are available in Account → AI Tools after subscribing.

​
Parsing the bundle in Python

This example fetches the bundle, parses every row, and filters for symbols that are in-force on the daily:
parse and filter bundle
import json
import requests

def fetch_bundle(api_key: str) -> list[dict]:
    url = "https://app.stratalerts.com/api/v1/bundles/latest.ndjson"
    response = requests.get(url, headers={"X-API-Key": api_key})
    response.raise_for_status()
    rows = []
    for line in response.text.splitlines():
        line = line.strip()
        if line:
            rows.append(json.loads(line))
    return rows

def in_force_daily(rows: list[dict]) -> list[dict]:
    return [r for r in rows if r.get("InForce") is True]

rows = fetch_bundle("YOUR_API_KEY")
active = in_force_daily(rows)

for symbol in active:
    print(f"{symbol['Symbol']} — {symbol['CC']} — in force at {symbol['TriggerGreen'] or symbol['TriggerRed']}")
Parse the bundle line by line rather than loading the entire file into memory at once. For large universes, streaming line-by-line reduces memory overhead significantly.

AI Tools overview

How AI Tools works, compatible models, and pricing.

AI Search

Run natural language queries directly inside the StratAlerts setups table — no API key or code required.