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

> What one tracked fund changed between its newest Form 13F and the one before: new positions, adds, trims and exits, largest estimated trade first, with the share counts in both filings. The trade size is an estimate from quarter-end prices, not a fill price, and nothing inside the quarter is visible. Pages with nextCursor.

Plans: Pro.



## OpenAPI

````yaml https://alphayou.net/openapi.json get /api/v1/funds/{cik}/changes
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}/changes:
    get:
      tags:
        - AlphaYou
      summary: Fund changes
      description: >-
        What one tracked fund changed between its newest Form 13F and the one
        before: new positions, adds, trims and exits, largest estimated trade
        first, with the share counts in both filings. The trade size is an
        estimate from quarter-end prices, not a fill price, and nothing inside
        the quarter is visible. Pages with nextCursor.


        Plans: Pro.
      operationId: alphayou_fund_changes
      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 100 (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
                  status:
                    type: string
                    description: Whether the data was read. available when it was.
                  comparedTo:
                    type: string
                  comparisonNote:
                    description: May be null.
                  summary:
                    type: object
                    properties:
                      total:
                        type: number
                      new:
                        type: number
                      added:
                        type: number
                      trimmed:
                        type: number
                      exited:
                        type: number
                  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.
                  changes:
                    type: array
                    items:
                      type: object
                      properties:
                        cusip:
                          type: string
                        ticker:
                          type: string
                        issuer:
                          type: string
                        titleOfClass:
                          type: string
                        putCall:
                          description: May be null.
                        action:
                          type: string
                        sharesBefore:
                          type: number
                        sharesNow:
                          type: number
                        sharesChange:
                          type: number
                        sharesChangePct:
                          type: number
                        valueBeforeUsd:
                          type: number
                        valueNowUsd:
                          type: number
                        approxTradeValueUsd:
                          type: number
              example:
                asOf: '2026-11-05T07:21:18.923Z'
                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
                status: available
                comparedTo: '2026-03-31'
                comparisonNote: null
                summary:
                  total: 15
                  new: 1
                  added: 7
                  trimmed: 6
                  exited: 1
                count: 2
                limit: 2
                truncated: false
                nextCursor: eyJ2Ijo4MzM5NzI1MDE2LCJjIjoiMDIwNzlLMTA3IiwicCI6IiIsIl92IjoxfQ
                coverage: >-
                  Every position whose share count differs between this fund's
                  newest Form 13F-HR (2026-06-30) and its previous one
                  (2026-03-31), largest estimated trade first. new means absent
                  in the earlier filing, exited means absent in the newer one.
                  approxTradeValueUsd is the shares changed times the
                  quarter-end price the filing implies: an estimate, not what
                  the fund paid, and it knows nothing about trades inside the
                  quarter. 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.
                changes:
                  - cusip: 02079K305
                    ticker: GOOGL
                    issuer: ALPHABET INC
                    titleOfClass: CAP STK CL A
                    putCall: null
                    action: added
                    sharesBefore: 54249798
                    sharesNow: 78791167
                    sharesChange: 24541369
                    sharesChangePct: 45.24
                    valueBeforeUsd: 15600071913
                    valueNowUsd: 28157599351
                    approxTradeValueUsd: 8770349040
                  - cusip: 02079K107
                    ticker: GOOG
                    issuer: ALPHABET INC
                    titleOfClass: CAP STK CL C
                    putCall: null
                    action: added
                    sharesBefore: 3585215
                    sharesNow: 27188433
                    sharesChange: 23603218
                    sharesChangePct: 658.35
                    valueBeforeUsd: 1028454775
                    valueNowUsd: 9606489032
                    approxTradeValueUsd: 8339725016
        '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.