curl --request GET \
--url https://api.example.com/api/events{
"events": [
{
"id": "<string>",
"slug": "<string>",
"title": "<string>",
"icon_url": "<string>",
"status": "<string>",
"volume": 123,
"created_at": "<string>",
"end_date": "<string>",
"markets": [
{
"condition_id": "<string>",
"title": "<string>",
"probability": 123,
"price": 123,
"volume": 123,
"volume_24h": 123,
"outcomes": [
{
"token_id": "<string>",
"outcome_text": "<string>",
"outcome_index": 123,
"buy_price": 123,
"sell_price": 123
}
]
}
],
"tags": [
{
"id": 123,
"name": "<string>",
"slug": "<string>"
}
],
"is_bookmarked": true,
"is_trending": true
}
]
}Retrieve a list of prediction markets with filtering, search, and categorization options
curl --request GET \
--url https://api.example.com/api/events{
"events": [
{
"id": "<string>",
"slug": "<string>",
"title": "<string>",
"icon_url": "<string>",
"status": "<string>",
"volume": 123,
"created_at": "<string>",
"end_date": "<string>",
"markets": [
{
"condition_id": "<string>",
"title": "<string>",
"probability": 123,
"price": 123,
"volume": 123,
"volume_24h": 123,
"outcomes": [
{
"token_id": "<string>",
"outcome_text": "<string>",
"outcome_index": 123,
"buy_price": 123,
"sell_price": 123
}
]
}
],
"tags": [
{
"id": 123,
"name": "<string>",
"slug": "<string>"
}
],
"is_bookmarked": true,
"is_trending": true
}
]
}Documentation Index
Fetch the complete documentation index at: https://mintlify.com/kuestcom/prediction-market/llms.txt
Use this file to discover all available pages before exploring further.
/api/events endpoint returns a paginated list of prediction markets (events) with comprehensive filtering capabilities. Each event contains one or more markets with real-time pricing data, outcomes, and metadata.
trending - Markets sorted by recent volume or recently updatednew - Recently created marketscrypto, sports, politics, etc.active - Currently open marketsresolved - Closed and settled marketsall - All marketsdaily - Daily recurring marketsweekly - Weekly recurring marketsmonthly - Monthly recurring marketsnfl, nba, soccer).games - Full game marketsprops - Proposition betsen, es, fr).draft, active, resolved, or archived.curl --request GET \
--url 'https://api.kuest.com/api/events?tag=crypto&status=active&offset=0' \
--header 'Accept: application/json'
```bash
## Example Response
```json
[
{
"id": "01JBCDEFGHIJKLMNOPQRS",
"slug": "bitcoin-price-above-100k",
"title": "Will Bitcoin reach $100,000 by end of 2024?",
"icon_url": "https://storage.kuest.com/icons/bitcoin.png",
"status": "active",
"volume": 125430.50,
"created_at": "2024-01-15T10:30:00.000Z",
"end_date": "2024-12-31T23:59:59.000Z",
"markets": [
{
"condition_id": "0xabc123...",
"title": "Bitcoin > $100k by EOY 2024",
"probability": 65.5,
"price": 0.655,
"volume": 125430.50,
"volume_24h": 8920.25,
"outcomes": [
{
"token_id": "0xdef456...",
"outcome_text": "Yes",
"outcome_index": 0,
"buy_price": 0.655,
"sell_price": 0.650
},
{
"token_id": "0xghi789...",
"outcome_text": "No",
"outcome_index": 1,
"buy_price": 0.345,
"sell_price": 0.340
}
]
}
],
"tags": [
{
"id": 5,
"name": "Crypto",
"slug": "crypto"
}
],
"is_bookmarked": false,
"is_trending": true
}
]
```bash
## Error Responses
<ResponseField name="error" type="string">
Error message describing what went wrong.
</ResponseField>
### 400 Bad Request
```json
{
"error": "Invalid status filter."
}
```bash
Returned when:
- `status` is not `active` or `resolved`
- `frequency` is not one of: `all`, `daily`, `weekly`, `monthly`
- `sportsSection` is not `games`, `props`, or empty
### 500 Internal Server Error
```json
{
"error": "An unexpected error occurred. Please try again later."
}
```bash
Returned when the server encounters an unexpected error.
## Notes
- The endpoint returns up to 40 markets per request. Use the `offset` parameter for pagination.
- Markets are sorted by volume and recency when using the `trending` tag.
- For the `new` tag, markets tagged with internal hide flags are automatically filtered out.
- Sports markets aggregate volume by game when multiple markets exist for the same game.
- Real-time prices are fetched from the CLOB (Central Limit Order Book) for all active markets.
- The `locale` parameter affects both event titles and tag names if translations are available.