Skip to content

KB/api

GET /api/v1/screener/exits

Last verified

Auto-generated. This article is rebuilt from FastAPI route introspection by scripts/build_api_kb.py. Edit the route docstring in app/ and re-run the script β€” do not edit this file directly.

GET /api/v1/screener/exits

Handler: app.screener.routes.get_screener_exits
Methods: GET

Description

Exits digest (W3-1, ripeness-trust Wave 3) β€” the watchlist-pruning surface. Every name that left the program in the trailing days window, cross-source: pick-contract exits (horizon elapsed / price or regime invalidation), candidacy decay (relevance window elapsed, relabeled tier_drop when a conviction downgrade was the proximate driver), and S2 evictions.

Each row carries the exit date, ticker, archetype, direction, trading days held, the furthest ripeness stage the candidacy ever reached, the exit reason, the realized signed excess return where a matured board-pick grade exists, and a verdict chip (worked / failed / never_ripened / unknown / pending). A candidacy that WAS classifiable and never reached a ripe stage is never_ripened; one whose ripeness history could not be classified at all is unknown (an ABSTAIN, R-3).

Paginated AFTER windowing (R-3): limit/offset slice the windowed, date-sorted list; count reports the full in-window total, returned_count the size of this page.

PUBLIC β€” market metadata only. 200 with an empty list on a cold start or when nothing exited in the window, never 404 (DOCTRINE P0). Read-only; the underlying tables are written at the twice-daily screener runs.

Parameters

In Name Type Default Description
query days int 7 Trailing calendar-day window to scan for exits (default 7 β€” the weekly digest; capped at 90).
query limit int 200 Max exit rows returned (paginated AFTER windowing; default 200). count still reports the full in-window total.
query offset int 0 Row offset into the windowed, date-sorted exits list.

Curl

curl -s https://bigclawd.com/api/v1/screener/exits