Skip to main content
GET
/
v1
/
events
/
{slug}
Get event details
curl --request GET \
  --url https://api.rekko.ai/v1/events/{slug}
{
  "slug": "<string>",
  "title": "<string>",
  "platform": "<string>",
  "market_count": 1,
  "total_volume_24h": 1,
  "updated_at": "2023-11-07T05:31:56Z",
  "description": "",
  "category": "",
  "top_yes_price": 0.5,
  "mutually_exclusive": true,
  "status": "open",
  "end_date": "2023-11-07T05:31:56Z",
  "featured": false,
  "also_on": [
    {
      "platform": "<string>",
      "event_id": "<string>",
      "url": "",
      "market_count": 0
    }
  ],
  "markets": [
    {
      "market_id": "<string>",
      "title": "<string>",
      "yes_price": 0.5,
      "volume_24h": 0,
      "url": "",
      "open_interest": 1,
      "spread": 1
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://rekko.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

Path Parameters

slug
string
required

Event slug (e.g., 'kalshi:kxtrumpadminleave-26dec31')

Maximum string length: 200

Query Parameters

expand
string
default:""

Comma-separated expansions: 'markets'

Maximum string length: 100

Response

Successful Response

Prediction market event grouping related outcome markets.

An event like "Who will leave the Trump administration?" contains multiple individual markets (one per potential leaver). This model aggregates them with pre-computed stats.

slug
string
required

URL-safe event identifier (e.g., 'kalshi:kxtrumpadminleave-26dec31')

title
string
required

Event question (e.g., 'Who will leave the Trump administration?')

platform
string
required

Primary platform (kalshi, polymarket)

market_count
integer
required

Number of individual outcome markets in this event

Required range: x >= 0
total_volume_24h
number
required

Aggregate 24h volume across all markets in USD

Required range: x >= 0
updated_at
string<date-time>
required

When aggregate stats were last refreshed

description
string
default:""

Event subtitle or description

category
string
default:""

Event category (politics, economics, sports, etc.)

top_yes_price
number | null

Highest-probability outcome price

Required range: 0 <= x <= 1
mutually_exclusive
boolean | null

Whether outcomes are mutually exclusive (probabilities should sum to ~1.0)

status
string
default:open

Event status: open, closed, settled

end_date
string<date-time> | null

When the event resolves/expires

Platform is actively promoting this event

also_on
EventPlatformPresence · object[]

Same event on other platforms (cross-platform linking via embedding similarity)

markets
EventMarketSummary · object[] | null

Individual outcome markets (include with ?expand=markets)