Evaluate an opportunity
evaluate_opportunityEvaluate one setup for YOUR account — the same action as Evaluate in the Gambit app. Requires the api:recommend scope (403 without it). This runs the recommendation pipeline (LLM calls, except when the answer comes from Gambit's view) and can take up to ~45 seconds: each call uses one run of the SAME monthly recommendation quota generate_recommendation uses (403 tier_limit_exceeded when it is spent) and one of 5 calls per minute that evaluate_opportunity and review_opportunity_trade share (429 rate_limited with Retry-After). Do not call it speculatively. Name the setup one of two ways: opportunity_id (a Today's Market card from get_opportunities, mo_ + 32 hex; scenario_id optionally picks one of its plan scenarios from get_opportunity_detail), or security_id + session_date (a Daily Move from get_daily_moves; it must be a Big Move). The answer is data.evaluation: outcome is actionable (Gambit would take it: direction, strength, sizing and trade_ticket), watch (worth watching, not yet), pass (Gambit passes on it) or insufficient (not enough evidence; decision_analysis.missing_evidence says what would settle it). execution.state says whether an actionable ticket is ready or blocked. decision_analysis carries the read, counter_case and changes_if; decisive_evidence the facts it rests on. When Gambit answers are enabled for this deployment (they ship off), for a card on an asset Gambit covers, the evaluation is Gambit's view of that ticker plus a sized plan from the user's own limits: decision_analysis is the rendered view (current_read the headline and summary, counter_case the case against, changes_if what would prove it wrong, with dates), decisive_evidence the sources of its reasons, and gambit the view block (subject_id, version, view, plan); actionable needs a real lean (|shown_lean| at least 1), a Hyperliquid listing and a current view and price, watch means no edge, no listing to trade, or a view that cannot back a ticket on this run (out of date, or no current price), and insufficient means Gambit has no view yet (the ticker is queued; evaluate again after its next update). capital_authority is always none: evaluating places NO order. An actionable evaluation also records a recommendation (ledger_id); when the evaluation comes from Gambit's view that recommendation is advisory, so execute_recommendation refuses it (409 advisory_not_executable). To refresh an actionable Today's Market card evaluation's ticket before trading, call review_opportunity_trade with the card's opportunity_id, evaluation_id, scenario_id, trade_ticket.advisory_fingerprint, trade_ticket.ticket_fingerprint and source.snapshot_fingerprint. Executing anything is a separate api:trade step that needs the human's explicit approval. The response carries app_url, the card's screen.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| scenario_id | No | with opportunity_id: one of the card's plan scenarios | |
| security_id | No | a Daily Move's security_id from get_daily_moves; send with session_date | |
| session_date | No | the Daily Move's session date, YYYY-MM-DD | |
| opportunity_id | No | a Today's Market card id from get_opportunities (mo_ + 32 hex) |