Sign in

v5

OpenAPI 3.1.0Proprietary2026-08-031,5423,1505.5 MB
Finance

Fama-French international index portfolio returns

Regional-index sorted-portfolio data for 6 indices (uk, scandinavia, europe, europe_ex_uk, asia_pacific, all) from the Ken French Data Library. Same measure / frequency / dividends / required selectors as /country-portfolio. See /fama-french/portfolio-catalog for valid index labels.

get/api/v1/fama-french/international-index

Query parameters

indexstring

Index label.

Index label.

measurestring

usd, local, ratios

usd, local, ratios

frequencystring

monthly, annual (forced annual for ratios)

monthly, annual (forced annual for ratios)

dividendsboolean

Include dividends in returns.

Include dividends in returns.

requiredboolean

Require all four data items per portfolio.

Require all four data items per portfolio.

limitinteger

Number of most-recent periods.

Number of most-recent periods.

Response

Wide records: one row per period with the flattened formation columns.

dataStubData required

Response shape not yet documented; fields are returned as-is.

Example response

{
  "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"
    ]
  }
}