API reference · Live events

Get an event

GET/v1/events/{event_id}

One event with its markets and rules, its sources, and its latest phrase hits.

On this page

Auth. None. Without a token the call is served as Free (the Free delay and request budget, shared per IP); send Authorization: Bearer lb_… for your plan's.

Limits. Counts against your plan's API requests (60, 600 or 3,000 a minute on Free, Builder and Standard). Served at your plan's delay (+60 s Free, +10 s Builder, +2 s Standard).

Parameters

Path parameters

Name	Type	Required	Description
`event_id`	string	yes	The event id (`ev_…`).

Request

Terminal

curl "https://api.langbot.ai/v1/events/ev_kxtrumpsaycountry_26dec01"

Python

from langbot import LangbotClient

async with LangbotClient() as lb:
    e = await lb.event("ev_kxtrumpsaycountry_26dec01")
    print(e.title, e.status, len(e.markets))

TypeScript

import { LangbotClient } from "@langbotai/sdk";

const lb = new LangbotClient();
const e = await lb.event("ev_kxtrumpsaycountry_26dec01");
console.log(e.title, e.status);

Response

200 OK

JSON

{
  "id": "ev_kxtrumpsaycountry_26dec01",
  "title": "What countries will Trump say in November?",
  "kind": "other",
  "starts_at": 1793505600000,
  "ends_at": 1796137200000,
  "status": "scheduled",
  "meta": {
    "venue": "kalshi",
    "window": true,
    "company": null,
    "speaker": "Donald Trump",
    "category": "Mentions",
    "sub_title": "Before Dec 1, 2026",
    "date_known": true,
    "time_known": false,
    "speaker_key": "trump",
    "timing_note": "window market",
    "event_ticker": "KXTRUMPSAYCOUNTRY-26DEC01",
    "market_count": 42,
    "series_title": "Will Trump mention country",
    "series_ticker": "KXTRUMPSAYCOUNTRY",
    "settlement_sources": ["ABC"]
  },
  "speaker_keys": [],
  "sources": [
    {
      "id": "src_kxtrumpsaycountry_26dec01_cspan_youtube_live",
      "event_id": "ev_kxtrumpsaycountry_26dec01",
      "kind": "hls",
      "expected_latency_ms": 20000,
      "status": "planned",
      "rights": "restricted",
      "retention_days": 30
    }
  ],
  "markets": [
    {
      "ticker": "KXTRUMPSAYCOUNTRY-26DEC01-CAN",
      "venue": "kalshi",
      "event_id": "ev_kxtrumpsaycountry_26dec01",
      "title": "Will Trump say \"Canada / Canadian\" before Dec 1, 2026?",
      "rules_text": "If Canada / Canadian, or a plural or possessive form of Canada / Canadian, is stated by Donald Trump before Dec 1, 2026 at 12:00am ET, then the market resolv…",
      "phrases": ["canada"],
      "status": "settled",
      "close_ts": 1793623539000
    }
  ],
  "phrases": ["afghan"],
  "rights": "restricted",
  "stats": {
    "phrases_detected": 1842,
    "events_total": 1905,
    "last_seq": 37878,
    "last_t_spoken": 1793685708503,
    "p50_lag_ms": null
  },
  "delay_ms": 60000,
  "recent_phrases": [
    {
      "id": "evt_GQMRV000WZRRMVQ11Q4WAZY61N",
      "type": "phrase_detected",
      "source_id": "src_shared_aljazeera_english_live",
      "event_id": "ev_kxtrumpsaycountry_26dec01",
      "market_refs": ["KXTRUMPSAYCOUNTRY-26DEC01-PALE"],
      "phrase": "palestinians",
      "raw": "palestinians",
      "speaker": null,
      "confidence": 0.36,
      "t_spoken": 1793685708503,
      "t_detected": 1793685708556,
      "t_emitted": 1793685708575,
      "lag_vs_public_ms": null,
      "source_kind": "hls",
      "seq": 26978,
      "hash": "cb9c34bccf455925870749a7600c9ce2b2feddb015f87d25ab0dbe8f8f9e0f4c",
      "prev_hash": "2aef236c485bf28b9bf7df68d204fdf27ba42f8df4191cab3acd5a221ae99d11",
      "raw_hash": "609ef9b39f1691dbc69419a9aaebf621aa4a3f9955fa3956939bffcaa4ec8cb5",
      "chain_seq": 30595,
      "fact": null,
      "class": "fact",
      "verdict": {
        "role": null,
        "counts": null,
        "needed": 1,
        "reason": "speaker not verified: only Donald Trump counts",
        "mention": 0
      }
    }
  ]
}

A real response from the API; long lists are cut to their first items.

Errors

Status	`code`	When
404	`not_found`	No event with that id.
401	`token_invalid`	A token was sent and not recognised. Send a valid one, or none to call anonymously.
422	`validation_error`	A parameter failed validation; `detail[].loc` names it.
429	`rate_limited`	Over your request budget; wait `Retry-After` seconds.

Every error body is {"detail": …, "code": "…"}; branch on code. All codes: Errors.