BoothCheck Insider Activity API

openapi: 3.2.0
info:
  title: boothcheck Insider Activity API
  version: 1.4.0
  description: 'Read-only derived data from SEC filings: what a stock price is betting on (implied growth, duration, margin), research report sections, segment snapshots, peer cohorts, a management guidance track record, risk-factor additions, insider and holder fact registers, and the cross-company analyst desk (one table and deterministic brief across 2 to 25 names, available to signed-in Founding Access accounts). No Boothcheck house fair value, price target, or rating. Informational and research purposes only.'
  termsOfService: https://boothcheck.com/api-terms
  contact:
    url: https://boothcheck.com/developers
servers:
- url: https://boothcheck.com/api/v1
tags:
- name: Insider Activity
paths:
  /insider-activity:
    get:
      operationId: get_insider_activity
      summary: Insider trades with their 10b5-1 plan context
      description: 'Recent insider trades for a US ticker from SEC Form 4 filings, kept current from EDGAR''s daily index, each with its filed context: open-market or plan trade, the 10b5-1 plan it ran under and that plan''s adoption date and days since adoption (from the Form 4 footnotes and the issuer''s Item 408 disclosure), trades so far under the same plan and the share of the plan''s disclosed aggregate used, percent of the insider''s direct holding, exercise-and-sell, late or amended filing, other insiders trading within 30 days, and whether this insider traded in the same month in prior years. Also returns the issuer''s disclosed trading arrangements and the window of filings read. Filed facts only; never a signal, score or recommendation. Requires a signed-in Founding Access account API key (Authorization: Bearer bck_...).'
      parameters:
      - name: ticker
        in: query
        required: true
        schema:
          type: string
        description: US stock ticker symbol, e.g. NVDA
      - name: days
        in: query
        required: false
        schema:
          type: integer
        description: Trades dated within this many days (default 90)
      - name: format
        in: query
        required: false
        schema:
          type: string
          enum:
          - json
          - csv
          default: json
        description: Response format. CSV requires a signed-in Founding Access account key.
      security:
      - apiKey: []
      responses:
        '200':
          description: Structured result. Every payload carries an informational-purposes disclaimer; no Boothcheck house fair value, price target, or rating.
        '401':
          description: Missing or invalid API key for a keyed endpoint.
        '404':
          description: Ticker not covered or no data for this surface.
        '429':
          description: Rate limit reached for the key tier.
      tags:
      - Insider Activity
  /insider-activity/{ticker}:
    get:
      operationId: get_insider_activity_by_path
      summary: Insider trades with their 10b5-1 plan context
      description: 'Recent insider trades for a US ticker from SEC Form 4 filings, kept current from EDGAR''s daily index, each with its filed context: open-market or plan trade, the 10b5-1 plan it ran under and that plan''s adoption date and days since adoption (from the Form 4 footnotes and the issuer''s Item 408 disclosure), trades so far under the same plan and the share of the plan''s disclosed aggregate used, percent of the insider''s direct holding, exercise-and-sell, late or amended filing, other insiders trading within 30 days, and whether this insider traded in the same month in prior years. Also returns the issuer''s disclosed trading arrangements and the window of filings read. Filed facts only; never a signal, score or recommendation. Requires a signed-in Founding Access account API key (Authorization: Bearer bck_...).'
      parameters:
      - name: ticker
        in: path
        required: true
        schema:
          type: string
        description: US ticker symbol.
      - name: days
        in: query
        required: false
        schema:
          type: integer
        description: Trades dated within this many days (default 90)
      - name: format
        in: query
        required: false
        schema:
          type: string
          enum:
          - json
          - csv
          default: json
        description: Response format. CSV requires a signed-in Founding Access account key.
      security:
      - apiKey: []
      responses:
        '200':
          description: Structured result. Every payload carries an informational-purposes disclaimer; no Boothcheck house fair value, price target, or rating.
        '401':
          description: Missing or invalid API key for a keyed endpoint.
        '404':
          description: Ticker not covered or no data for this surface.
        '429':
          description: Rate limit reached for the key tier.
      tags:
      - Insider Activity
components:
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: API key (bck_...). Create one from any signed-in Founding Access account at https://boothcheck.com/settings.