Search events and markets
get_marketsBrowse and search Futuur events with their markets and current prices, then filter by text, category, tag, status or close date and sort by volume or activity.
Instructions
Lists or searches Futuur events, each with its markets and current prices, in one page. An event is the question (id, title, status, close date, category, volume); a market is one tradeable outcome of it, and a market's price is the probability of the long position (0 to 1) in each available currency (OOM is play money, USDC is real money). Use it to find events by text, category, tag, status or close date, or to rank them by volume or recent activity. Returns total, returned and next_offset (null on the last page); pass next_offset as offset for the next page. Use get_market_details for one event's full description.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_markets"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tags | No | Up to 10 tag slugs or names (case-insensitive). An event matching any listed tag is returned. | |
| limit | No | Events per page, 1 to 50. Default 20. | |
| offset | No | Number of events to skip, for paging (use next_offset from the previous page). Default 0, maximum 10000. | |
| search | No | Case-insensitive text search across event titles, market names, categories and tags. Max 100 characters. | |
| status | No | Which events to list. "open" (default): open for trading, plus recently closed ones awaiting resolution. "live": live now or starting within 12 hours. "pending_resolution": closed but not resolved yet. "resolved": resolved events, newest first. | open |
| ordering | No | Sort order; a leading "-" means descending. Allowed: relevance, created_on, bet_end_date, wagers_count, volume, open_date, resolve_date (each with or without "-"). Defaults to "-relevance" for a normal listing (resolved events are always newest first). | |
| categories | No | Category ids (see get_categories). A top-level category includes all its subcategories. An event matching any listed category is returned. | |
| hide_my_bets | No | If true, omit events the user already bet on. Needs API keys configured. | |
| currency_mode | No | "play_money" (default): events tradeable with OOM play money. "real_money": events tradeable with real money (USDC/USDT). Also decides which volume the "volume" ordering uses. | play_money |
| category_slugs | No | Category slugs such as "crypto-prices", as an alternative to ids. If both are given, an event must match both. | |
| bet_end_date_after | No | Only events whose trading closes at or after this time. ISO 8601 with a timezone, e.g. 2026-11-01T00:00:00Z. | |
| bet_end_date_before | No | Only events whose trading closes at or before this time. ISO 8601 with a timezone, e.g. 2026-12-01T00:00:00Z. | |
| only_markets_i_follow | No | If true, only events the user follows. Needs API keys configured. |