Skip to main content
GET
/
api
/
events
/
{slug}
Get event by slug
curl --request GET \
  --url http://localhost:8000/api/events/{slug} \
  --header 'Authorization: Bearer <token>'
{
  "id": "pear_3f8a1b2c",
  "slug": "super-bowl-lix-2025",
  "title": "Super Bowl LIX 2025",
  "description": "Prediction markets for Super Bowl LIX outcomes including winner, MVP, and prop bets.",
  "category": "Sports",
  "source_type": "matched",
  "venue_event_ids": {
    "kalshi": "SUPERBOWL-2025",
    "polymarket": "0x1234abcd"
  },
  "markets": [
    {
      "venue": "kalshi",
      "venue_market_id": "SUPERBOWL-2025-KC",
      "venue_event_id": "SUPERBOWL-2025",
      "pear_event_id": "pear_3f8a1b2c",
      "title": "Kansas City Chiefs to win Super Bowl LIX",
      "description": "Resolves Yes if the Kansas City Chiefs win Super Bowl LIX.",
      "market_slug": "chiefs-win-superbowl-lix",
      "outcomes": [
        "Yes",
        "No"
      ],
      "status": "active",
      "end_date_iso": "2025-02-10T00:00:00Z",
      "best_bid": 0.62,
      "best_ask": 0.64,
      "mid_price": 0.63,
      "spread": 0.02,
      "volume": 1845230,
      "volume_24h": 234500,
      "open_interest": 892100,
      "liquidity": 156000,
      "icon_url": null,
      "image_url": "https://example.com/images/chiefs.png"
    },
    {
      "venue": "polymarket",
      "venue_market_id": "0x1234abcd-kc",
      "venue_event_id": "0x1234abcd",
      "pear_event_id": "pear_3f8a1b2c",
      "title": "Chiefs win Super Bowl?",
      "description": "This market resolves to Yes if the Kansas City Chiefs win Super Bowl LIX.",
      "market_slug": "chiefs-win-super-bowl",
      "outcomes": [
        "Yes",
        "No"
      ],
      "status": "active",
      "end_date_iso": "2025-02-10T00:00:00Z",
      "best_bid": 0.61,
      "best_ask": 0.63,
      "mid_price": 0.62,
      "spread": 0.02,
      "volume": 2103400,
      "volume_24h": 312000,
      "open_interest": 1045000,
      "liquidity": 203000,
      "icon_url": null,
      "image_url": "https://example.com/images/chiefs-poly.png"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Use your API key as a Bearer token. Example: Authorization: Bearer mk_live_...

Path Parameters

​
slug
string
required

The URL-friendly slug of the event.

Example:

"super-bowl-lix-2025"

Response

The event with all associated venue markets.

A unified prediction market event that aggregates data from one or more venues.

​
id
string
required

Unique Pear event identifier in pear_xxx format.

Example:

"pear_3f8a1b2c"

​
slug
string
required

URL-friendly identifier for the event.

Example:

"super-bowl-lix-2025"

​
title
string
required

Human-readable event title.

Example:

"Super Bowl LIX 2025"

​
category
string
required

Event category.

Example:

"Sports"

​
source_type
enum<string>
required

Indicates whether this event exists on both platforms (matched) or only one (polymarket_only, kalshi_only).

Available options:
matched,
polymarket_only,
kalshi_only
​
description
string | null

Detailed description of the event.

Example:

"Prediction markets for Super Bowl LIX outcomes."

​
venue_event_ids
object

Mapping of venue names to their native event identifiers.

​
markets
object[]

All venue markets associated with this event.