---
title: "Funds holding a stock"
method: GET
path: "/api/v1/tickers/{symbol}/holders"
tags: ["AlphaYou"]
---

# Funds holding a stock

`GET /api/v1/tickers/{symbol}/holders`

## Request

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

Which tracked funds list one stock in their newest Form 13F, biggest position first, with the share change against each fund's previous filing. Only the funds in the funds list, not every institution, and none found does not prove nobody holds it. Pages with nextCursor.

Plans: Pro.

## Path parameters

- `symbol` 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)
