# Euro Area Credit Growth & Credit Impulse API
> How fast bank lending to the real economy is expanding, and whether it is accelerating or slowing, read live from the European Central Bank's public Data Portal — no key, nothing stored. Where bank rates are the price of credit, this is the quantity: the annual growth of the loans euro-area banks (MFIs) actually extend to households — total, for house purchase, and for consumption — and to non-financial corporations (businesses). Credit growth is one of the most-watched macro signals because credit booms and busts lead the business cycle and, with a lag, inflation. The growth endpoint returns the latest annual growth rate of each lending category with its reference month and month-on-month change. The impulse endpoint returns the credit impulse — the change in the growth rate over the last six and twelve months — a leading read on whether the credit cycle is turning up (acceleration) or rolling over (deceleration). The series endpoint returns the recent monthly history of any one indicator. This is the euro-area credit-cycle / lending-volume macro cut — distinct from the bank-rate (price of credit), money-supply, policy-rate, yield-curve and FX APIs in the catalogue. All series are euro-area (U2), monthly, annual-growth percent.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/creditgrowth-api/..."
```

## Pricing
- **Free** (Free) — 600 calls/Mo, 2 req/s
- **Starter** ($9/Mo) — 16,500 calls/Mo, 6 req/s
- **Pro** ($29/Mo) — 85,000 calls/Mo, 16 req/s
- **Business** ($68/Mo) — 440,000 calls/Mo, 40 req/s

## Endpoints

### Credit

#### `GET /v1/growth` — Latest annual growth of household & business credit

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/creditgrowth-api/v1/growth"
```

**Response:**
```json
{
    "data": {
        "area": "Euro area",
        "note": "Annual growth of euro-area bank lending by borrower and purpose. change is versus the prior month — accelerating credit is expansionary, decelerating credit is a slowdown signal.",
        "count": 4,
        "credit": [
            {
                "unit": "percent",
                "label": "Loans to households (MFIs), annual growth",
                "change": 0.02,
                "period": "2026-04",
                "indicator": "households_total",
                "growth_pct": 2.94
            },
            {
                "unit": "percent",
                "label": "Lending for house purchase to households, annual growth",
                "change": 0.02,
                "period": "2026-04",
                "indicator": "house_purchase",
                "growth_pct": 2.93
            },
            {
                "unit": "percent",
                "label": "Consumer credit to households, annual growth",
                "change": 0.01,
                "period": "2026-04",
                "indicator": "consumer_credit",
                "growth_pct": 5.25
            },
            {
                "unit": "percent",
                "label": "Loans to non-financial corporations (MFIs), annual growth",
                "change": 0.28,
                "period": "2026-04",
                "indicator": "businesses",
                "growth_pct": 3.46
            }
        ],
        "source": "ECB",
        
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/impulse` — Credit impulse — change in the growth rate

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/creditgrowth-api/v1/impulse"
```

**Response:**
```json
{
    "data": {
        "area": "Euro area",
        "note": "The credit impulse is the change in the annual growth rate: impulse_6m is current growth minus growth six months ago. Positive = the credit cycle is turning up (a leading indicator for activity); negative = rolling over.",
        "count": 4,
        "source": "ECB",
        "impulse": [
            {
                "label": "Loans to households (MFIs), annual growth",
                "period": "2026-04",
                "direction": "accelerating",
                "indicator": "households_total",
                "growth_pct": 2.94,
                "impulse_6m": 0.33,
                "impulse_12m": 1.25
            },
            {
                "label": "Lending for house purchase to households, annual growth",
                "period": "2026-04",
                "direction": "accelerating",
                "indicator": "house_purchase",
                "growth_pct": 2.93,
                "impulse_6m": 0.35,
                "impulse_12m": 1.28
            },
            {
                "label": "Consumer credit to households, annual growth",
                "period": "2026-04",
                "direction": "stable",
                "indicator": "consumer_credit",
                "growth_pct": 5.25,
                "impulse_6m": 0.06,
                "impulse_12m": 1.2
            },
            {
                "label": "Loans to non-financial corporations (MFIs), annual growth",
                "period": "2
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/series` — Recent monthly history of one indicator

**Parameters:**
- `indicator` (query, required, string) — Indicator id Example: `households_total`
- `months` (query, optional, string) — Months of history (1-240, default 24) Example: `24`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/creditgrowth-api/v1/series?indicator=households_total&months=24"
```

**Response:**
```json
{
    "data": {
        "unit": "percent",
        "count": 24,
        "label": "Loans to households (MFIs), annual growth",
        "source": "ECB",
        "history": [
            {
                "value": 0.3035,
                "period": "2024-05"
            },
            {
                "value": 0.3044,
                "period": "2024-06"
            },
            {
                "value": 0.3911,
                "period": "2024-07"
            },
            {
                "value": 0.4924,
                "period": "2024-08"
            },
            {
                "value": 0.582,
                "period": "2024-09"
            },
            {
                "value": 0.4483,
                "period": "2024-10"
            },
            {
                "value": 0.4973,
                "period": "2024-11"
            },
            {
                "value": 0.6811,
                "period": "2024-12"
            },
            {
                "value": 1.2086,
                "period": "2025-01"
            },
            {
                "value": 1.3784,
                "period": "2025-02"
            },
            {
                "value": 1.4518,
                "period": "2025-03"
            },
            {
                "value": 1.6918,
                "period": "2025-04"
            },
            {
                "value": 1.9051,
                "period": "2025-05"
            },
            {
                "value": 2.0824,
        
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Spec

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/creditgrowth-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "note": "growth and impulse take no parameters. series takes indicator=<one of the listed ids> and months=N (1-240, default 24). All series are euro-area (U2), monthly, annual-growth percent. Monthly data is briefly cached to protect the shared upstream.",
        "source": "ECB Data Portal (data-api.ecb.europa.eu, BSI, monthly, live)",
        "service": "creditgrowth-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/growth": "Latest annual growth of household and business credit.",
            "GET /v1/series": "Recent monthly history of one indicator (indicator=households_total, months=24).",
            "GET /v1/impulse": "Credit impulse — change in the growth rate over 6 and 12 months, with direction."
        },
        "indicators": [
            "households_total",
            "house_purchase",
            "consumer_credit",
            "businesses"
        ],
        "description": "Euro-area bank credit growth and credit impulse from the ECB Data Portal (no key, nothing stored). growth returns the latest annual growth of MFI loans to households (total, house purchase, consumer) and to non-financial corporations. impulse returns the credit impulse — the change in the growth rate over 6 and 12 months — a leading read on whether the credit cycle is accelerating or decelerating. series returns the recent monthly history of any one indicator. The euro-area credit-cycle / lending-volume macro cut 
…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/creditgrowth-api
OpenAPI spec: https://www.oanor.com/api/creditgrowth-api/openapi.json
