Event Feed | Captain Docs

import requests
import json
BASE_URL = "https://api.runcaptain.com"
API_KEY = "your_api_key"
headers = {
    "Authorization": f"Bearer {API_KEY}",
}
# Stream the latest company events, newest first
response = requests.get(
    f"{BASE_URL}/v2/datasets/odyssey/feed",
    headers=headers,
    timeout=30.0
)
data = response.json()
print(json.dumps(data, indent=2))

{
  "events": [
    {
      "id": "evt_abc123",
      "type": "funding",
      "title": "Acme Robotics raises $200M Series C led by Sequoia",
      "company": {
        "role": "primary_subject",
        "name": "Acme Robotics",
        "domain": "acmerobotics.com",
        "entity_id": "ody_1k3m7qr5s2t4v6wac",
        "industry": "robotics",
        "location": "San Francisco, CA"
      },
      "published_at": "2026-05-25T14:30:00Z",
      "subhead": "San Francisco-based robotics company to scale manufacturing",
      "event_data": {
        "amount": 200000000,
        "round": "Series C",
        "lead_investor": "Sequoia",
        "investors": [
          "Sequoia",
          "a16z",
          "Founders Fund"
        ],
        "valuation": 1200000000
      },
      "sector": "robotics",
      "confidence": 0.97
    }
  ],
  "has_more": true,
  "next_cursor": "eyJkYXkiOiAiMjAyNi0wNS0yNSIsICJsZWsiOiB7Li4ufX0=",
  "page_size": 40
}

Paging: read the first page with since (and optionally until), then pass next_cursor back as cursor until has_more is false.

Filtering: types, sector, and min_amount narrow the stream. sector is matched exactly against the item’s sector label.

Polling: request fields=ids for a small title-only page, then fetch full detail for the events you care about.

Responses: a read with no matches returns 200 with an empty events list. If the upstream source is briefly unavailable the call returns 503; retry after a short pause.

Global, reverse-chronological firehose of every material company event Odyssey tracks: funding rounds, acquisitions, IPOs, executive changes, layoffs, partnerships, shutdowns, and product launches. Each item carries a resolved `company.entity_id`, so you can go straight from an event to the full company profile. **Paging:** read the first page with `since` (and optionally `until`), then pass `next_cursor` back as `cursor` until `has_more` is `false`. **Filtering:** `types`, `sector`, and `min_amount` narrow the stream. `sector` is matched exactly against the item's sector label. **Polling:** request `fields=ids` for a small title-only page, then fetch full detail for the events you care about. **Responses:** a read with no matches returns `200` with an empty `events` list. If the upstream source is briefly unavailable the call returns `503`; retry after a short pause.

Authentication

AuthorizationBearer

Bearer token authentication using API key

Query parameters

min_amountdoubleOptional

USD floor on event_data.amount. Drops events below the threshold.

sincestringOptionalformat: "date-time"

Only return items published at or after this ISO-8601 UTC timestamp (e.g. 2026-05-25T00:00:00Z). Sets the start boundary of the feed window. Ignored when cursor is supplied, the cursor already encodes the position.

untilstringOptionalformat: "date-time"

Only return items published strictly before this ISO-8601 UTC timestamp. Combine with since to backfill a fixed historical window.

cursorstringOptional

Opaque pagination cursor returned as next_cursor by the previous page. Pass it back verbatim to fetch the next (older) page. The feed walks UTC-day partitions backward automatically, so a single cursor is enough to drain the entire window, do not parse or construct it yourself.

page_sizeintegerOptional1-500Defaults to 40

Maximum items to return per page (1 to 500, default 40).

fieldsenumOptionalDefaults to full

full (default) returns complete items. ids returns title-only items (id, title, published_at) for cheap polling.

Allowed values:

Response

A page of events, newest first.

eventslist of objects

has_moreboolean

True if more items remain in the requested window.

next_cursorstring or null

Cursor for the next (older) page. null when the feed window is fully drained.

page_sizeinteger

Page size that was applied.

Errors

401

Unauthorized Error