Simulate an order
get_bet_simulationPreview a buy or sell on a Futuur market without placing an order: estimate cost or proceeds, average price, immediate fill, and shares that would rest on the book.
Instructions
Previews a buy or sell on one market without placing anything. It reads the public order book and walks it the way the matching engine would, returning the estimated cost (or proceeds), average price, how many shares would fill immediately, and how many would rest on the book. This is an estimate: the book can change before a real order is placed, and your balance and holdings are not checked. Call it before place_bet and show the numbers to the user; order in the result holds the exact arguments to give place_bet.
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>",
"position": "<position>",
"currency": "<currency>"
},
"name": "get_bet_simulation"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| side | No | `bid` (default) previews buying shares; `ask` previews selling shares you hold. To buy Yes use bid with position long; to buy No use bid with position short. | bid |
| price | No | Limit price per share, in whole cents between 0.01 and 0.99. A bid only fills at this price or lower, an ask at this price or higher. Omit for a market order that takes the best prices available. | |
| amount | No | Money to spend, in `currency`. Only for side bid (buying). The simulation works out how many shares that buys at today's prices. Give either `shares` or `amount`. | |
| market | Yes | Market (outcome) id: the `id` of an entry in an event's `markets` list. This is not the event id. | |
| shares | No | Number of shares to buy or sell, at most 2 decimals. Give either `shares` or `amount`. | |
| 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. | |
| time_in_force | No | `gtc` (default): the part that cannot fill now rests on the book. `ioc`: the part that cannot fill now is cancelled; requires `price`. |