> ## 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.

# Data catalog

> Everything in the platform, mapped to its REST endpoint, astreus command and MCP tool.

One row per dataset. Paths are relative to `https://astreus.ai/api/v1`; every
endpoint is documented in full in the
[API Reference](https://doc.astreus.ai/api-reference) tab. `{id}` is a ticker,
SEC CIK or platform key (see [Coverage](/coverage)).

## Companies

| Dataset                                                                                | REST                                     | `astreus`            | MCP tool       |
| -------------------------------------------------------------------------------------- | ---------------------------------------- | -------------------- | -------------- |
| What is covered — every market and data type, live                                     | `GET /landing/coverage` (public)         | `astreus coverage`   | `get_coverage` |
| Resolve a name                                                                         | `GET /search?q=`                         | `astreus search`     | `search`       |
| Company list, by market or sector                                                      | `GET /companies?country=&sector=&scope=` | `astreus companies`  | —              |
| Profile, quote, key metrics, structure, lineage                                        | `GET /companies/{id}`                    | `astreus company`    | `get_company`  |
| Which tabs have content                                                                | `GET /companies/{id}/tab-presence`       | —                    | —              |
| Logo (public)                                                                          | `GET /companies/{id}/logo`               | `astreus logo`       | —              |
| Federal awards to the company's mapped recipients (USAspending)                        | `GET /companies/{id}/government-awards`  | `astreus awards`     | —              |
| Legislation, court cases, legal disclosures and executive actions touching the company | `GET /companies/{id}/regulation`         | `astreus regulation` | —              |

## Financial statements — [page](/financial-statements)

| Dataset                                                              | REST                                                                 | `astreus`                                              | MCP tool          |
| -------------------------------------------------------------------- | -------------------------------------------------------------------- | ------------------------------------------------------ | ----------------- |
| Standardized IS / BS / CF, ratios, segments & KPIs                   | `GET /companies/{id}/financials`                                     | `astreus financials`                                   | `get_financials`  |
| Statements exactly as the company printed them (JSON, CSV, XLSX)     | `GET /companies/{id}/financials/as-filed`                            | `astreus as-filed`                                     | —                 |
| Overview series (revenue/EPS, FCF, profit conversion, debt coverage) | `GET /companies/{id}/overview-series`                                | `astreus company --series`                             | —                 |
| The fact and filing behind any cell                                  | `GET /companies/{id}/fact-source`                                    | `astreus fact-source`                                  | `get_fact_source` |
| Dividends · capital structure · earnings calendar                    | `GET /companies/{id}/dividends` · `/capital-structure` · `/calendar` | `astreus dividends` · `capital-structure` · `calendar` | —                 |

## Segments & KPIs — [page](/segments-and-kpis)

| Dataset                                                 | REST                                                    | `astreus`                   | MCP tool              |
| ------------------------------------------------------- | ------------------------------------------------------- | --------------------------- | --------------------- |
| Latest revenue by segment / product / brand / channel   | `GET /companies/{id}/segment-revenue`                   | `astreus segments`          | `get_segment_revenue` |
| Latest revenue by region                                | `GET /companies/{id}/regional-revenue`                  | `astreus regions`           | `get_segment_revenue` |
| Full segment history, every metric, plus disclosed KPIs | `segments_kpis` inside `GET /companies/{id}/financials` | `astreus financials -s all` | `get_financials`      |
| Monthly revenue (Taiwan filers)                         | `GET /companies/{id}/monthly-revenue`                   | `astreus monthly-revenue`   | —                     |

## Filings & notes — [page](/filing-notes)

| Dataset                                                     | REST                                                                   | `astreus`             | MCP tool              |
| ----------------------------------------------------------- | ---------------------------------------------------------------------- | --------------------- | --------------------- |
| Filing index, per company or market-wide                    | `GET /companies/{id}/filings` · `GET /filings`                         | `astreus filings`     | `list_filings`        |
| A filing or source document (HTML, PDF, media)              | `GET /companies/{id}/filings/{accession}` · `GET /filings/{accession}` | `astreus filing`      | —                     |
| Narrative sections index (Business, Risk Factors, MD\&A, …) | `GET /companies/{id}/filing-notes`                                     | `astreus sections`    | `get_filing_sections` |
| One section as plain text                                   | `GET /companies/{id}/filing-notes/{sectionId}`                         | `astreus section`     | `get_section_text`    |
| Note tables index — families, gate verdicts, held tables    | `GET /companies/{id}/filing-notes/tables`                              | `astreus note-tables` | —                     |
| One note table as filed, cell by cell with evidence         | `GET /companies/{id}/filing-notes/tables/{tableId}`                    | `astreus note-table`  | —                     |
| A note family as a time series across filings               | `GET /companies/{id}/filing-notes/series?family=`                      | `astreus note-series` | —                     |

## Investor presentations — [page](/investor-presentations)

| Dataset                        | REST                                                                     | `astreus`               | MCP tool              |
| ------------------------------ | ------------------------------------------------------------------------ | ----------------------- | --------------------- |
| Decks, newest first            | `GET /companies/{id}/presentations`                                      | `astreus presentations` | —                     |
| One slide as an image (public) | `GET /companies/{id}/presentations/{presentationId}/pages/{page}`        | `astreus deck-page`     | —                     |
| Numbers read from decks        | segment blocks and `kpim::` rows in `/segment-revenue` and `/financials` | `astreus segments`      | `get_segment_revenue` |

## Transcripts & guidance — [page](/transcripts-and-guidance)

| Dataset                                                                | REST                                                             | `astreus`                                 | MCP tool             |
| ---------------------------------------------------------------------- | ---------------------------------------------------------------- | ----------------------------------------- | -------------------- |
| Transcript index                                                       | `GET /companies/{id}/transcripts`                                | `astreus transcripts`                     | `list_transcripts`   |
| Transcript text · webcast audio                                        | `GET …/transcripts/{transcriptId}?date=` · `…/audio`             | `astreus transcript`                      | `get_transcript`     |
| Full-text search over every transcript · counts by quarter and company | `GET /transcripts/search` · `/transcripts/search/summary`        | `astreus transcript-search` (`--summary`) | `search_transcripts` |
| Where other companies name this one on their calls                     | `GET /companies/{id}/mentioned-by` (+ `/summary`)                | `astreus mentioned-by` (`--summary`)      | `get_mentioned_by`   |
| Span-anchored observations on a call                                   | `GET …/transcripts/{transcriptId}/annotations`                   | `astreus transcript --annotations`        | `get_transcript`     |
| Company observations (all sources)                                     | `GET /companies/{id}/observations`                               | `astreus observations`                    | —                    |
| Open guidance commitments · resolved-guidance scorecard                | `GET /companies/{id}/earnings/promises` · `…/earnings/scorecard` | `astreus guidance`                        | `get_guidance`       |
| Earnings overview                                                      | `GET /companies/{id}/earnings/overview`                          | `astreus earnings`                        | —                    |
| Company scorecard · signals                                            | `GET /companies/{id}/scorecard` · `…/signals`                    | `astreus scorecard` · `astreus signals`   | —                    |
| Scored earnings events · executive leaderboard                         | `GET /scorecards/events` · `GET /scorecards/executives`          | `astreus scorecards`                      | —                    |

## Events & news — [page](/events-and-news)

| Dataset                                                           | REST                                                                                                                     | `astreus`                | MCP tool         |
| ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | ------------------------ | ---------------- |
| A company's 8-K events, typed by family                           | `GET /companies/{id}/events`                                                                                             | `astreus events`         | `get_events`     |
| One 8-K item's text                                               | `GET /companies/{id}/events/{accession}?item=`                                                                           | `astreus event`          | `get_event_text` |
| Market-wide wire (searchable) · latest headlines                  | `GET /events/wire` · `GET /events/latest`                                                                                | `astreus wire`           | `get_events`     |
| Intraday news tape, stories, search, topics, sources, live stream | `GET /news/feed` · `/news/items/{id}` · `/news/search` · `/news/top` · `/news/topics` · `/news/sources` · `/news/stream` | `astreus news`           | `get_news`       |
| One company's news tape                                           | `GET /companies/{id}/news`                                                                                               | `astreus news --company` | `get_news`       |

## Ownership & people — [page](/ownership-and-people)

| Dataset                                                      | REST                                                               | `astreus`                           | MCP tool |
| ------------------------------------------------------------ | ------------------------------------------------------------------ | ----------------------------------- | -------- |
| 13F holders and insider summary                              | `GET /companies/{id}/ownership`                                    | `astreus ownership`                 | —        |
| Insider transactions (Forms 3/4/5)                           | `GET /companies/{id}/ownership/transactions`                       | `astreus ownership --transactions`  | —        |
| Board, management, 8-K leadership changes, shareholder votes | `GET /companies/{id}/management`                                   | `astreus management`                | —        |
| People registry · person profile · photo · transactions      | `GET /people` · `GET /people/{cik}` · `…/photo` · `…/transactions` | `astreus people` · `astreus person` | —        |

## Macro & markets — [page](/macro-and-markets)

| Dataset                                                                                   | REST                                                                                                           | `astreus`                                                 | MCP tool           |
| ----------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- | ------------------ |
| Countries · country dashboard · GDP sparklines                                            | `GET /countries` · `GET /countries/{iso}` · `/countries/gdp-sparklines`                                        | `astreus countries` · `astreus macro`                     | `get_macro_series` |
| One point-in-time macro series                                                            | `GET /countries/{iso}/series?key=`                                                                             | `astreus macro US UNEMPLOYMENT_RATE`                      | `get_macro_series` |
| Central-bank text: overview, documents, Beige Book districts, guidance                    | `GET /countries/{iso}/policy-text` · `…/documents` · `…/documents/{documentId}` · `…/districts` · `…/guidance` | `astreus policy`                                          | —                  |
| Government: congress, legislation, executive, regulation, spending, feed · bills by stage | `GET /countries/{iso}/government/{view}` · `…/government/bills/monthly`                                        | `astreus government`                                      | —                  |
| Executive orders · monthly counts                                                         | `GET /countries/{iso}/government/executive-orders` (+ `/monthly`)                                              | `astreus executive-orders`                                | —                  |
| Office holders · changes and pending nominations · the leader's schedule                  | `GET /countries/{iso}/officials` (+ `/changes`, `/schedule`)                                                   | `astreus officials`                                       | —                  |
| Daily prices                                                                              | `GET /companies/{id}/prices?range=`                                                                            | `astreus prices`                                          | —                  |
| Benchmarks · commodities & compute instruments                                            | `GET /indices` · `GET /commodities` (+ `/{symbol}`, `/{symbol}/prices`, `/{symbol}/mentions`)                  | `astreus indices` · `astreus commodities`                 | —                  |
| Commodity fundamentals (inventories, production, storage)                                 | `GET /commodities/fundamentals?asset_class=`                                                                   | `astreus commodities --fundamentals`                      | —                  |
| A company's compute exposure                                                              | `GET /companies/{id}/compute`                                                                                  | `astreus compute`                                         | —                  |
| Correlation and charting over any series                                                  | `POST /correlation/run` · `GET /correlation/catalog` · `POST /charting/series`                                 | `astreus correlate` · `astreus catalog` · `astreus chart` | —                  |

## Intelligence — [page](/intelligence)

| Dataset                                        | REST                                                                              | `astreus`                                           | MCP tool                 |
| ---------------------------------------------- | --------------------------------------------------------------------------------- | --------------------------------------------------- | ------------------------ |
| Narrative pulse · narratives · filter options  | `GET /intelligence/pulse` · `GET /intelligence/narratives` (+ `/{id}`, `/facets`) | `astreus pulse` · `astreus narratives` (`--facets`) | —                        |
| Company intelligence, claims, themes, presence | `GET /intelligence/company/{id}` (+ `/claims`, `/themes`, `/presence`)            | `astreus intel`                                     | —                        |
| Validated causal claim graph · edge evidence   | `GET /intelligence/graph` · `GET /intelligence/graph/edges/{edgeId}`              | `astreus graph` · `astreus edge`                    | `get_intelligence_graph` |
| Shock propagation through the graph            | `POST /intelligence/simulate`                                                     | `astreus simulate`                                  | `simulate_shock`         |

## Account

| Dataset                            | REST                                     | `astreus`                          | MCP tool |
| ---------------------------------- | ---------------------------------------- | ---------------------------------- | -------- |
| Who am I: plan, limits, live usage | `GET /me`                                | `astreus me`                       | —        |
| Health · headline counts (public)  | `GET /api/health` · `GET /landing/stats` | `astreus health` · `astreus stats` | —        |

<Tip>
  Nothing on the MCP side reaches account, key or billing routes — by design. See
  [MCP server](/mcp-server).
</Tip>
