> ## Documentation Index > Fetch the complete documentation index at: https://doc.astreus.ai/llms.txt > Use this file to discover all available pages before exploring further. # Events & news > Typed 8-K material events with the item text, a searchable market-wide wire, and an attributed intraday news tape. ## 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. ``` GET /api/v1/companies/{id}/events?limit= ``` 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. ``` GET /api/v1/companies/{id}/events/{accession}?item=2.02 ``` 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, `astreus 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. ``` GET /api/v1/events/wire?q=&family=&from=&to=&sort=newest&limit=50&offset=0&counts=1 GET /api/v1/events/latest?family=&limit=30 ``` 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 | Family | Family | | ------------------------------------------------------------ | ----------------------------------------------------------- | | `earnings` · `guidance` | `mna` · `agreement` | | `dividend` · `buyback` · `stock_split` | `debt_financing` · `equity_financing` | | `leadership` · `governance_vote` | `restructuring` · `impairment` · `restatement_non_reliance` | | `legal_regulatory` · `listing_compliance` · `cyber_incident` | `other` | ## 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 Astreus 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. ``` GET /api/v1/news/feed GET /api/v1/companies/{id}/news ``` Cursor-paged on item id: poll forward with `after=` (add `changedSince=` to pick up headlines that were rewritten), page back with `before=`. 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. ``` GET /api/v1/news/items/{id} GET /api/v1/news/search?q= GET /api/v1/news/top?window=24h&limit=30 GET /api/v1/news/topics GET /api/v1/news/sources ``` `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. ``` GET /api/v1/news/stream ``` 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=`. Accepts the feed's filters. `astreus news --follow` wraps the polling for a terminal.