Open a Gambit from a symbol
create_gambitOpen one of YOUR Gambits on a symbol, with an optional sentence in the user's own words (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) is saved as the Gambit's note; it is never Gambit's view. 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 records that the user follows the asset: it has no stance, no conviction and no direction, and nothing assesses the Gambit itself. Gambit's view of the asset is its shared take: read it with get_gambit (by case_id it is the gambit block; by symbol it is the view, and a ticker with no view yet answers status building). 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.
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": "create_gambit"
}
}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 | the user's own words, saved as the Gambit's note; never Gambit's view |