API reference · Live events

List recent events

GET/v1/events/recent

Recent feed events (phrase hits and lifecycle events) newest first, the REST way to backfill a stream gap.

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

Query parameters

Name	Type	Required	Description
`event_id`	string	no	One event (`ev_…`).
`phrases`	string	no	Comma-separated phrase keys.
`types`	string	no	Comma-separated event types; default everything but `transcript_delta`.
`source_id`	string	no	One source.
`since`	integer	no	ms epoch; default 24 hours ago.
`until`	integer	no	ms epoch, exclusive.
`cursor`	string	no	`next_cursor` from the previous page; send the same filters.
`limit`	integer	no	Page size. 1 to 1000. Default `100`.
`subjects`	string	no	Comma-separated typed-fact subjects (`fact_extracted`).
`context`	string	no	Comma-separated context kinds to include: `on_air`, `topic`, `near_miss` or `all`.

Request

Terminal

curl "https://api.langbot.ai/v1/events/recent?event_id=ev_kxexamplemention_26nov01&types=phrase_detected&limit=1"

Python

from langbot import LangbotClient

async with LangbotClient() as lb:
    page = await lb.recent_events_page("ev_kxexamplemention_26nov01", types=["phrase_detected"], limit=1)
    for evt in page.events:
        print(evt.phrase, evt.t_spoken, evt.verdict)

TypeScript

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

const lb = new LangbotClient();
const page = await lb.recentEventsPage({ eventId: "ev_kxexamplemention_26nov01", types: ["phrase_detected"], limit: 1 });
console.log(page.events, page.nextCursor);

Response

200 OK

JSON

{
  "ts": 1793566860000,
  "since": 1793566800000,
  "until": null,
  "delay_ms": 60000,
  "rights": "public_domain",
  "next_cursor": "cjoxNzkzNTY2ODA4MDAwOmV2dF8wMU02…",
  "events": [
    {
      "id": "evt_01M6CQ02PR3SVZ3TV7FCXH7E09",
      "type": "phrase_detected",
      "source_id": "src_example_public",
      "event_id": "ev_kxexamplemention_26nov01",
      "market_refs": ["KXEXAMPLEMENTION-26NOV01-TARI"],
      "phrase": "tariff",
      "raw": "we will talk about tariff today",
      "speaker": { "label": "SPK_1", "name": "Example Speaker", "confidence": 0.9 },
      "confidence": 0.93,
      "t_spoken": 1793566809000,
      "t_detected": 1793566809070,
      "t_emitted": 1793566809076,
      "lag_vs_public_ms": null,
      "source_kind": "hls",
      "seq": 9,
      "hash": "aaaa…",
      "prev_hash": "bbbb…",
      "raw_hash": "cccc…",
      "chain_seq": 10,
      "class": "fact",
      "verdict": { "counts": true, "reason": "mention 1 (1 needed)", "role": null }
    }
  ]
}

Pages run newest first: pass next_cursor back as cursor for the next, older page. On a restricted source raw is the matched phrase only. verdict is Langbot's reading of the market's rules, not a settlement. Every field: Live events.

Errors

Status	`code`	When
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.