Get what a Gambit view read
get_gambit_inputsWhat Gambit's shared view of one ticker read between two dates — the call for "what happened for DRAM between Nov 1 and Nov 3" or "what made Gambit change its view of NVDA this week". 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. Pass start and end as YYYY-MM-DD (UTC days: start is 00:00 UTC, end is the end of that UTC day) or full ISO times; end defaults to now and start to 3 days before end; at most 31 days. Or pass after_version and up_to_version (version numbers from get_gambit_history; at most 500 versions). Returns subject_id, display_symbol, the start and end used, and versions: each accepted version whose as_of falls after start and at or before end, oldest first, with version, as_of, path (analyst: a full review; applied: the step applied new items; step_quiet: the step found nothing that moves the view; carry_forward: the view carried over), lean_before and lean_after, shown_before and shown_after (the lean shown to users, -3 to +3), note (the change in the analyst's words), no_change, cause_item_ids (the items that caused the change), consumed_item_ids (every item that version took in), river_items (items another ticker's story routed here, with the river), driver_versions (other takes it leaned on), market (the price that version read: instrument, as_of, price, bar_end and age_seconds; price null when no bar was found), priced_numbers (the market numbers the view stored), written (the numbers its sentence was written at, when they differ), missing and inferred (fields not known, and fields worked out rather than recorded, such as market on versions written before Gambit recorded its price key). item_ids lists every item consumed in the range (cause items included); items gives title, source, source_type, url and published_at for at most 300 of them, cause items first (items_truncated says some were left out). partial true means some versions were written before Gambit recorded its inputs and were rebuilt from the change record; gaps says, per version, what is not known. Tell the user when the answer is partial. Lead with the versions where the shown lean moved, and name their cause items. Errors: 404 unknown_symbol; 422 ambiguous_symbol with candidates; 422 invalid_range or range_too_long; 503 gambit_reads_disabled while these reads are switched off. (Requires api:read.)
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"symbol": "<symbol>"
},
"name": "get_gambit_inputs"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | YYYY-MM-DD (end of that UTC day) or an ISO time; default now | |
| start | No | YYYY-MM-DD (00:00 UTC) or an ISO time; default 3 days before end | |
| symbol | Yes | a ticker such as DRAM or NVDA, an exact id such as xyz:GOOGL, or a candidate subject id from ambiguous_symbol | |
| after_version | No | instead of dates: the version before the range (0 = from the first) | |
| up_to_version | No | instead of dates: the last version in the range |