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

# Insider trades

> Insider open-market buys and sells from SEC Form 4 filings, newest first: the insider, their role, each trade with date, shares and price, the 10b5-1 plan label and the SEC link. Free keys get the 5 newest filings from the last 90 days; Pro keys page through 365 days with nextCursor. None found means no open-market trade is on file, not that nobody filed.

Plans: Free, Pro.



## OpenAPI

````yaml https://alphayou.net/openapi.json get /api/v1/insiders/trades
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/insiders/trades:
    get:
      tags:
        - AlphaYou
      summary: Insider trades
      description: >-
        Insider open-market buys and sells from SEC Form 4 filings, newest
        first: the insider, their role, each trade with date, shares and price,
        the 10b5-1 plan label and the SEC link. Free keys get the 5 newest
        filings from the last 90 days; Pro keys page through 365 days with
        nextCursor. None found means no open-market trade is on file, not that
        nobody filed.


        Plans: Free, Pro.
      operationId: alphayou_insider_trades
      parameters:
        - name: ticker
          in: query
          required: false
          description: US ticker such as NVDA. Leave out for all companies.
          schema:
            type: string
        - name: side
          in: query
          required: false
          description: buy, sell or both (default both).
          schema:
            type: string
        - name: days
          in: query
          required: false
          description: Look-back in days, up to your plan's window (90 Free, 365 Pro).
          schema:
            type: string
        - name: limit
          in: query
          required: false
          description: >-
            Pro only: rows per page, 1 to 100 (default 25). Free keys always get
            5.
          schema:
            type: string
        - name: cursor
          in: query
          required: false
          description: 'Pro only: 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:
                    description: May be null.
                  side:
                    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.
                  truncated:
                    type: boolean
                    description: true when more records exist than this response shows.
                  limitedByPlan:
                    type: boolean
                  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.
                  filings:
                    type: array
                    items:
                      type: object
                      properties:
                        accession:
                          type: string
                        ticker:
                          type: string
                        issuer:
                          type: string
                        filedAt:
                          type: string
                        side:
                          type: string
                        insider:
                          type: object
                          properties:
                            name:
                              type: string
                            role:
                              type: string
                            isDirector:
                              type: boolean
                            isOfficer:
                              type: boolean
                            isTenPercentOwner:
                              type: boolean
                            otherReporters:
                              type: number
                        trades:
                          type: array
                          items:
                            type: object
                            properties:
                              date:
                                type: string
                              action:
                                type: string
                              shares:
                                type: number
                              pricePerShare:
                                type: number
                              valueUsd:
                                type: number
                              valueExcludedReason:
                                description: May be null.
                              ownership:
                                type: string
                              derivative:
                                type: boolean
                        tradesTruncated:
                          type: boolean
                        totalBuyUsd:
                          type: number
                        totalSellUsd:
                          type: number
                        labels:
                          type: object
                          properties:
                            plan10b5_1:
                              type: boolean
                            exerciseAndSell:
                              type: boolean
                            privateDealPurchase:
                              type: boolean
                        sourceUrl:
                          type: string
                          description: A link to the original filing or record.
              example:
                asOf: '2026-11-05T07:21:02.059Z'
                dataThrough: '2026-11-05'
                source: SEC EDGAR Form 4
                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: null
                side: both
                status: available
                windowDays: 365
                count: 2
                limit: 2
                truncated: false
                limitedByPlan: false
                nextCursor: >-
                  eyJ0IjoiMjAyNi0xMS0wNVQwMjozNToxNy4wMDBaIiwiaSI6ImNtdzJ4dDM2aTVyOGttbDAxYzc2ajRjZW0iLCJfdiI6MX0
                coverage: >-
                  Insider Form 4 filings that contain an open-market purchase or
                  sale, newest first, with the trades as filed. Grants, awards,
                  gifts and tax withholding alone are not recorded, so none
                  found means no open-market trade is on file, not that nobody
                  filed. A filing is public up to 2 business days after the
                  trade and can arrive later than that. side is the filing's
                  dominant direction by dollar value. A 10b5-1 plan is a pre-set
                  trading schedule and carries less information than a
                  discretionary trade; exerciseAndSell is an option exercise
                  paired with a sale; privateDealPurchase is a purchase that
                  came through a private deal, not the market. Free keys see the
                  5 newest filings from the last 90 days and no further pages;
                  Pro keys page through 365 days.
                filings:
                  - accession: 0001646649-26-000043
                    ticker: NTRA
                    issuer: Natera, Inc.
                    filedAt: '2026-11-05'
                    side: sell
                    insider:
                      name: Sheena Jonathan
                      role: Director
                      isDirector: true
                      isOfficer: false
                      isTenPercentOwner: false
                      otherReporters: 0
                    trades:
                      - date: '2026-11-02'
                        action: sell
                        shares: 3
                        pricePerShare: 388.2
                        valueUsd: 1164.6
                        valueExcludedReason: null
                        ownership: DIRECT
                        derivative: false
                      - date: '2026-11-02'
                        action: sell
                        shares: 109
                        pricePerShare: 400.2942
                        valueUsd: 43632.0678
                        valueExcludedReason: null
                        ownership: DIRECT
                        derivative: false
                    tradesTruncated: false
                    totalBuyUsd: 0
                    totalSellUsd: 44796.6678
                    labels:
                      plan10b5_1: true
                      exerciseAndSell: false
                      privateDealPurchase: false
                    sourceUrl: >-
                      https://www.sec.gov/Archives/edgar/data/1646649/000164664926000043/0001646649-26-000043-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.