> ## 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 by slug

> Get a specific prediction market event by its slug

## Authentication

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

## Path parameters

<ParamField path="slug" type="string" required>
  Human-readable slug of the event (e.g. `crypto-btc-1h-feb-24-11am`).
</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/slug/crypto-btc-1h-feb-24-11am?currency=USD" \
    -H "X-Public-Key: pk_live_abcdef123456"
  ```

  ```javascript Node.js theme={null}
  const slug = 'crypto-btc-1h-feb-24-11am';
  const response = await fetch(
    `https://relay.bayse.markets/v1/pm/events/slug/${slug}?currency=USD`,
    { headers: { 'X-Public-Key': 'pk_live_abcdef123456' } }
  );
  const event = await response.json();
  ```

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

  slug = 'crypto-btc-1h-feb-24-11am'
  resp = requests.get(
      f'https://relay.bayse.markets/v1/pm/events/slug/{slug}',
      params={'currency': 'USD'},
      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/slug/crypto-btc-1h-feb-24-11am",
      nil,
  )
  q := req.URL.Query()
  q.Add("currency", "USD")
  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": "crypto-btc-1h-feb-24-11am",
    "title": "Bitcoin Hourly — Feb 24 11am GMT",
    "category": "crypto",
    "type": "single",
    "engine": "AMM",
    "status": "open",
    "openingDate": "2025-02-24T11:00:00Z",
    "closingDate": "2025-02-24T12:00:00Z",
    "resolutionDate": "2025-02-24T12:01:00Z",
    "assetSymbolPair": "BTCUSDT",
    "eventThreshold": 96250.50,
    "seriesSlug": "crypto-btc-1h",
    "liquidity": 10000,
    "totalVolume": 25000,
    "totalOrders": 142,
    "supportedCurrencies": ["USD", "NGN"],
    "userWatchlisted": false,
    "markets": [
      {
        "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
        "title": "BTC above $96,250.50?",
        "status": "open",
        "outcome1Id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
        "outcome1Label": "YES",
        "outcome1Price": 0.55,
        "outcome2Id": "d4e5f6a7-b8c9-0123-defa-234567890123",
        "outcome2Label": "NO",
        "outcome2Price": 0.45,
        "yesBuyPrice": 0.55,
        "noBuyPrice": 0.45,
        "feePercentage": 2.0,
        "totalOrders": 142,
        "marketThreshold": 96250.50,
        "rules": "Resolves YES if BTC price is above $96,250.50 at closing."
      }
    ]
  }
  ```

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