Get price history
get_price_historyRetrieve price changes for every market in a Futuur event over time, returning one series per market for charting or trend analysis; pass the event ID and optional look-back window or point limit.
Instructions
Returns how the prices of every market in an event changed over time, one series per market, for charting or trend analysis. Each point has a UTC time and price_percent, the market's price as a percentage from 0 to 100 (50 means 0.50). Takes an EVENT id, not a market id. Long series are thinned evenly (first and last point kept) to max_points per series; total_points tells you how many existed.
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": {
"id": "<id>"
},
"name": "get_price_history"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Event id, as returned by get_markets. Not a market id. | |
| max_points | No | Maximum points returned per market series, 2 to 2000. Default 100. | |
| currency_mode | No | Which price history: "play_money" (default, OOM) or "real_money" (USDC/USDT). | play_money |
| time_interval | No | Look-back window ending now: day (24 hours), week (7 days), month (31 days), year (365 days) or all_time. Defaults to all_time. |