Skip to main content

​
Macro: the current vintage

Macro data is stored bitemporally (every observation keeps the period it describes and when that value was the known one), but the API serves only the current vintage: each period’s latest published value. There is no as-of parameter, so a series read is not what was known on a past date and is not safe for a look-ahead-free backtest. from/to filter the reporting period, not knowledge time. 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. Use view=profile for a bounded country profile and view=catalog with q, category, limit and offset to find its series. Regional and government entity catalogs expose their own series IDs. Both /countries/{iso}/series and /macro/series/{seriesId} accept from, to and limit windows. Preserve the returned window metadata, units, geography, publisher and revision information.
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).

​
Charting

Any series above can be a chart line. catalog lists the vocabulary; charting/series resolves up to eight series descriptors into aligned time series at a chosen frequency (native, daily, weekly, monthly, quarterly, annual), each with a transformation (none, pct_change, yoy_pct_change, first_difference, log, z_score, rolling_volatility) and an aggregation (mean, last, sum). 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.