Skip to main content

​
8-K events

Every 8-K is routed by item code and typed into an event family; the item’s text is extracted and served verbatim, and the platform’s headline for it is gated before it is shown.
A company’s events, newest first, each with its family, item codes, filing date and accession. Without limit you get the whole history; limit accepts 1–500.
The pre-extracted plain text of one item. item is the 8-K item code (2.02, 5.02, 7.01, …). When a filing has exactly one coded item, prom event and the MCP tool get_event_text resolve it for you; when it has several, the response tells you which items the filing carries so you can pick one.
The market-wide wire: full-text search (q) over event headlines, filtered by one or more families and a date window, paginated, with counts=1 adding a per-family tally. latest is the simplest form — the newest events across the universe.

​
Event families

​
News

The news tape is a single, attributed stream of everything the platform sees intraday: SEC filings as they are accepted, issuer press releases, exchange and regulator notices, central-bank releases, licensed wires and market data events — each item stamped with the source’s own time and the moment Prometheus first saw it, and each carrying its source attribution and display policy. Where a licence does not allow the snippet or body to be shown, those fields are withheld rather than paraphrased.
Cursor-paged on item id: poll forward with after=<latestId> (add changedSince=<serverTime> to pick up headlines that were rewritten), page back with before=<nextCursor>. Filters: tickers, cik, topics, sources, excludeSources, excludeForms, flash=1 (flash headlines only), minImportance (0–100) and q. limit is 1–200, default 100. The company route applies the same cursors to one issuer’s tape, including items tagged to predecessors in its corporate lineage.
items/{id} returns one story with its entity tags (companies, people, indicators), the rest of its storyline and — for full-text-licensed sources only — the body. search is full-text over headline and snippet with the feed’s filters. top collapses each storyline to its strongest item and ranks by importance within a 6h, 24h or 7d window. topics and sources return the taxonomy and the enabled sources with their licence class, attribution line and 24-hour counts.
Server-Sent Events. Emits event: items frames carrying the same body as the feed whenever new or rewritten rows appear, a : ping comment every 15 seconds, and closes after about 280 seconds — reconnect with after=<last latestId>. Accepts the feed’s filters. prom news --follow wraps the polling for a terminal.