List events
curl --request GET \
--url https://relay.bayse.markets/v1/pm/events{
"events": [
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"slug": "super-eagles-afcon-2026",
"title": "Will Super Eagles qualify for AFCON 2026?",
"description": "Nigeria national football team qualification.",
"category": "sports",
"type": "single",
"engine": "AMM",
"status": "open",
"resolutionDate": "2025-11-20T00:00:00Z",
"closingDate": "2025-11-19T18:00:00Z",
"imageUrl": "https://cdn.bayse.markets/events/afcon2026.jpg",
"liquidity": 50000,
"totalVolume": 120000,
"totalOrders": 843,
"supportedCurrencies": ["USD", "NGN"],
"userWatchlisted": false,
"markets": [
{
"id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"title": "Will Super Eagles qualify?",
"status": "open",
"outcome1Id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
"outcome1Label": "YES",
"outcome1Price": 0.72,
"outcome2Id": "d4e5f6a7-b8c9-0123-defa-234567890123",
"outcome2Label": "NO",
"outcome2Price": 0.28,
"yesBuyPrice": 0.72,
"noBuyPrice": 0.28,
"feePercentage": 2.0,
"totalOrders": 843,
"rules": "Resolves YES if Nigeria qualifies for AFCON 2026."
}
]
}
],
"pagination": {
"page": 1,
"size": 10,
"lastPage": 3,
"totalCount": 28
}
}
Trading
List events
Get a paginated list of prediction market events
GET
/
v1
/
pm
/
events
List events
curl --request GET \
--url https://relay.bayse.markets/v1/pm/events{
"events": [
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"slug": "super-eagles-afcon-2026",
"title": "Will Super Eagles qualify for AFCON 2026?",
"description": "Nigeria national football team qualification.",
"category": "sports",
"type": "single",
"engine": "AMM",
"status": "open",
"resolutionDate": "2025-11-20T00:00:00Z",
"closingDate": "2025-11-19T18:00:00Z",
"imageUrl": "https://cdn.bayse.markets/events/afcon2026.jpg",
"liquidity": 50000,
"totalVolume": 120000,
"totalOrders": 843,
"supportedCurrencies": ["USD", "NGN"],
"userWatchlisted": false,
"markets": [
{
"id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"title": "Will Super Eagles qualify?",
"status": "open",
"outcome1Id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
"outcome1Label": "YES",
"outcome1Price": 0.72,
"outcome2Id": "d4e5f6a7-b8c9-0123-defa-234567890123",
"outcome2Label": "NO",
"outcome2Price": 0.28,
"yesBuyPrice": 0.72,
"noBuyPrice": 0.28,
"feePercentage": 2.0,
"totalOrders": 843,
"rules": "Resolves YES if Nigeria qualifies for AFCON 2026."
}
]
}
],
"pagination": {
"page": 1,
"size": 10,
"lastPage": 3,
"totalCount": 28
}
}
Documentation Index
Fetch the complete documentation index at: https://docs.bayse.markets/llms.txt
Use this file to discover all available pages before exploring further.
Authentication
Public — no authentication required. ProvideX-Public-Key to receive personalized data (e.g. watchlist status).
Query parameters
Page number.
Results per page.
Filter by category (e.g.
sports, crypto, politics).Filter by subcategory.
Filter by status:
open, paused, closed, resolved, cancelled. Defaults to open (includes paused) when omitted.Search events by title keyword.
Currency for prices:
USD or NGN.Return trending events only.
Return watchlisted events only (requires
X-Public-Key).Filter by event series slug (e.g.
crypto-btc-1h).Example request
curl "https://relay.bayse.markets/v1/pm/events?category=sports&status=open¤cy=USD&page=1&size=10"
Response
List of event objects.
Show event fields
Show event fields
UUID of the event.
Human-readable URL slug for the event.
The prediction question.
Additional context.
Event category.
single or combined.AMM or CLOB.Current status:
open, paused, closed, resolved, or cancelled.ISO 8601 — when the event opens for trading. Present on time-boxed events (e.g. crypto).
ISO 8601 — when the outcome is determined.
ISO 8601 — when trading closes.
Cover image URL.
Total liquidity in the event.
Total trading volume.
Total number of orders placed.
Currencies available for trading.
Whether the authenticated user has watchlisted this event.
Trading pair symbol (e.g.
BTCUSDT). Present on crypto events.Opening/reference price for the event. Present on crypto events.
Threshold range in format
"100-200". Present when the event covers a price range.Closing price at resolution. Present on resolved crypto events.
Slug of the event series this event belongs to (e.g.
crypto-btc-1h).Sub-markets within the event.
Show market fields
Show market fields
UUID of the market.
Sub-market question.
Market status.
UUID of outcome 1.
Label for outcome 1 (e.g.
YES).Current probability price for outcome 1 (0.00–1.00).
UUID of outcome 2.
Label for outcome 2 (e.g.
NO).Current probability price for outcome 2 (0.00–1.00).
UUID of the resolved outcome. Present when the market is resolved.
Effective buy price for outcome 1.
Effective buy price for outcome 2.
Trading fee as a percentage.
Number of orders in this market.
Resolution criteria.
Opening/reference price for the market. Present on crypto markets.
Threshold range in format
"100-200". Present when the market covers a price range.Closing price at resolution. Present on resolved crypto markets.
Liquidity reward program info. Present when the market has an active reward program.
{
"events": [
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"slug": "super-eagles-afcon-2026",
"title": "Will Super Eagles qualify for AFCON 2026?",
"description": "Nigeria national football team qualification.",
"category": "sports",
"type": "single",
"engine": "AMM",
"status": "open",
"resolutionDate": "2025-11-20T00:00:00Z",
"closingDate": "2025-11-19T18:00:00Z",
"imageUrl": "https://cdn.bayse.markets/events/afcon2026.jpg",
"liquidity": 50000,
"totalVolume": 120000,
"totalOrders": 843,
"supportedCurrencies": ["USD", "NGN"],
"userWatchlisted": false,
"markets": [
{
"id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"title": "Will Super Eagles qualify?",
"status": "open",
"outcome1Id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
"outcome1Label": "YES",
"outcome1Price": 0.72,
"outcome2Id": "d4e5f6a7-b8c9-0123-defa-234567890123",
"outcome2Label": "NO",
"outcome2Price": 0.28,
"yesBuyPrice": 0.72,
"noBuyPrice": 0.28,
"feePercentage": 2.0,
"totalOrders": 843,
"rules": "Resolves YES if Nigeria qualifies for AFCON 2026."
}
]
}
],
"pagination": {
"page": 1,
"size": 10,
"lastPage": 3,
"totalCount": 28
}
}
⌘I