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

> Coverage table, data freshness SLAs, and attribution for all Macro by Mark data sources.

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

<Note>
  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](https://status.macrobymark.com) for
  real-time system health.
</Note>

### How freshness is measured

1. The source provider publishes new data (e.g., FRED updates a series).
2. Macro by Mark's ingestion pipeline detects the change.
3. The new observations are validated, normalized, and indexed.
4. The data is available via `/indicators/observations`.

The SLA clock starts at step 1 and ends at step 4.

## 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](https://macrobymark.com/requests)
or email [support@macrobymark.com](mailto:support@macrobymark.com) with:

* The provider name and URL
* The series or dataset you need
* Your intended use case

We evaluate new provider requests on a rolling basis, prioritizing by demand.

## Data attribution and licensing

When using Macro by Mark data in published work, please attribute the
**original source provider** as indicated in the `provider` and `source_url`
fields returned by the [metadata endpoint](/api-reference/indicators/metadata).
Each provider's own terms of use apply to their respective data.