Fama-French international country portfolio returns

GET

/api/v1/fama-french/country-portfolio

Last modified:2026-07-19 17:02:27

Maintainer:Not configured

OperationId:fama_french_country_portfolio

Single-country sorted-portfolio data for 21 developed markets (Austria, Australia, Belgium, Canada, Denmark, Finland, France, Germany, Hong Kong, Ireland, Italy, Japan, Malaysia, Netherlands, New Zealand, Norway, Singapore, Spain, Sweden, Switzerland, United Kingdom) from the Ken French Data Library. measure: usd / local (value-weighted returns) or ratios (annual B/M, E/P, CE/P, Yld valuation ratios). frequency: monthly / annual (forced annual for ratios). dividends: include (true) or exclude (false) dividends. required: portfolios where firms have all four data items (true) or not (false). See /fama-french/portfolio-catalog for valid country labels.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

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

Query Params

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://sugra.ai/api/v1/fama-french/country-portfolio?country=united_kingdom&measure=usd&frequency=monthly&dividends=true&required=true&limit=60' \
--header 'x-api-key: <api-key>'

Responses

🟢200OK

application/json

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

Bodyapplication/json

Example

{
    "data": {
        "property1": "string",
        "property2": "string"
    },
    "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",
        "attribution": "string",
        "fallback_used": true,
        "fallback_chain": [
            "string"
        ],
        "cached": true,
        "stale": true
    }
}

🟠401Unauthorized

🟠422Parameter Error

🟠429

🔴503Service Unavailable

Modified at 2026-07-19 17:02:27

Fama-French NYSE breakpoints

Fama-French international index portfolio returns