GET /api/v1/screener/track-record
Last verified
Auto-generated. This article is rebuilt from FastAPI route introspection by
scripts/build_api_kb.py. Edit the route docstring inapp/and re-run the script — do not edit this file directly.
GET /api/v1/screener/track-record
Handler: app.screener.routes.get_screener_track_record
Methods: GET
Description
Episode Track Record — the per-name realized “would-have” return.
Walks screener_candidates grouped by (ticker, archetype) into
candidacy EPISODES and computes, for each, the signed (direction-adjusted)
- market-adjusted (minus SPY) realized return from entry to board removal — the answer to “if you’d bought when the archetype started flagging this name and followed it until the screener dropped it, you’d have been directionally right by THIS much.”
The closed block is the report card (CLOSED episodes only): overall
directional-hit rate + mean/median realized return, best/worst, broken out
by archetype AND direction AND holding-period bucket (never pooled across
horizons in the headline). open episodes are marked-to-market separately
and are NOT counted in the closed hit-rate. caveats carries the binding
honesty surface: n_closed_episodes + span + the calm-regime / hindsight
notes — this is a LIVE, growing ledger, not a proven track record.
PUBLIC — market data only (no PII, no per-account data). Also the substrate for the homepage Track-Record scoreboard.
Parameters
| In | Name | Type | Default | Description |
|---|---|---|---|---|
| query | lookback_days |
int |
400 |
Calendar-day window of candidacy history to grade (bounds the screener_candidates scan + the price/SPY pull). Default 400 covers all current history. |
| query | archetype |
Optional[str] |
Restrict to one archetype: canonical descriptive ID (e.g. ‘oversold_sympathy’) or short code (e.g. ‘A2’, back-compat). | |
| query | ticker |
Optional[str] |
Restrict to a single ticker (case-insensitive). Bounds the candidacy scan + price/SPY pull to that one name — used by the per-company detail page so a single-name episode overlay does NOT trigger a whole-universe episode computation. | |
| query | entry_rule |
str |
'cohort_inferred' |
Entry-price convention: ‘cohort_inferred’ (default — morning flag -> same-day close, evening flag -> next-session open), ‘flag_close’, or ‘next_open’. |
| query | exit_convention |
str |
'reanchored' |
Exit-price convention (W1-6): ‘reanchored’ (default — exit anchored at the last GENUINE appearance, executed at the next session’s open; no dead tail to the synthetic sweep stamp, no 1-bar look-ahead) or ‘legacy’ (the pre-W1-6 removal-day-close read, kept as an explicit diagnostic). |
Curl
curl -s https://bigclawd.com/api/v1/screener/track-record