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

# Fund holdings

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



## OpenAPI

````yaml https://alphayou.net/openapi.json get /api/v1/funds/{cik}/holdings
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/funds/{cik}/holdings:
    get:
      tags:
        - AlphaYou
      summary: Fund holdings
      description: >-
        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.
      operationId: alphayou_fund_holdings
      parameters:
        - name: cik
          in: path
          required: true
          description: The fund's SEC CIK, taken from the funds list.
          schema:
            type: string
        - name: limit
          in: query
          required: false
          description: Rows per page, 1 to 250 (default 50).
          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.
                  fund:
                    type: object
                    properties:
                      cik:
                        type: number
                      name:
                        type: string
                      period:
                        type: string
                      filedAt:
                        type: string
                      sourceUrl:
                        type: string
                        description: A link to the original filing or record.
                      positionCount:
                        type: number
                      reportedValueUsd:
                        type: number
                  comparedTo:
                    type: string
                  comparisonNote:
                    description: May be null.
                  count:
                    type: number
                    description: How many rows this response holds.
                  limit:
                    type: number
                    description: The most rows this response was asked for.
                  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.
                  holdings:
                    type: array
                    items:
                      type: object
                      properties:
                        cusip:
                          type: string
                        ticker:
                          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:21:14.919Z'
                dataThrough: '2026-08-14'
                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.
                fund:
                  cik: 1067983
                  name: Berkshire Hathaway Inc
                  period: '2026-06-30'
                  filedAt: '2026-08-14'
                  sourceUrl: >-
                    https://www.sec.gov/Archives/edgar/data/1067983/000119312526352200/
                  positionCount: 29
                  reportedValueUsd: 299253556246
                comparedTo: '2026-03-31'
                comparisonNote: null
                count: 2
                limit: 2
                truncated: false
                nextCursor: >-
                  eyJ2Ijo1MTI4MjMxOTI3NSwiYyI6IjAyNTgxNjEwOSIsInAiOiIiLCJfdiI6MX0
                coverage: >-
                  The positions this fund listed on its newest Form 13F-HR,
                  biggest first, each with the share change against the previous
                  filing. 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.
                holdings:
                  - cusip: '037833100'
                    ticker: AAPL
                    issuer: APPLE INC
                    titleOfClass: COM
                    putCall: null
                    valueUsd: 65950296923
                    shares: 227917808
                    sharesType: SH
                    vsPrior:
                      status: unchanged
                      sharesBefore: 227917808
                      sharesChange: 0
                      sharesChangePct: 0
                  - cusip: '025816109'
                    ticker: AXP
                    issuer: AMERICAN EXPRESS CO
                    titleOfClass: COM
                    putCall: null
                    valueUsd: 51282319275
                    shares: 151610700
                    sharesType: SH
                    vsPrior:
                      status: unchanged
                      sharesBefore: 151610700
                      sharesChange: 0
                      sharesChangePct: 0
        '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.