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/pick-contracts

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

Description

Pick contracts — the position book’s audit surface (W2-2).

?status= filters: open (default — the live book), exited (every terminal contract: horizon_elapsed / invalidated_price / invalidated_regime), or all. Rows carry the lock snapshot (conviction/tier/board_score/trust state AT LOCK), the contract terms (hold horizon in trading bars, entry ref, ATR-based invalidation level), and the exit state (status, exit date, human-readable reason).

?since= (an ISO date, normalized to YYYY-MM-DD before comparison) bounds the read to rows whose ANCHOR date is on/after the date — the exit date for exited, the lock date for open/all. ?limit= (1-500) caps the row count: newest-first for exited/all; the open book keeps its side/score order (it is slot-capped anyway). Both default OFF — the no-param call stays the FULL audit trail (read-side bound only; the keep-forever table is untouched). The bound exists for hot render paths: /tape passes a small limit instead of pulling the whole terminal history per SSR render (the #561 fan-out class). A malformed since is a loud 400, never a silently-empty result.

A pick contract exits ONLY on horizon elapsed, a close beyond its invalidation level, or an adverse macro regime-band extreme — never on a missed re-fire or a conviction flap. Exits are UPDATEs on the same row; nothing is deleted (the full history accumulates).

PUBLIC — market metadata only. 200 with an empty list on a cold start, never 404 (DOCTRINE P0). Read-only: locks and exits happen at the twice-daily screener runs, never here.

Parameters

Curl

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