> ## 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.

# Get event

> Get a specific prediction market event by ID

## Authentication

Public — no authentication required. Provide `X-Public-Key` for personalized data (watchlist status).

## Path parameters

<ParamField path="eventId" type="string" required>
  UUID of the event.
</ParamField>

## Query parameters

<ParamField query="currency" type="string" default="USD">
  Currency for prices: `USD` or `NGN`.
</ParamField>

## Example request

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://relay.bayse.markets/v1/pm/events/a1b2c3d4-e5f6-7890-abcd-ef1234567890?currency=NGN" \
    -H "X-Public-Key: pk_live_abcdef123456"
  ```

  ```javascript Node.js theme={null}
  const eventId = 'a1b2c3d4-e5f6-7890-abcd-ef1234567890';
  const response = await fetch(
    `https://relay.bayse.markets/v1/pm/events/${eventId}?currency=NGN`,
    { headers: { 'X-Public-Key': 'pk_live_abcdef123456' } }
  );
  const event = await response.json();
  ```

  ```python Python theme={null}
  import requests

  event_id = 'a1b2c3d4-e5f6-7890-abcd-ef1234567890'
  resp = requests.get(
      f'https://relay.bayse.markets/v1/pm/events/{event_id}',
      params={'currency': 'NGN'},
      headers={'X-Public-Key': 'pk_live_abcdef123456'},
  )
  event = resp.json()
  ```

  ```go Go theme={null}
  req, _ := http.NewRequest(
      "GET",
      "https://relay.bayse.markets/v1/pm/events/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      nil,
  )
  q := req.URL.Query()
  q.Add("currency", "NGN")
  req.URL.RawQuery = q.Encode()
  req.Header.Set("X-Public-Key", "pk_live_abcdef123456")
  resp, _ := http.DefaultClient.Do(req)
  ```
</CodeGroup>

## Response

Returns a single event object. See [List events](/api-reference/pm/list-events) for the full field reference — the response shape is identical.

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "slug": "super-eagles-afcon-2026",
    "title": "Will Super Eagles qualify for AFCON 2026?",
    "category": "sports",
    "type": "single",
    "engine": "AMM",
    "status": "open",
    "resolutionDate": "2025-11-20T00:00:00Z",
    "closingDate": "2025-11-19T18:00:00Z",
    "liquidity": 50000,
    "totalVolume": 120000,
    "totalOrders": 843,
    "supportedCurrencies": ["USD", "NGN"],
    "userWatchlisted": true,
    "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,
        "minimumOrderAmount": 100,
        "noBuyPrice": 0.28,
        "feePercentage": 2.0,
        "totalOrders": 843,
        "rules": "Resolves YES if Nigeria qualifies for AFCON 2026."
      }
    ]
  }
  ```

  ```json 404 Not Found theme={null}
  {
    "error": "not_found",
    "message": "Event not found",
    "statusCode": 404
  }
  ```
</ResponseExample>