# Quickstart

A section of the TickerInside API reference, https://tickerinside.com/api/#quickstart, with data through 2026-10-16. Contents of the reference, each section and endpoint as a file: https://tickerinside.com/api/sections/index.md. The whole reference as Markdown: https://tickerinside.com/api/index.md

- Base URL: https://tickerinside.com/api/v1
- Authentication: none. No key, no account, no per-user quota.
- Format: JSON over HTTPS, UTF-8, CORS open to any origin.
- Updates: each weekday night. The build starts at 22:00 UTC and is due by 02:00 UTC; `built_at` in /api/v1/status.json gives the time of the last one. Files are cached five minutes and answer `304` to `If-None-Match`.

1. Request a file: which ETFs hold Nvidia. Tickers go in the path in lower case.

```sh
curl https://tickerinside.com/api/v1/sec/nvda.json
```

2. Read the answer. `holders` lists the funds read from their issuers' own files, heaviest first, as fund, weight in percent and the date of that fund's file. `holders_sec_nport` adds the funds known from SEC filings, dated to the quarter end each filing describes. A security listed outside the US has a key of its own with its market (7203.JP is Toyota in Tokyo) and no stock file: https://tickerinside.com/api/v1/sec/7203.jp.json answers with `coverage` `holders_only`, from the shard of its first character. How keys are written is under "How holdings are keyed", in Where the data comes from.

```json
{
  "ticker": "NVDA",
  "name": "Nvidia",
  "…": "24 more fields",
  "held_by": 160,
  "heaviest": ["GXPT", 19.88],
  "held_by_sec_nport": 587,
  "holders": [
    ["GXPT", 19.88, "2026-10-16"],
    ["IYW", 16.5999, "2026-10-15"],
    ["TOPT", 15.6462, "2026-10-15"],
    "… 157 more"
  ],
  "holders_sec_nport": [
    ["SMHX", 18.5624, "2026-06-30"],
    ["SMH", 17.5486, "2026-06-30"],
    "… 585 more"
  ],
  "…": "1 more field",
  "left_out": [],
  "…": "19 more fields"
}
```

3. Show the date and the source. Print `cite_as` under any figure you show. Credit TickerInside with a link to the page the figure comes from (`cite_as` gives it) wherever the medium allows a link, and by name where it does not. How you mark the link is up to you; `cite_html` is that link, ready to paste.

```text
TickerInside, Nvidia (NVDA), holders from each covered fund's own file and from SEC Form N-PORT filings, each dated, prices through 2026-10-16, https://tickerinside.com/stock/nvda/, CC BY 4.0
```