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.
Data Providers
Macro by Mark aggregates macroeconomic data from the world’s most trusted statistical agencies and repositories. The table below summarizes coverage and the maximum expected lag between a source publication and the data being available via the API.Coverage table
| Provider | Code | Region | Series count | Update frequency | Freshness SLA |
|---|---|---|---|---|---|
| Federal Reserve Bank of St. Louis | FRED | United States | ~800,000 | Continuous | ≤ 1 hour |
| Bureau of Labor Statistics | BLS | United States | ~100,000 | Monthly/Quarterly | ≤ 2 hours |
| Bureau of Economic Analysis | BEA | United States | ~50,000 | Monthly/Quarterly | ≤ 2 hours |
| World Bank Open Data | WORLDBANK | Global | ~16,000 | Annual | ≤ 24 hours |
| OECD Statistics | OECD | OECD members | ~900,000 | Monthly/Quarterly | ≤ 4 hours |
| International Monetary Fund | IMF | Global | ~40,000 | Monthly/Quarterly | ≤ 4 hours |
| Eurostat | EUROSTAT | European Union | ~50,000 | Monthly/Quarterly | ≤ 4 hours |
| European Central Bank | ECB | Euro Area | ~30,000 | Daily/Monthly | ≤ 2 hours |
Freshness SLAs explained
Freshness SLA is the maximum time between a data release going live on the source provider’s platform and the updated observations being available via the Macro by Mark API.SLAs apply under normal operating conditions. Occasional delays may occur
during source provider outages or major simultaneous release events (e.g.,
US Jobs Day). Check the status page for
real-time system health.
How freshness is measured
- The source provider publishes new data (e.g., FRED updates a series).
- Macro by Mark’s ingestion pipeline detects the change.
- The new observations are validated, normalized, and indexed.
- The data is available via
/indicators/observations.
Vintage availability
Point-in-time vintages are available for providers that publish data revision histories. Coverage details:| Provider | Vintages available | Earliest vintage |
|---|---|---|
FRED | ✅ Yes | 1990-01-01 |
BLS | ✅ Yes | 2000-01-01 |
BEA | ✅ Yes | 2000-01-01 |
OECD | ✅ Yes | 2005-01-01 |
ECB | ✅ Yes | 2004-01-01 |
IMF | ⚠️ Partial | 2010-01-01 |
WORLDBANK | ❌ No | — |
EUROSTAT | ⚠️ Partial | 2008-01-01 |
Requesting new providers
Don’t see a data source you need? Open a provider request or email support@macrobymark.com with:- The provider name and URL
- The series or dataset you need
- Your intended use case
Data attribution and licensing
When using Macro by Mark data in published work, please attribute the original source provider as indicated in theprovider and source_url
fields returned by the metadata endpoint.
Each provider’s own terms of use apply to their respective data.