optionality_deal_scenario
Generate a fresh options trading scenario and open a journal entry.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | Yes | ``historical`` | ``fiction`` | ``live`` — controls how the Firm grounds the scenario. ``live`` uses the provider's web_search tool and costs more tokens. | |
| npub | No | Required. Your Nostr public key (npub1...) for credit billing. | |
| sector | No | Optional market-sector hint (e.g., ``"biotech"``, ``"semis"``, ``"banks"``). When set, the Firm picks the underlying ticker from that sector and tailors catalysts / relevant_facts / red_herrings to its dynamics. Empty string = no constraint, Firm picks freely. Ignored on replays (the original scenario's ticker is reused). | |
| difficulty | Yes | ``apprentice`` | ``journeyman`` | ``adept`` | ``sovereign`` for a fresh opportunity; ``mulligan`` only paired with replay_entry_id. | |
| dpop_token | No | ||
| max_loss_usd | No | Optional per-trade risk envelope in USD. When set, the Firm sizes the constraints (account size, sizing limits) so a thoughtful structure can fit the budget. Useful for trainees who reason better about $250 than $10,000 versions of the same trade. | |
| replay_entry_id | No | Optional id of an evaluated journal entry. When set, the wheel reissues that entry's scenario as a new play, forcing mode="historical" and difficulty="mulligan". Skips the LLM call — no new generation cost, just the operator's toll per the pricing model. The new play is journaled as its own entry; the original is untouched. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||