How stretched the US market is: the share of tracked symbols closing above their own 200-day moving average, plus where that reading ranks against its own recorded history.

This is a breadth (participation) measure, not an index level: a cap-weighted index can sit above its 200-day average while most of its members sit below theirs. Use it to answer "is the market broadly extended or broadly depressed right now", never as a forecast.

Args: days: How many trading sessions of history to return, newest last. Capped at 1000 server-side. Use a small number if you only need the current reading.

Returns: current: the latest session — snapshot_date, total, above_ma200, pct_above (0..1), median, p10, p90. percentile: where current.pct_above ranks in the full stored history, 0..1, where 1.0 means the broadest participation on record. history: the daily series, oldest first.

Symbols furthest from their own 200-day moving average, ranked.

direction="under" lists the most depressed names (price far below its long-term average — the mean-reversion long candidates); direction="over" lists the most extended ones. Deviation is (close - MA200) / MA200, so -0.30 means the price is 30% below its own 200-day average.

Symbols whose 200-day window contains a single-day move above 25% are excluded: in practice that is an unadjusted stock split rather than a real move, and it would otherwise dominate the ranking.

Args: direction: "under" or "over". limit: Max rows, up to 100. Free accounts always receive 2 regardless — check is_billed in the response before reporting the list as complete.

The latest K-line chart patterns the daily scan flagged, each carried with the historical win-rate of its own pattern bucket.

hist_win_w20 is the share of past occurrences of that (pattern type, direction) bucket that beat SPY over the following 20 trading days — an aggregate property of the bucket, NOT a probability for this specific signal. Anything at or below 0.5 has no historical edge over simply holding the index, and several bullish buckets sit well below it; report the number rather than treating a flagged pattern as a recommendation.

Args: limit: Max rows, up to 100. Free accounts receive 2 rows and a null hist_win_w20 — check is_billed before drawing conclusions from an empty win-rate.

Everything held on one symbol: its current distance from its own 200-day moving average, and the chart patterns most recently detected on it.

Args: symbol: A US ticker, e.g. "AAPL". Case-insensitive.

Returns: deviation: null when the symbol is outside the covered universe (S&P 500 / Nasdaq 100 / major US ETFs) or was filtered out of the latest snapshot — a null here means "not covered", not "no deviation". patterns: recent detections, newest first, with hist_win_w20 for paid keys.

Validate the configured API key and report which account it belongs to and whether it is on a paid tier.

Worth calling before presenting any list as complete: on a free key every ranking is truncated to 2 rows and pattern win-rates come back null, which is indistinguishable from a quiet market unless the tier is known.