Skip to main content
GET
/
api
/
markets
/
{venue}
/
{market_id}
Get market by ID
curl --request GET \
  --url http://localhost:8000/api/markets/{venue}/{market_id} \
  --header 'Authorization: Bearer <token>'
{
  "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"
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
venue
enum<string>
required

The trading venue.

Available options:
kalshi,
polymarket
​
market_id
string
required

The venue-specific market identifier.

Example:

"SUPERBOWL-2025-KC"

Response

The venue market details.

An individual tradeable market contract on a specific prediction market platform.

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