Finance

Fama-French international index portfolio returns

Changed on

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

Request

  • Base URL: https://sugra.ai
  • URL: https://sugra.ai/api/v1/fama-french/international-index
  • Auth: API key in header x-api-key

Query parameters

indexstring

Index label.

measurestring

usd, local, ratios

frequencystring

monthly, annual (forced annual for ratios)

dividendsboolean

Include dividends in returns.

requiredboolean

Require all four data items per portfolio.

limitinteger

Number of most-recent periods.

Response

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

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",
    "data_age_days": 8.532,
    "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"
    ],
    "stale_since": "2026-09-08T12:00:00Z",
    "period": "2026-Q1",
    "notes": "the UKMTO report behind these counts is dated 2026-08-21 and is 11 days old"
  }
}

Changes