Place an order
place_betPlaces real buy or sell orders on prediction markets, spending or selling the user's balance and filling market or limit trades after the user confirms a simulated bet.
Instructions
Places a real order on a market: it spends or sells the user's actual balance and fills immediately against the book where it can. Only call it after the user has explicitly confirmed a get_bet_simulation with these same numbers. With a price it is a limit order (the unfilled part rests on the book unless time_in_force is ioc); without one it is a market order at the best available prices. Returns the created order, including its id, status and fills; use cancel_order to withdraw a resting order.
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": {
"market": "<market>",
"side": "<side>",
"position": "<position>",
"currency": "<currency>",
"shares": "<shares>"
},
"name": "place_bet"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| side | Yes | `bid` buys shares; `ask` sells shares you already hold. To buy Yes use side bid with position long; to buy No use side bid with position short; to sell shares you hold use side ask with the position you hold. | |
| price | No | Limit price per share, in whole cents between 0.01 and 0.99. A bid fills at this price or lower, an ask at this price or higher. Omit for a market order. Required for ioc and for shares "max". | |
| market | Yes | Market (outcome) id: the `id` of an entry in an event's `markets` list. This is not the event id. | |
| shares | Yes | Number of shares to buy or sell, at most 2 decimals and above 0.02. On side ask only, the string "max" sells every share you hold of this position that is not already reserved by an open sell order (requires `price`). | |
| currency | Yes | `OOM` is play money. `USDC`, `USDT` and `USD` are real money and only work on events whose available_currencies include them. | |
| position | Yes | `long` is the Yes side of the market (pays 1 if the outcome happens); `short` is the No side (pays 1 if it does not). Shares of each position trade in their own order book. | |
| expired_at | No | ISO 8601 time (for example 2026-12-31T23:59:00Z) after which an unfilled resting order is cancelled automatically. Omit for no expiry. | |
| time_in_force | No | `gtc` (default): the part that cannot fill now rests on the book until filled, cancelled or expired. `ioc`: fill what is possible right now at `price` or better and cancel the rest; requires `price`. | |
| cancel_conflicting_orders | No | If true, your own open orders that tie up the balance or shares this order needs are cancelled first. If false or omitted, such a conflict makes the order fail. |