Skip to main content

Macro, point-in-time

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

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

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 accepts the same vocabulary as stock:NVDA, macro:UNEMPLOYMENT_RATE, fundamental:NVDA:revenue, index:SPY, commodity:H100.