# Astreus

> Astreus is a financial data terminal that turns the world's unstructured
> financial disclosure into structured, traceable data. It reads what
> companies, exchanges and central banks publish — annual and interim
> reports, SEC filings, results announcements, investor presentations,
> earnings calls, 8-Ks, regulator notices and policy text — across the United
> States, the Gulf (Tadawul, DFM, ADX, Boursa Kuwait, QSE), Japan, Taiwan,
> Korea, the UK and Europe, and serves it as data a program can trust:
> standardized financial statements, segments and KPIs, the tables inside the
> notes, filing sections, investor decks page by page, transcripts and audio,
> span-anchored observations, guidance scored against outcomes, 8-K events,
> an attributed news tape, insider and 13F ownership, a people registry,
> macro series (the current vintage) and central-bank text, and a validated causal claim
> graph. Every number carries the filing, page or
> passage it came from, and nothing is served until it passes per-company
> validation gates. Nothing here is investment advice.

## What is covered — ask, don't assume

- GET https://astreus.ai/api/v1/landing/coverage (no key) — the live
  inventory: every market served with its exchanges, company count, earliest
  period held, completeness score, and periods held per data type (statements,
  segments & KPIs, documents, filing notes, earnings releases, transcripts, audio,
  investor decks, 13F). Universe totals for filings, facts, prices, macro,
  transcripts, observations, guidance, narratives. The MCP tool is `get_coverage`;
  the CLI command is `astreus coverage`; the human page is
  https://doc.astreus.ai/coverage.

## Using Astreus

- [Terminal](https://astreus.ai/terminal): the product — companies, macro, events, people, intelligence
- [Documentation](https://doc.astreus.ai): guides + interactive API reference (in-app fallback: https://astreus.ai/docs); the data catalog at https://doc.astreus.ai/data-catalog maps every dataset to its endpoint, CLI command and MCP tool
- [OpenAPI](https://astreus.ai/openapi.json): the full HTTP API contract (OpenAPI 3.1)
- [CLI](https://doc.astreus.ai/cli): `npm i -g astreus-cli` — every endpoint as an `astreus` command, `--json` for verbatim payloads, citations under every number
- [Doomsday Clock](https://astreus.ai/doomsday-clock): a public risk dashboard
- [Terms](https://astreus.ai/terms) · [Privacy](https://astreus.ai/privacy)

## API quick reference

All data endpoints live under https://astreus.ai/api/v1 and
return JSON. `id` is a ticker (NVDA), a numeric SEC CIK, or a platform key
for a non-SEC issuer (XSAU000001 = Almarai on Tadawul; XDFM000002 = DEWA on
DFM). Coverage spans SEC registrants plus Tadawul, DFM, ADX, Boursa Kuwait,
QSE, TSE, TWSE, KRX and European exchanges; `GET /companies?country=SA`
browses a market and returns per-country counts.

- GET /api/v1/landing/stats — headline counts, no auth
- GET /api/v1/landing/coverage — the full coverage inventory per market and data type, no auth
- GET /api/v1/search?q=nvidia — companies, macro series, countries
- GET /api/v1/companies/{id} — profile, latest filing, quote, key metrics, accounting bases
- GET /api/v1/companies/{id}/financials?period_type=quarterly — standardized statements, ratios, segments & KPIs (latest restated; reporting_basis=as_reported = cumulative year-to-date quarters)
- GET /api/v1/companies/{id}/financials/as-filed?statement=income_statement&vintage=original — the statement as the company printed it (format=csv|xlsx to download)
- GET /api/v1/companies/{id}/fact-source?statement=income_statement&key=std:revenue&end_date=2024-10-27&period_type=quarterly — the fact and filing behind a cell (keys: std:*, XBRL tags, seg::…, kpi::…)
- GET /api/v1/companies/{id}/segment-revenue · /regional-revenue — latest revenue breakdown with its source filing or deck slide
- GET /api/v1/companies/{id}/filing-notes · /filing-notes/{sectionId} · /filing-notes/tables · /filing-notes/tables/{tableId} · /filing-notes/series?family= — filing sections as text; note tables as gated grids and time series
- GET /api/v1/companies/{id}/presentations · /presentations/{presentationId}/pages/{page} — investor decks and slide images
- GET /api/v1/companies/{id}/filings · /events · /transcripts · /ownership · /management · /news
- GET /api/v1/companies/{id}/earnings/promises · /earnings/scorecard — guidance commitments and whether they were kept
- GET /api/v1/countries/{iso}/series?key=UNEMPLOYMENT_RATE — one macro series' history, the current vintage (latest published value per period; no as-of read)
- GET /api/v1/events/wire?q=acquisition&family=mna — 8-K headline wire
- GET /api/v1/news/feed — the attributed intraday news tape (SSE at /news/stream)

Authentication: `public` endpoints need nothing. Everything else takes an
API key — create one on the Developers page
(https://astreus.ai/developers) and send it as
`X-API-KEY: pk_live_...` (or `Authorization: Bearer pk_live_...`).

Plans and limits (fixed UTC windows): Free — 30 req/min, 250 req/day, no card.
Build — 300 req/min, 100,000 req/month. Scale — custom. Build and Scale are
set up with sales, not self-serve: https://astreus.ai/contact.
Responses carry RateLimit-* and X-Quota-* headers; a 429 carries
`Retry-After` and code rate_limited or quota_exceeded.

## For agents

- Agent mode: https://astreus.ai/agent is the server-rendered landing page for agents. Fetch https://astreus.ai/agent.json for the same versioned product manifest as plain JSON: interfaces, authentication, capabilities, research workflows, data semantics and current alerting boundaries. Both are public; protected data endpoints keep their existing authentication.

- MCP: a hosted server at https://astreus.ai/api/mcp (Streamable HTTP; auth = API key as Bearer/X-API-KEY, or OAuth 2.1 with dynamic registration + PKCE so connector UIs work by pasting the URL) and a local stdio server via `astreus mcp` — shared read-only data tools (coverage inventory, search, company, financials, segments, fact-source citations, filings + section text, 8-K events, news, transcripts, guidance, point-in-time macro, market themes). Docs: https://doc.astreus.ai/mcp-server
- In a terminal, prefer the CLI: `astreus --json <command>` returns the same payloads with stable exit codes (0 ok · 1 unexpected · 2 usage · 3 auth · 4 payment · 5 not found · 6 rate limited · 7 server), and `astreus transcript` / `astreus event` resolve the transcript date and 8-K item for you. `astreus llms --skill` prints skill.md.
- [agents.md](https://astreus.ai/agents.md): what an agent may do on this site, and the rules
- [skill.md](https://astreus.ai/skill.md): a playbook for answering financial questions with Astreus data, with citations
- [mcp.json](https://astreus.ai/.well-known/mcp.json): MCP discovery manifest (connect strings inside)

## Data provenance

Company financials come from SEC EDGAR XBRL, reconciled against the SEC
companyfacts API and gated by per-company invariant batteries before they are
served. Macro data is FRED/ALFRED with full revision vintages. Transcripts
come from licensed providers. Every served number can be traced to a filing
and fact id through the API.