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

# Macro & markets

> Point-in-time macro series, central-bank text, prices, benchmarks, commodities and compute instruments.

## Macro, point-in-time

```
GET /api/v1/countries
GET /api/v1/countries/{iso}
GET /api/v1/countries/{iso}/series?key=UNEMPLOYMENT_RATE
GET /api/v1/countries/gdp-sparklines?codes=US,JP,SA
```

Macro data lives in a **bitemporal** cube: every observation carries the period it
describes and the interval during which that value was the known one. A series read is
therefore the full current history, with revisions tracked separately — a backtest against
this API never sees a revision before it was published.

`countries` lists the economies with coverage; `countries/{iso}` is the dashboard for one
(indicators, latest values and the series keys available); `series` returns one series'
history by `key` — the upper-case indicator code from the dashboard or from `search`
(`UNEMPLOYMENT_RATE`, `CPI`, …). Series are keyed by indicator × geography, so the same
`key` compares like with like across countries.

```
GET /api/v1/countries/{iso}/policy-text
GET /api/v1/countries/{iso}/policy-text/documents?group=&docType=&year=&speaker=&district=&search=&analyzedOnly=1&limit=50&offset=0
GET /api/v1/countries/{iso}/policy-text/documents/{documentId}
GET /api/v1/countries/{iso}/policy-text/districts?limit=
GET /api/v1/countries/{iso}/policy-text/guidance?limit=
```

The central-bank text corpus — for the United States, FOMC statements, minutes, press
conferences, speeches and the Beige Book — with a document index, full document text, the
Beige Book broken down by district, and the forward-guidance observations extracted from
the text. `policy-text` returns `available: false` for a country without a corpus.

## Markets

```
GET /api/v1/companies/{id}/prices?range=1Y
GET /api/v1/companies/{id}/dividends
GET /api/v1/companies/{id}/capital-structure
GET /api/v1/companies/{id}/calendar
```

Daily OHLCV bars for the listed security (`range` is `1M`, `3M`, `6M`, `YTD`, `1Y`, `2Y`,
`5Y` or `ALL`, default `1Y`; the payload names its `currency` and `symbol`), the dividend
history, the capital structure (share classes, debt and mezzanine instruments), and the
earnings and filing calendar with the fiscal year end.

```
GET /api/v1/indices                       GET /api/v1/indices/{symbol}          GET /api/v1/indices/{symbol}/prices?range=
GET /api/v1/commodities                   GET /api/v1/commodities/{symbol}      GET /api/v1/commodities/{symbol}/prices?range=
GET /api/v1/commodities/{symbol}/mentions
GET /api/v1/companies/{id}/compute
```

Benchmark indices and sector ETFs; commodity and compute instruments — including GPU
rental prices — each with its spec and venues, daily bars, and the earnings-call passages
that mention it. `compute` returns a company's compute and GPU exposure for hyperscalers
and neoclouds (404 for companies outside that universe).

## Correlation and charting

```
GET  /api/v1/correlation/catalog
POST /api/v1/correlation/run
POST /api/v1/charting/series
```

Any series above can be a chart line or a correlation input. `catalog` lists the vocabulary;
`correlation/run` takes `seriesA`, `seriesB`, an optional `control` to partial out, and
`options` (a transformation per series — `none`, `pct_change`, `yoy_pct_change`,
`first_difference`, `log`, `z_score`, `rolling_volatility` — an aggregation — `mean`,
`last`, `sum` — and a date window) and returns the statistics battery with a lag search.
`charting/series` resolves up to eight series descriptors into aligned time series at a
chosen `frequency` (`native`, `daily`, `weekly`, `monthly`, `quarterly`, `annual`).

Series descriptors are typed: `macro`, `company_fundamental`, `stock_price`,
`index_price`, `commodity_price`. The [CLI](/cli#analytics-descriptors) accepts the same
vocabulary as `stock:NVDA`, `macro:UNEMPLOYMENT_RATE`, `fundamental:NVDA:revenue`,
`index:SPY`, `commodity:H100`.