Skip to main content
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
  }
}

Authentication

Public — no authentication required. Provide X-Public-Key to receive personalized data (e.g. watchlist status).

Query parameters

page
integer
default:"1"
Page number.
size
integer
default:"20"
Results per page.
category
string
Filter by category (e.g. sports, crypto, politics).
subcategory
string
Filter by subcategory.
status
string
Filter by status: open, closed, resolved, cancelled, paused, draft.
keyword
string
Search events by title keyword.
currency
string
default:"USD"
Currency for prices: USD or NGN.
Return trending events only.
watchlist
boolean
Return watchlisted events only (requires X-Public-Key).
seriesSlug
string
Filter by event series slug (e.g. crypto-btc-1h).

Example request

curl "https://relay.bayse.markets/v1/pm/events?category=sports&status=open&currency=USD&page=1&size=10"

Response

events
array
List of event objects.
pagination
object
{
  "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
  }
}