Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.macrobymark.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Welcome to Macro by Mark

Macro by Mark is a curated macroeconomic data API that gives developers, quants, and data scientists a single, consistent interface to time-series data from central banks, statistical agencies, and international organizations. Instead of stitching together a dozen provider SDKs, normalizing incompatible date formats, and chasing broken download links, you make one authenticated HTTP call and get clean, structured JSON back — every time.

​
What you can do

Search indicators

Full-text search across thousands of macroeconomic series — GDP, inflation, employment, trade, and more.

Fetch observations

Retrieve time-series data with optional date-range filtering, unit transformations (level, %, YoY), and vintage selection.

Track releases

Build economic calendars and schedule data-refresh pipelines using upcoming and historical release schedules.

Explore vintages

Access point-in-time snapshots of data exactly as they were published — critical for real-time backtesting.

​
Who is this for?

AudiencePrimary use case
Quantitative researchersBacktesting macro strategies with point-in-time data
Data engineersBuilding automated ETL pipelines that stay in sync with source releases
Product teamsEmbedding live economic indicators in dashboards and apps
Economists & analystsQuick, ad-hoc exploration of cross-country macro data

​
Data coverage

Macro by Mark aggregates data from leading providers including:
  • FRED (Federal Reserve Bank of St. Louis) — 800,000+ US economic series
  • World Bank — Global development indicators
  • OECD — Standardized cross-country statistics
  • BLS — US Bureau of Labor Statistics
  • Eurostat — European statistical data
  • IMF — International financial statistics
See the Providers page for the full coverage table and data freshness SLAs.

​
Quick start

  1. Get an API key from your dashboard.
  2. Make your first request:
curl -G https://api.macrobymark.com/v1/indicators/search \
  --data-urlencode "q=CPI" \
  -H "X-API-Key: YOUR_API_KEY"
  1. Explore the full API Reference.