Jupiter — Prediction API — List events
jupiter_get_prediction_v1_eventsPaginated list of prediction events, each holding one or more binary YES/NO markets. Filter by provider, category, subcategory, tags and status (filter), sort by volume or start time, and set includeMarkets=true to nest each event's markets in the response. Paginate with the start and end indexes. Latest request and response verified through OpenAny testnet.
Uses the caller's OpenAny gateway credentials. Charges and authorization are determined by the gateway.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | Pagination end index of the page to return. | |
| tags | No | Filter events by tag (e.g. `soccer`). | |
| start | No | Pagination start index of the page to return. | |
| filter | No | Apply named filters. Use `new` for events created in the last 24 hours, `live` for events that have begun, `trending` for events with recent trade activity, and `upcoming` for events that have not begun yet. | |
| sortBy | No | Sort field for events (volume or begin time). Pair with sortDirection to control ascending/descending. | |
| category | No | Event category. `all` returns every category. | |
| provider | No | Data provider for events (defaults to polymarket). Use `bisonfi` for Jupiter Forecast markets. | |
| subcategory | No | Subcategory within the chosen category. Import profile accepts the string branch only; other union branches are not exposed. | |
| sortDirection | No | Direction for the chosen sort field. Defaults to desc for volume and asc for beginAt. | |
| includeMarkets | No | Set to `true` to nest each event's markets in the response. | |
| includeAllMarkets | No | Include all allowed sports market types (moneyline, spread, totals) and extra (e.g. Saba) markets mapped onto Polymarket events. Defaults to false (moneyline only). F1 events always include every sportsMarketType. |