Single country's S124 historical timeseries (stock + flow)

GET

/api/v1/ecb/shs/by-country/{slug}

Last modified:2026-05-10 09:22:39

Maintainer:Not configured

OperationId:ecb_shs_by_country_slug

Full historical S124 debt-holding timeseries for one country, split between stock observations (closing-balance positions) and flow observations (quarterly transactions). Slug is 2-char lowercase: at, de, fr, lu, ie etc. for euro-area members; u2 for the euro-area aggregate. Both timeseries are sorted by period descending (latest first). Stock and flow are reported separately because flow excludes valuation effects.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Path Params

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200

application/json

Single country's full S124 timeseries.

Bodyapplication/json

Example

{
    "data": {
        "country": "LU",
        "name": "Luxembourg",
        "stock_history_length": 0,
        "flow_history_length": 0,
        "stock_history": [
            {
                "period": "2025-Q4",
                "value_eur_mn": 0,
                "instrument": "debt",
                "stock_flow": "stock"
            }
        ],
        "flow_history": [
            {
                "period": "2025-Q4",
                "value_eur_mn": 0,
                "instrument": "debt",
                "stock_flow": "stock"
            }
        ]
    },
    "meta": {
        "endpoint": "/api/v1/fred/us/cpi",
        "data_time": "2026-04-16T14:30:00Z",
        "response_time": "2026-04-16T14:30:12Z",
        "provider": "Sugra API v1.0.1",
        "source": "string",
        "fallback_used": true,
        "fallback_chain": [
            "string"
        ],
        "cached": true
    }
}

🟠401

🟠422

🟠429

🔴503

Modified at 2026-05-10 09:22:39

Top net buyers/sellers from S124 transaction-flow data

Latest debt-holdings snapshot for ONE NBFI sector