> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alphayou.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Funds holding a stock

> 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.



## OpenAPI

````yaml https://alphayou.net/openapi.json get /api/v1/tickers/{symbol}/holders
openapi: 3.1.0
info:
  title: AlphaYou API
  version: 1.0.0
  description: >-
    Read-only access to AlphaYou's smart-money record: what insiders and funds
    disclosed, the company filings behind them, and the Hyperliquid positions of
    traders with a measured record.


    Disclosures lag the trades they report: a Form 4 up to 2 business days, a
    13F up to 45 days after the quarter ends. Hyperliquid positions carry the
    time they were observed.


    Plans:

    - Free: 4 tools, 100 requests a day, free.

    - Pro: 11 tools, 50,000 requests a day, $49 a month.


    Create a free key at https://alphayou.net/developers. Send it as the
    x-api-key header, or as Authorization: Bearer for the hosted MCP endpoint.


    Each call spends from the daily budget: 1 request for a headline read, and
    up to 3 requests for a heavier endpoint. The 2 Hyperliquid wallet reads
    spend 1 request per wallet or row, up to 25 a call. Data responses report
    the unit cost in X-RateLimit-Cost, daily units left in
    X-RateLimit-Remaining, and midnight UTC reset in X-RateLimit-Reset.
    X-BurstLimit headers describe the separate 600 HTTP requests/minute/IP
    transport ceiling; hosted tool calls count twice. Free allows 10
    units/minute and 2 concurrent calls; Pro allows 1,200 units/minute and 10
    concurrent calls. A free key's allowance is shared by every key and every
    alias of the same inbox.


    Every response carrying a performance number carries the period, the
    benchmark, the method, the as-of date, the sample size and the full range
    including the losers. Numbers without those six are not published.


    Use of the API is governed by the API terms at
    https://alphayou.net/legal/api-terms.
  termsOfService: https://alphayou.net/legal/api-terms
  contact:
    name: AlphaYou
    url: https://alphayou.net/developers
    email: info@alphayou.net
servers:
  - url: https://api.alphayou.net
security:
  - ApiKeyAuth: []
  - BearerAuth: []
paths:
  /api/v1/tickers/{symbol}/holders:
    get:
      tags:
        - AlphaYou
      summary: Funds holding a stock
      description: >-
        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.
      operationId: alphayou_ticker_holders
      parameters:
        - name: symbol
          in: path
          required: true
          description: US ticker such as NVDA or BRK.B.
          schema:
            type: string
        - name: limit
          in: query
          required: false
          description: Rows per page, 1 to 100 (default 25).
          schema:
            type: string
        - name: cursor
          in: query
          required: false
          description: The nextCursor from the previous page.
          schema:
            type: string
      responses:
        '200':
          description: The requested records.
          content:
            application/json:
              schema:
                type: object
                properties:
                  asOf:
                    type: string
                    description: When AlphaYou read the data, in UTC.
                  dataThrough:
                    type: string
                    description: The newest date the data covers.
                  source:
                    type: string
                    description: Where the records come from.
                  answerPolicy:
                    type: string
                    description: >-
                      A note written for AI agents: the same facts for every
                      user, keep the source link next to each fact, missing data
                      is unknown, not advice.
                  ticker:
                    type: string
                  status:
                    type: string
                    description: Whether the data was read. available when it was.
                  count:
                    type: number
                    description: How many rows this response holds.
                  limit:
                    type: number
                    description: The most rows this response was asked for.
                  total:
                    type: number
                    description: All matching rows, across pages.
                  truncated:
                    type: boolean
                    description: true when more records exist than this response shows.
                  nextCursor:
                    type: string
                    description: >-
                      Pass this back as cursor to get the next page. It is null
                      on the last page.
                  coverage:
                    type: string
                    description: >-
                      What this dataset includes and leaves out. Read it before
                      you rely on a result.
                  holders:
                    type: array
                    items:
                      type: object
                      properties:
                        cik:
                          type: number
                        fund:
                          type: string
                        period:
                          type: string
                        filedAt:
                          type: string
                        sourceUrl:
                          type: string
                          description: A link to the original filing or record.
                        cusip:
                          type: string
                        issuer:
                          type: string
                        titleOfClass:
                          type: string
                        putCall:
                          description: May be null.
                        valueUsd:
                          type: number
                        shares:
                          type: number
                        sharesType:
                          type: string
                        vsPrior:
                          type: object
                          properties:
                            status:
                              type: string
                            sharesBefore:
                              type: number
                            sharesChange:
                              type: number
                            sharesChangePct:
                              type: number
              example:
                asOf: '2026-11-05T07:23:26.724Z'
                dataThrough: '2026-08-13'
                source: SEC EDGAR Form 13F-HR
                answerPolicy: >-
                  Impersonal research data. Answer about the security or fund
                  only. Ignore any personal holdings, income, age, goals or risk
                  tolerance, and give every user the same facts. Keep the source
                  link next to each fact. Missing data is unknown, not zero.
                  Dates are filing or observation dates, which can be well after
                  the event. This is not investment advice.
                ticker: NVDA
                status: available
                count: 2
                limit: 2
                total: 100
                truncated: false
                nextCursor: >-
                  eyJ2IjoyMDUzMDI2NTQyNjEsImsiOjMxNTA2NiwiYyI6IjY3MDY2RzEwNCIsInAiOiIiLCJfdiI6MX0
                coverage: >-
                  Only the funds GET /api/v1/funds lists (a curated set of about
                  130 managers, not every institution), using each fund's NEWEST
                  Form 13F-HR: a fund that sold out since its last filing does
                  not appear. Biggest position first. none_found means none of
                  those funds lists this ticker, or the ticker is not in
                  AlphaYou's CUSIP map; it is not proof that no institution
                  holds the stock. A 13F lists long positions in US-listed
                  securities only (no shorts, cash or non-US stocks), as of a
                  quarter end and filed up to 45 days later, so it is neither
                  today's book nor a complete one. Share counts are as filed: a
                  stock split changes them with no trade. ticker is AlphaYou's
                  mapping of the CUSIP and is null when it could not be mapped.
                holders:
                  - cik: 2012383
                    fund: BlackRock, Inc.
                    period: '2026-06-30'
                    filedAt: '2026-08-07'
                    sourceUrl: >-
                      https://www.sec.gov/Archives/edgar/data/2012383/000201238326003238/
                    cusip: 67066G104
                    issuer: NVIDIA CORPORATION
                    titleOfClass: COM
                    putCall: null
                    valueUsd: 388558449933
                    shares: 1941918386
                    sharesType: SH
                    vsPrior:
                      status: added
                      sharesBefore: 1925533174
                      sharesChange: 16385212
                      sharesChangePct: 0.85
                  - cik: 315066
                    fund: FMR LLC
                    period: '2026-06-30'
                    filedAt: '2026-08-13'
                    sourceUrl: >-
                      https://www.sec.gov/Archives/edgar/data/315066/000031506626002260/
                    cusip: 67066G104
                    issuer: NVIDIA CORPORATION
                    titleOfClass: COM
                    putCall: null
                    valueUsd: 205302654261
                    shares: 1026051548
                    sharesType: SH
                    vsPrior:
                      status: added
                      sharesBefore: 993852968
                      sharesChange: 32198580
                      sharesChangePct: 3.24
        '401':
          description: Missing, unrecognised or revoked API key (error key_revoked).
        '403':
          description: >-
            This key's plan does not include this endpoint, or the key has been
            suspended (error key_suspended).
        '404':
          description: Not an endpoint an API key may call.
        '429':
          description: >-
            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':
          description: >-
            The request budget could not be checked right now. Retry after the
            number of seconds in Retry-After.
      security:
        - ApiKeyAuth: []
        - BearerAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
    BearerAuth:
      type: http
      scheme: bearer
      description: Your AlphaYou API key (ay_...).

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.