Single country's IVF historical timeseries (4 sectors x 6 items)
Full historical IVF timeseries for one country across all 4 sectors x 6 items, split between stock observations (data_type=1, closing balances) and flow observations (data_type=4, monthly transactions). Slug is 2-char lowercase: at, de, fr, lu, ie etc. for euro-area members; u2 for the euro-area aggregate (mirror SHS - U2 is accessible via this endpoint, only excluded from /top and /changes and /flows leaderboards). ?include=composition adds asset-mix breakdown for sector=T0 (all funds) at latest period: debt_pct + direct_equity_pct + fund_shares_pct + cash_pct of L30 NAV + leverage_ratio (T00/L30). When NAV is null or non-positive, percentages = null.
Path parameters
Query parameters
Optional add-on: composition adds asset-mix breakdown.
Optional add-on: composition adds asset-mix breakdown.
Reserved for future use; currently does not affect output.
Reserved for future use; currently does not affect output.
Response
Single country's full IVF timeseries + optional composition.
Example response
{
"data": {
"country": "LU",
"name": "Luxembourg",
"stock_history": [
{
"period": "2025-12",
"sector": "TC",
"item": "L30",
"data_type": "1"
}
],
"flow_history": [
{
"period": "2025-12",
"sector": "TC",
"item": "L30",
"data_type": "1"
}
],
"composition_latest": {
"period": "2025-12",
"denominator": "L30 NAV",
"debt_pct": 36.13,
"leverage_ratio": 1.094
}
},
"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": "sugra_crypto",
"attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
"fallback_chain": [
"sugra_crypto",
"sugra_finance"
]
}
}