---
title: "One ETF's weekly returns, as Find reads them"
method: GET
path: "/diversify/weekly/{ticker}.json"
---

# One ETF's weekly returns, as Find reads them

`GET /diversify/weekly/{ticker}.json`

## Request

- Base URL: `https://tickerinside.com/api/v1`
- URL: `https://tickerinside.com/api/v1/diversify/weekly/{ticker}.json`
- Auth: none required

The files Find reads, public like every file under /api/v1/. candidates.json is the list: its date, its groups, its rule in words, and each ETF of it with its weekly returns, its breakdown or what it holds, and what its file counts for against the limits of an answer. /api/v1/diversify/weekly/{ticker}.json, in lower case, is one ETF's weekly returns and breakdown, for every ETF with at least 52 weekly returns whose last week is the list's, with its own ranking against the list. An answer of have alone is a sort of these measurements by the published rule, the same list for every portfolio: a ranking can be recomputed from these files alone, as Pearson's correlation of w against the portfolio's weekly returns at its weights.

## Path parameters

- `ticker` string, required

## Response `200`

The file. The example is a real answer, shortened: long lists and maps keep their first entries.

- DiversifyWeekly
  - `t` string, required: Its ticker.
  - `n` string, nullable: Its name.
  - `page` string, nullable: Its page on the site. Null without one.
  - `size` integer, required: What its file counts for against the limits of an answer: a file under /fund/ its length, its compact file under /diversify/funds/ half of that file's, a file under /etf/ a third.
  - `lines` integer, required: How many holdings the overlap reads of it; 0 for an ETF that holds no shares.
  - `l` string, required: Its source layer, as source_layer in its fund file: issuer, sec_nport, sec_nport_bonds, trust_filings and the others.
  - `h` string, nullable: The date of its holdings.
  - `bd` object: For an ETF that holds shares, its breakdown, the one its fund file gives: sectors_pct, no_sector_pct, sector_coverage_pct, sectors_stated, other_funds_pct, mega_cap_tech_pct and countries_pct.
    - `sectors_pct` object
    - `no_sector_pct` number, nullable
    - `sector_coverage_pct` number, nullable
    - `sectors_stated` boolean, nullable
    - `other_funds_pct` number, nullable
    - `mega_cap_tech_pct` number, nullable
    - `countries_pct` object
  - `comp` object[]: For an ETF that holds no shares, what it holds by kind, up to three, each with label and pct of its net assets.
    - `label` string
    - `pct` number, nullable
  - `w` integer[], required: Its weekly returns as whole numbers of 0.0001 (divide by 10,000: 47 is 0.47%), oldest first, ending at end; null for a week without a return.
  - `end` string, nullable, required: The last week of w, the date of the prices.
  - `solo` object: Its own ranking against the list as a one-ETF portfolio, when the list ranks it: list_date, lowest (the 3 of the answer, in order) and rows, every ETF of the list not held as [ticker, weekly correlation, on down weeks, weeks, down weeks], the correlations in hundredths (divide by 100), lowest first before rounding.
    - `list_date` string, required
    - `lowest` string[], required
    - `rows` array[], required
      - unknown[]
        - unknown

## Other responses

- `301`: The address was not written the way the file is: an upper case ticker, a share class written BRK-B or BRK/B, a missing .json, or punctuation at the end. Follow the Location header (curl -L).
- `304`: Not modified: the ETag of your copy, sent in If-None-Match, is still current. Files are cached five minutes.
- `404`: No weekly file for this ticker: it has fewer than 52 weekly returns here, or none, or they end on another week than the list's. Its fund file gives what it holds.
- `503`: The file could not be served just then: retry after a minute. uptime says whether the site fails its own checks.

---

[API](https://skmtc.dev/tickerinside/apis/tickerinside-api.md) · [All operations](https://skmtc.dev/tickerinside/apis/tickerinside-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tickerinside/apis/tickerinside-api/revisions/66a3e0d66a02?raw)