Skip to main content
GET
/
api
/
events
/
{slug}
/
markets
Get markets for event
curl --request GET \
  --url http://localhost:8000/api/events/{slug}/markets \
  --header 'Authorization: Bearer <token>'
[
  {
    "venue": "kalshi",
    "venue_market_id": "SUPERBOWL-2025-KC",
    "title": "Kansas City Chiefs to win Super Bowl LIX",
    "status": "active",
    "venue_event_id": "SUPERBOWL-2025",
    "pear_event_id": "pear_3f8a1b2c",
    "description": "<string>",
    "market_slug": "chiefs-win-superbowl-lix",
    "outcomes": [
      "Yes",
      "No"
    ],
    "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": "<string>",
    "image_url": "<string>"
  }
]

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"

Query Parameters

​
venue
enum<string>

Filter markets by trading venue.

Available options:
kalshi,
polymarket

Response

A list of venue markets for the event.

​
venue
enum<string>
required

The trading platform this market is listed on.

Available options:
kalshi,
polymarket
​
venue_market_id
string
required

The venue's native market identifier.

Example:

"SUPERBOWL-2025-KC"

​
title
string
required

Market title.

Example:

"Kansas City Chiefs to win Super Bowl LIX"

​
status
enum<string>
required

Current market status.

Available options:
active,
closed,
resolved
​
venue_event_id
string

The venue's native event identifier that this market belongs to.

Example:

"SUPERBOWL-2025"

​
pear_event_id
string

The Pear event ID that this market is associated with.

Example:

"pear_3f8a1b2c"

​
description
string | null

Detailed description of the market and its resolution criteria.

​
market_slug
string

URL-friendly market identifier.

Example:

"chiefs-win-superbowl-lix"

​
outcomes
string[]

Possible outcomes for this market.

Example:
["Yes", "No"]
​
end_date_iso
string<date-time> | null

When the market is scheduled to close or resolve.

Example:

"2025-02-10T00:00:00Z"

​
best_bid
number | null

Highest current bid price (0-1 scale, where 1 = $1.00).

Example:

0.62

​
best_ask
number | null

Lowest current ask price (0-1 scale, where 1 = $1.00).

Example:

0.64

​
mid_price
number | null

Midpoint between best bid and best ask. Often used as the market's implied probability.

Example:

0.63

​
spread
number | null

Difference between best ask and best bid. Lower spreads indicate better liquidity.

Example:

0.02

​
volume
number | null

Total trading volume (in contracts or dollars depending on venue).

Example:

1845230

​
volume_24h
number | null

Trading volume in the last 24 hours.

Example:

234500

​
open_interest
number | null

Total number of outstanding contracts.

Example:

892100

​
liquidity
number | null

Available liquidity in the order book.

Example:

156000

​
icon_url
string | null

URL to the market icon image, if available.

​
image_url
string | null

URL to the market cover image, if available.