Country allocation chart

GET/api/fund/chart/countries

Chart-ready geographic allocation over time. Returns one series per top country (by latest quarter weight), with portfolio weight values for each quarter. Countries are ISO 2-letter codes from N-PORT holdings. Periods sorted ascending. Historical depth depends on subscription tier.

Get API key Try it live in the API explorer

Query parameters

symbol string optional min length 1 · max length 10

Fund ticker symbol (ETF or mutual fund). Identify the entity by exactly one of: symbol, cik, cusip, composite_figi, or share_class_figi. At least one is required.

Example: SPY
cik integer optional

SEC Central Index Key (CIK).

Example: 884394
cusip string optional min length 9 · max length 9

CUSIP identifier (9 characters).
composite_figi string optional

Composite OpenFIGI identifier.

Example: BBG000BDTBL9
share_class_figi string optional

Share-class OpenFIGI identifier.
topN integer optional min 1 · max 15 · default 5

Number of top countries to include

Example request

curl 'https://api.stockfit.io/v1/api/fund/chart/countries?symbol=SPY&cik=884394&composite_figi=BBG000BDTBL9' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

Responses

200 OK

Country allocation chart data with periods sorted ascending

Response schema

periods array of string
Quarter-end dates sorted ascending
series array of object
One series per top country, with portfolio weight values (%)
array of:
- name string
- data array of number | null

Example response

{
  "periods": [
    "2025-03-31",
    "2025-06-30",
    "2025-09-30",
    "2025-12-31"
  ],
  "series": [
    {
      "name": "US",
      "data": [
        98.5,
        98.7,
        99.1,
        99.2
      ]
    }
  ]
}

400 Bad Request

Symbol not found or not a fund (ETF or mutual fund)

Response schema

error string
Human-readable error message

Example response

{}

403 Forbidden

Feature not available on current plan

Response schema

error string
Human-readable error message

Example response

{}