Open a Gambit from a symbol
create_gambitOpen one of YOUR Gambits on a symbol, with an optional sentence that says what to watch (requires api:account) — the call for "start tracking GOOGL" or "watch whether HYPE holds its ETF bid". symbol is a bare ticker (BTC, GOOGL) or an exact Hyperliquid id (xyz:GOOGL for a HIP-3 market); search_symbols helps find it. A bare ticker listed on several HIP-3 markets (AVGO) is accepted when every listing is the same asset; the Gambit then uses that asset's main market (the xyz: listing for a stock), and other tickers that stay ambiguous need an exact id. sentence (up to 280 characters, the user's own words) becomes the Gambit's monitoring question; without it Gambit uses a general outlook question. If you already have an open Gambit on the same asset, the call returns that one instead of a second: created false and already_existed true. A returned Gambit is not changed: if its monitoring_status is paused (the user stopped it), tell the user and, only if they want it back, call update_gambit_monitoring with active=true. Known limit: Track in the Gambit app does not join a Gambit opened here, so tracking a card on the same symbol in the app can give the user a second Gambit on it; the next create_gambit on that symbol then answers gambit_choice_required and asks which one. A new Gambit starts with a neutral watch judgment (stance watch, conviction low) and no direction; Gambit's monitor writes the first real assessment on its normal schedule, so read it later with get_gambit or get_tracking_updates. Returns case_id (pass it to get_gambit), created, already_existed, monitoring_status, and case (the Gambit in full, as get_gambit returns it). Errors (nothing is created on any of them): 422 code unknown_symbol, ambiguous_symbol with candidates (call again with one exact id), unsupported_symbol, invalid_sentence; 409 code gambit_choice_required with choices [{case_id, title}] when more than one open Gambit already tracks the asset (ask the user which one), or gambit_create_conflict (retry once); 429 gambit_create_limit after 10 creates in an hour; 503 when the symbol registry or the creation limit cannot be read (retry later). This places no order. The response carries app_url, the Gambit's screen.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| symbol | Yes | a ticker such as GOOGL or BTC, or an exact id such as xyz:GOOGL | |
| sentence | No | what to watch, in the user's words; becomes the monitoring question |