---
title: "Fund holdings"
method: GET
path: "/api/v1/funds/{cik}/holdings"
tags: ["AlphaYou"]
---

# Fund holdings

`GET /api/v1/funds/{cik}/holdings`

## Request

- Base URL: `https://api.alphayou.net`
- URL: `https://api.alphayou.net/api/v1/funds/{cik}/holdings`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

One tracked fund's newest Form 13F book, biggest position first: issuer, CUSIP, ticker where mapped, value, shares and the share change against the fund's previous filing. Long US-listed positions only, as of a quarter end and filed up to 45 days later, so not the fund's book today. Use a cik from the funds list. Pages with nextCursor.

Plans: Pro.

## Path parameters

- `cik` string, required

## Query parameters

- `limit` string
- `cursor` string

## Response `200`

The requested records.

## Other responses

- `401`: Missing, unrecognised or revoked API key (error key_revoked).
- `403`: This key's plan does not include this endpoint, or the key has been suspended (error key_suspended).
- `404`: Not an endpoint an API key may call.
- `429`: Rate limited. The scope field says which budget ran out: minute, day, account (shared by all of an account's keys), or concurrency (too many calls running at once). Retry-After says when to come back, and X-RateLimit-Remaining reports what is left of today's budget. A call refused for going too fast (the per-minute limit) does not use up the day, so wait for Retry-After and try again.
- `503`: The request budget could not be checked right now. Retry after the number of seconds in Retry-After.

---

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