Get a Gambit's history
get_gambit_historyThe history of Gambit's view of one ticker (pass symbol), or the dated history of one of YOUR Gambits (pass case_id). Pass exactly one of the two. BY SYMBOL (BTC, NVDA, xyz:GOOGL): Gambit's view is ONE shared, versioned view per ticker: the same view for every user, with a new version only when Gambit's view changes. Reading by symbol works for any ticker Gambit covers, a Hyperliquid listing or a US stock, even when you have no Gambit on it. A bare ticker that names a Hyperliquid listing (often a crypto perp) and also a US stock with no Hyperliquid listing reads the Hyperliquid one. Check subject_type and display_symbol against what the user meant; pass ref:eq:TICKER (for example ref:eq:IP) to read the US stock. A ticker that stays ambiguous answers 422 ambiguous_symbol with candidates (subject ids such as asset:crypto:IP); call again with one candidate as the symbol. Returns subject_id, display_symbol and its accepted versions, newest first: each version's number, as_of, the headline and summary at that version, change_lines (what changed in our thinking, in the analyst's words), note, verdict_moved, ledger (what happened to each lever and test of the version before, with sources), noise (what was set aside and why) and no_change (true when nothing in the view changed). Page with limit (1-100, default 20) and before_version (next_before_version from the previous page; null means there are no older versions). view, entry_id, observation_id and cursor are case_id reads only. To report a view that looks wrong, call leave_feedback (needs api:account) with category data_quality and area gambits, and name the subject_id and version in the message. Errors: 404 unknown_symbol; 422 ambiguous_symbol with candidates; 503 gambit_reads_disabled while these reads are switched off. A symbol read has no app_url. BY CASE_ID (from list_gambits): view=history (default): the full timeline, newest first, as items of kind opportunity (a captured market opportunity entry), observation (a news item or post attributed to the Gambit: symbol, source_types, summaries, why_now (why it was surfaced for this Gambit), attention_refs, category, horizon, and source_snapshots with the excerpt, url, publisher and source_at — attention only, not verified evidence) or judgment (an assessment entry: trigger_kind, update_category, judgment_before / judgment_after, delta_summary, material, evidence_refs, captured_price, created_at). view=entries: only the captured opportunity entries (opportunity_id, subject_id, instrument_ids, captured_at, source_at, historical, explicitly_saved, captured_price, and source_snapshot with the public headline, detail and evidence). view=entry: one entry, by entry_id. view=observation: one observation, by observation_id (the observation_id a history item carries). history and entries page with limit (1-100, default 50) and the next_cursor from the previous page. A judgment is Gambit's read of the Gambit for YOUR account: stance (recommend | watch | stand_aside), conviction (high | medium | low), summary (the written view), changes_if (what would change it), evidence_refs, user_reported_context (things you told Gambit that shaped it) and as_of. A Gambit that is not yours answers 404. A case_id read carries app_url, the Gambit's screen opened on the entry or observation when you asked for one. (Requires api:read.)
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| view | No | case_id reads only | |
| limit | No | symbol reads, and case_id history and entries | |
| cursor | No | case_id history and entries only: next_cursor from the previous page | |
| symbol | No | a ticker such as BTC or NVDA, an exact id such as xyz:GOOGL or ref:eq:IP (the US stock), or a candidate subject id from ambiguous_symbol; pass symbol or case_id, not both | |
| case_id | No | a Gambit id from list_gambits (UUID); pass case_id or symbol, not both | |
| entry_id | No | REQUIRED for view=entry | |
| before_version | No | symbol reads only: next_before_version from the previous page | |
| observation_id | No | REQUIRED for view=observation |