Quickstart

Create an API key

Sign in at astreus.ai (the Free plan needs no card), open astreus.ai/developers, and create a key. It is shown once — store it immediately.

Make a request

Send the key as X-API-KEY on every call:

curl "https://astreus.ai/api/v1/companies/NVDA" \
  -H "X-API-KEY: pk_live_YOUR_KEY"

Pull real data

Standardized quarterly financials for the newest four quarters: every statement and every line, about 50 KB. Raise limit (up to 200 periods) when you need more history:

curl "https://astreus.ai/api/v1/companies/NVDA/financials?period_type=quarterly&limit=4" \
  -H "X-API-KEY: pk_live_YOUR_KEY"

And the exact XBRL fact and filing behind one cell (the line key is std:revenue, the column is its period end):

curl "https://astreus.ai/api/v1/companies/NVDA/fact-source?statement=income_statement&key=std:revenue&end_date=2024-10-27&period_type=quarterly" \
  -H "X-API-KEY: pk_live_YOUR_KEY"

Call the API from a server, a script or an agent: /api/v1 sends no CORS headers, so a browser page on another origin cannot call it (see Authentication).

Identifiers

{id} accepts three forms:

Form	Example	Use it for
Ticker symbol	`NVDA`	US (SEC) issuers. A bare ticker always resolves to the SEC registrant, so `LULU` is lululemon, not Lulu Retail on ADX.
Numeric SEC CIK	`1045810`	The stable choice for a US issuer that has changed symbols. Zero-padding is optional.
Platform key	`XSAU000001`, `XDFM000002`, `XJPX000018`	Every non-SEC issuer — Tadawul, DFM, ADX, Boursa Kuwait, QSE, TSE, TWSE, KRX, European exchanges. The key is the `cik` field of the company payload.

Resolve names with GET /api/v1/search?q=almarai, or browse a market with GET /api/v1/companies?country=SA. Details and the full market list are on the Coverage page.

Watch the headers

Every response tells you where you stand:

Header	Meaning
`RateLimit-Limit` / `RateLimit-Remaining` / `RateLimit-Reset`	Per-minute window
`X-Quota-Limit` / `X-Quota-Remaining` / `X-Quota-Reset`	Monthly quota (quota-carrying plans)
`X-Billing-Source` / `X-Credits-Remaining-USD`	Present when a request was paid from prepaid credits
`Retry-After`	On a 429 — wait this many seconds

Where next

Financial statements — the payload shape, period columns, bases and vintages.
Data catalog — every dataset with its endpoint, astreus command and MCP tool.
Guide: trace a number to its filing — the citation loop, end to end.

Getting started

Coverage

Data

Concepts

Guides

For AI agents

Identifiers

Watch the headers

Where next

​Identifiers

​Watch the headers

​Where next

Identifiers

Watch the headers

Where next