> ## Documentation Index
> Fetch the complete documentation index at: https://docs.secapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Macro Tier-1 Official Sources

> Official-source macro indicators from direct government APIs for 12 countries

SEC API provides allocator-grade macro data from official government sources — not third-party aggregators. Production data is refreshed daily by our scheduled data pipeline at 06:00 UTC.

## Coverage

### Launch Ring (Tier-1) — All Direct Official

| Country    | Series Count | Primary Sources                  | Source Mode      |
| ---------- | ------------ | -------------------------------- | ---------------- |
| **US**     | 32           | FRED/ALFRED, BLS, Census         | direct\_official |
| **China**  | 14           | NBS China, SAFE                  | direct\_official |
| **Japan**  | 10           | BOJ, e-Stat, MOF, Cabinet Office | direct\_official |
| **Taiwan** | 7            | DGBAS, CBC                       | direct\_official |
| **Israel** | 8            | CBS Israel, Bank of Israel       | direct\_official |

### Expansion Ring V1

| Country          | Series Count | Primary Sources                   | Source Mode             |
| ---------------- | ------------ | --------------------------------- | ----------------------- |
| **Canada**       | 4            | Statistics Canada, Bank of Canada | direct\_official        |
| **UK**           | 4            | ONS, Bank of England              | direct\_official        |
| **Eurozone**     | 4            | Eurostat, ECB                     | direct\_official        |
| **South Korea**  | 4            | KOSIS, Bank of Korea ECOS         | direct\_official        |
| **Brazil**       | 4            | IBGE SIDRA, BCB SGS               | direct\_official        |
| **India**        | 3            | MOSPI, data.gov.in                | official\_via\_dbnomics |
| **Saudi Arabia** | 3            | GASTAT                            | official\_via\_dbnomics |

## Source Modes

* **`direct_official`**: Primary runtime fetches directly from the official government agency API or download endpoint. This is the target for all indicators.
* **`official_bridge`**: Official agency data accessed through DBnomics or another bridge. Not acceptable for strict direct-source completion.
* **`fallback_harmonized`**: Non-primary harmonized source (e.g., IMF IFS, World Bank). Not acceptable for strict direct-source completion.

### DBnomics Policy

DBnomics is allowed only as a documented runtime fallback after a direct official API attempt fails. It must be visible in observation metadata as a fallback, not as primary provenance.

## Endpoints

### Search Indicators

```bash theme={null}
curl "https://api.secapi.ai/v1/macro/search?q=gdp" \
  -H "x-api-key: $SECAPI_API_KEY"
```

### Get Observations

```bash theme={null}
curl "https://api.secapi.ai/v1/macro/indicators?series=US_GDP&limit=10" \
  -H "x-api-key: $SECAPI_API_KEY"
```

### Release Calendar

```bash theme={null}
curl "https://api.secapi.ai/v1/macro/calendar" \
  -H "x-api-key: $SECAPI_API_KEY"
```

### High-Signal Pack (Country Bundle)

```bash theme={null}
curl "https://api.secapi.ai/v1/macro/high-signal-pack?country=CN" \
  -H "x-api-key: $SECAPI_API_KEY"
```

Returns the curated set of indicators for a country with source provenance and revision metadata.

### Macro Regimes

```bash theme={null}
curl "https://api.secapi.ai/v1/macro/regimes" \
  -H "x-api-key: $SECAPI_API_KEY"
```

Returns current macro regime classification per country (expansion, contraction, recovery, overheating).

## Production Ownership

Our scheduled data pipeline is the sole scheduled production writer for macro data to the read-optimized analytics store. GitHub Actions workflows are read-only validation only.

## Source Provenance

Every observation includes:

* **Source**: The official government agency
* **Revision status**: Whether this is a preliminary, revised, or final release
* **Release calendar**: When the next update is expected
* **Canonicality**: Whether the data was fetched directly from the official source or via a bridge
* **Fallback policy**: DBnomics is used as fallback only when official APIs are unavailable, and is always annotated in metadata