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

# Company 8-K disclosures

> Recent SEC 8-K filings for one US-listed company, read from SEC EDGAR: the items filed (with their titles), the filing date and the original SEC link. Up to 20 recent filings, newest first, with totalInWindow and truncated marking omitted rows. Metadata only, not article text, news or sentiment; no continuation cursor. A symbol with no SEC-registered company is a 404. Free keys look back 90 days, Pro keys 365.

Plans: Free, Pro.



## OpenAPI

````yaml https://alphayou.net/openapi.json get /api/v1/tickers/{symbol}/disclosures
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}/disclosures:
    get:
      tags:
        - AlphaYou
      summary: Company 8-K disclosures
      description: >-
        Recent SEC 8-K filings for one US-listed company, read from SEC EDGAR:
        the items filed (with their titles), the filing date and the original
        SEC link. Up to 20 recent filings, newest first, with totalInWindow and
        truncated marking omitted rows. Metadata only, not article text, news or
        sentiment; no continuation cursor. A symbol with no SEC-registered
        company is a 404. Free keys look back 90 days, Pro keys 365.


        Plans: Free, Pro.
      operationId: alphayou_company_disclosures
      parameters:
        - name: symbol
          in: path
          required: true
          description: US ticker such as NVDA or BRK.B.
          schema:
            type: string
        - name: days
          in: query
          required: false
          description: Look-back in days, up to your plan's window.
          schema:
            type: string
        - name: limit
          in: query
          required: false
          description: Rows, 1 to 20 (default 10).
          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
                  company:
                    type: object
                    properties:
                      cik:
                        type: number
                      name:
                        type: string
                  status:
                    type: string
                    description: Whether the data was read. available when it was.
                  windowDays:
                    type: number
                  count:
                    type: number
                    description: How many rows this response holds.
                  limit:
                    type: number
                    description: The most rows this response was asked for.
                  totalInWindow:
                    type: number
                  truncated:
                    type: boolean
                    description: true when more records exist than this response shows.
                  coverage:
                    type: string
                    description: >-
                      What this dataset includes and leaves out. Read it before
                      you rely on a result.
                  disclosures:
                    type: array
                    items:
                      type: object
                      properties:
                        accession:
                          type: string
                        form:
                          type: string
                        items:
                          type: array
                          items:
                            type: object
                            properties:
                              item:
                                type: string
                              title:
                                type: string
                        filedAt:
                          type: string
                        acceptedAt:
                          type: string
                        reportDate:
                          type: string
                        sourceUrl:
                          type: string
                          description: A link to the original filing or record.
                        filingIndexUrl:
                          type: string
              example:
                asOf: '2026-11-05T07:20:59.480Z'
                dataThrough: '2026-09-03'
                source: SEC EDGAR (Form 8-K and 8-K/A filings)
                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
                company:
                  cik: 1045810
                  name: NVIDIA CORP
                status: available
                windowDays: 90
                count: 2
                limit: 2
                totalInWindow: 3
                truncated: false
                coverage: >-
                  Every 8-K and 8-K/A filing the SEC lists for this company
                  inside the window, newest first, read from SEC EDGAR (a read
                  can be up to 15 minutes old). Metadata only: the items filed
                  and the original SEC link, not article text, news or
                  sentiment. A filing made in the last few minutes may not be
                  listed yet. Do not infer a conclusion from the item numbers
                  alone.
                disclosures:
                  - accession: 0001045810-26-000078
                    form: 8-K
                    items:
                      - item: '8.01'
                        title: Other Events
                    filedAt: '2026-09-03'
                    acceptedAt: '2026-09-03T12:03:56.000Z'
                    reportDate: '2026-09-02'
                    sourceUrl: >-
                      https://www.sec.gov/Archives/edgar/data/1045810/000104581026000078/nvda-20260902.htm
                    filingIndexUrl: >-
                      https://www.sec.gov/Archives/edgar/data/1045810/000104581026000078/0001045810-26-000078-index.htm
                  - accession: 0001045810-26-000073
                    form: 8-K
                    items:
                      - item: '2.02'
                        title: Results of Operations and Financial Condition
                      - item: '9.01'
                        title: Financial Statements and Exhibits
                    filedAt: '2026-08-26'
                    acceptedAt: '2026-08-26T20:21:19.000Z'
                    reportDate: '2026-08-26'
                    sourceUrl: >-
                      https://www.sec.gov/Archives/edgar/data/1045810/000104581026000073/nvda-20260826.htm
                    filingIndexUrl: >-
                      https://www.sec.gov/Archives/edgar/data/1045810/000104581026000073/0001045810-26-000073-index.htm
        '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.