KeyVex Insider Holdings API

The Insider Holdings API from KeyVex — 1 operation(s) for insider holdings.

GitHub OpenAPI

Operations 1

GET /v1/insider-holdings A ticker search also returns rows this issuer FILED UNDER SYMBOLS IT NO LONGER… #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/keyvex-com:keyvex-com-insider-holdings-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

keyvex-com-insider-holdings-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: KeyVex Insider Holdings API
  version: 0.102.0
  termsOfService: https://keyvex.com/terms
  description: 'US public financial-disclosure data — congressional trades, insider filings (Form 4), lobbying, Treasury auctions, member profiles. Requires an API key — create a free one at https://keyvex.com and send it as the header `x-api-key: `. A free key returns most public-record datasets (one year of history; no market-price data and a few heavy datasets are on paid plans only), capped at 60 requests/day; paid plans raise the caps. The daily allowance resets at midnight Eastern.'
servers:
- url: https://api.keyvex.com
security:
- ApiKeyAuth: []
tags:
- name: Insider Holdings
paths:
  /v1/insider-holdings:
    get:
      operationId: get_insider_holdings
      summary: A ticker search also returns rows this issuer FILED UNDER SYMBOLS IT NO LONGER…
      description: 'A ticker search also returns rows this issuer FILED UNDER SYMBOLS IT NO LONGER LISTS (renames, filer typos, ADR spellings). Each row keeps `ticker` as SEC received it and gains `current_ticker` when the issuer trades under a different symbol today. Separately-listed share classes are NOT merged, and asking for a RETIRED symbol returns only rows filed under it — retired symbols get reissued to other companies. When more than one issuer has filed under a ticker (a reused symbol, a holding-company reorganization), every row stays in the answer and carries `issuer_relation`: the row''s own issuer and its relation to the ticker''s issuer (same_issuer; predecessor or successor, on SEC evidence; related_by_name; affiliate; or different_issuer), with the evidence, such as the SEC succession form and its date. A ticker search also finds this issuer''s rows filed under ANOTHER issuer''s symbol, matched only on its CIK. Returns per-security INSIDER POSITIONS from SEC Form 3/4/5 filings — one row per holding line reported by a corporate insider (director, officer, or 10%+ beneficial owner). Use this when the user asks: what a specific insider currently HOLDS, who the largest insider holders of a stock are, an insider''s position across companies, or direct-vs-indirect ownership structure. This is the position (stock) companion to get_insider_transactions (the buys/sells flow). Source: SEC bulk Form 3/4/5 dataset (insider_holdings_v2), 2006→present, refreshed quarterly. Each row carries the filing envelope (company_cik, company_name, ticker, reporting_owner_cik/name, role flags, filing_date, period_of_report), the position (holding_type nonderiv|deriv, security_title, shrs_owned_following_trans, valu_owned_following_trans, direct_indirect_ownership D|I), and — for derivative holdings — conv_exercise_price, exercise_date, expiration_date, and underlying-security detail. Useful filter combos: ticker=''NVDA'', sort_order=''desc'' most-recent NVDA insider holdings reporting_owner_cik=''0001214128'' one insider''s positions everywhere ticker=''AAPL'', holding_type=''deriv'' AAPL insiders'' option/RSU positions ticker=''TSLA'', is_ten_percent_owner=true 10%+ owners of TSLA company_cik=''0000320193'', min_value=1000000 Apple insiders holding >$1M reporting_owner_name=''Musk'' name substring (case-insensitive) shares/value are ''following the reported transaction'' — the position as of that filing, not a live real-time holding. For the trades themselves use get_insider_transactions; ownership ties together via reporting_owner_cik.'
      parameters:
      - name: ticker
        in: query
        required: false
        description: Exact issuer ticker (e.g., 'AAPL', 'BRK.B').
        schema:
          type: string
      - name: company_cik
        in: query
        required: false
        description: Issuer CIK (10-digit, leading-zero padded). Returns insider holdings across all reporting periods for that company.
        schema:
          type: string
      - name: company_name
        in: query
        required: false
        description: Case-insensitive substring against issuer company name (e.g., 'Apple', 'Tesla').
        schema:
          type: string
      - name: reporting_owner_cik
        in: query
        required: false
        description: Insider CIK (10-digit, leading-zero padded). Returns one insider's positions across every company they report on.
        schema:
          type: string
      - name: reporting_owner_name
        in: query
        required: false
        description: Case-insensitive substring against the insider's name (e.g., 'Musk', 'Cook').
        schema:
          type: string
      - name: merge_co_reports
        in: query
        required: false
        description: DEFAULT TRUE — leave it alone unless you specifically want raw filings. When shares are held through a fund, trust or family holding company, every person deemed a beneficial owner files their own Form 3/4/5 reporting the SAME position, so one block appears once per filer. By default those lines are merged into one row per position, so share counts are the shares actually held; reporting_owner_name names every filer and co_reported_accessions lists every accession. Set false for one row per filing — totals then count the same shares once per reporting person.
        schema:
          type: boolean
      - name: holding_type
        in: query
        required: false
        description: '''nonderiv'' = direct securities (common stock); ''deriv'' = derivative holdings (options, RSUs, warrants, convertibles). Omit for both.'
        schema:
          type: string
          enum:
          - nonderiv
          - deriv
      - name: direct_indirect_ownership
        in: query
        required: false
        description: '''D'' direct ownership, ''I'' indirect (held via trust, LLC, family member, etc.).'
        schema:
          type: string
          enum:
          - D
          - I
      - name: is_director
        in: query
        required: false
        description: True returns only holdings reported by directors.
        schema:
          type: boolean
      - name: is_officer
        in: query
        required: false
        description: True returns only holdings reported by officers.
        schema:
          type: boolean
      - name: is_ten_percent_owner
        in: query
        required: false
        description: True returns only holdings reported by 10%+ beneficial owners.
        schema:
          type: boolean
      - name: min_shares
        in: query
        required: false
        description: Minimum shares owned following the reported transaction. Use to focus on large positions.
        schema:
          type: number
      - name: min_value
        in: query
        required: false
        description: Minimum USD value owned following the reported transaction. Use to focus on large positions.
        schema:
          type: number
      - name: since
        in: query
        required: false
        description: ISO date (YYYY-MM-DD). Only holdings whose period_of_report >= this date.
        schema:
          type: string
      - name: until
        in: query
        required: false
        description: ISO date (YYYY-MM-DD). Only holdings whose period_of_report <= this date.
        schema:
          type: string
      - name: sort_by
        in: query
        required: false
        description: 'Sort field. Only period_of_report is supported. Default: period_of_report.'
        schema:
          type: string
          enum:
          - period_of_report
      - name: sort_order
        in: query
        required: false
        description: 'Default: desc (most recent reporting period first).'
        schema:
          type: string
          enum:
          - desc
          - asc
      - name: limit
        in: query
        required: false
        description: Maximum records to return. Default 50, max 500.
        schema:
          type: integer
      responses:
        '200':
          description: 'JSON envelope: { results: [...], count, has_more }.'
        '400':
          description: Invalid parameter.
        '401':
          description: Missing or invalid API key.
        '402':
          description: This tool requires a higher plan (upgrade_required). Retrying will not help.
        '429':
          description: Tier rate/quota limit reached (rate_limited). Retry-After points at the reset.
      tags:
      - Insider Holdings
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key