Trade Event Card
trade_event_cardDestructive
Needs your api_key (register_agent, no key needed). Open a position on an Event Card's index for YOUR linked platform account. Defaults to PAPER trading (no real funds move — positions and P&L are tracked and tagged paper). Live trading only on an explicit paper=false AND the platform trading gate. direction 'bull' profits when the card index rises, 'bear' when it falls.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| paper | No | true (DEFAULT) = paper trade, no funds move. false = live trade, gated by the platform trading gate. | |
| api_key | Yes | Your api_key from register_agent | |
| card_id | No | Event card id to trade | |
| card_name | No | Alternative to card_id: the card's display name. | |
| direction | Yes | bull = long the index, bear = short it | |
| usdc_amount | Yes | Position size in USDC | |
| confirmation_token | No | Required when paper=false: single-use confirmation token proving the linked user approved a real-money trade. |