KeyVex Institutional Holdings API

The Institutional Holdings API from KeyVex — 1 operation(s) for institutional holdings.

GitHub OpenAPI

Operations 1

GET /v1/institutional-holdings Returns SEC Form 13F holdings: the quarterly long-equity positions of every… #

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-institutional-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-institutional-holdings-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: KeyVex Institutional 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: Institutional Holdings
paths:
  /v1/institutional-holdings:
    get:
      operationId: get_institutional_holdings
      summary: 'Returns SEC Form 13F holdings: the quarterly long-equity positions of every…'
      description: 'Returns SEC Form 13F holdings: the quarterly long-equity positions of every institutional investment manager that files a 13F ($100M+ in 13(f) securities), whole books, every quarter since 2013-06-30. Each record is one (fund, security, quarter). Use this when the user asks which institutions hold a stock, what a fund owns, how a position changed quarter over quarter, or about "whale" activity in a name. Freshness: 13Fs are due 45 days after quarter end. Every 13F on EDGAR''s daily list is normally loaded within a day of filing, deadline days included, and some sooner (EDGAR is also checked every 4 hours) (loaded_from "edgar"). Quarters covered by SEC''s quarterly 13F data sets come from them (loaded_from "sec_dataset"). 13F does NOT include short positions, cash, most options, or non-US-listed equities. position_change (''new'', ''increased'', ''decreased'', ''closed'', ''unchanged'') is measured against the same fund''s whole prior-quarter book. Amendments are applied as filed: a RESTATEMENT replaces the report; a NEW HOLDINGS amendment adds to it, and a security it lists again is shown once at the sum, with combined_accessions naming every filing in it. form is ''13F-HR'' or ''13F-HR/A''; amendment_type is ''RESTATEMENT'', ''NEW HOLDINGS'', or null. issuer_name is the security''s registered name where known, otherwise the name 13F filers report for it. A ticker query follows the security (its CUSIP) across a ticker change, so older quarters are included (query.resolved_cusips lists the CUSIPs matched); on those older rows the ticker shown may be the security''s current one. Values are US dollars. Filings before 2023 reported thousands and are multiplied by 1000. A filing that used the other unit is corrected once market prices confirm it (units_corrected true; value_as_filed holds the filed number). Where a filing''s values could not be confirmed against market prices, market_value is null, value_as_filed holds the number as filed, units_note says why, and the row is left out of value sorts and min_value. A filing whose share counts do not line up with the fund''s neighbouring filings is left out of shares_held sorts. On a fund''s answer, coverage_warning says when a sort leaves filings out and which sort lists them; a security''s or a quarter''s holders ranked by value or shares simply omit such filings. portfolio_weight_pct is the position''s share of the fund''s total reported value that quarter. verification_status VERIFIED means the filing matches its own declared row count and, within rounding of up to $1 a row (filings before 2023, $1,000 a row, when they reported thousands), its total value: a consistency check, not a price check. Older filings may still read INSUFFICIENT_DATA on a gap this small until they are re-checked. INSUFFICIENT_DATA means that check failed or could not run, the values look filed in the wrong unit (a 2023+ filing in thousands, or a pre-2023 filing in dollars) but could not be confirmed, or the filing''s values or share counts do not line up with market prices or the fund''s neighbouring filings. Where such a filing''s rows still show a market_value or shares_held, those numbers are as filed and unconfirmed. Give at least one filter that narrows the search: a fund (fund_cik or fund_name), a security (ticker or cusip), or a quarter. With no filter at all, the answer is the latest complete quarter (query.quarter says which). sort_by shares_held or shares_change_pct needs a quarter plus a fund or a security; position_change needs a fund or a security. Otherwise the call answers FILTER_REQUIRED and names the filter to add.'
      parameters:
      - name: ticker
        in: query
        required: false
        description: Filter to holdings of one stock by US ticker, e.g. 'AAPL'. Case-insensitive. Follows the security across a ticker change.
        schema:
          type: string
      - name: cusip
        in: query
        required: false
        description: Alternative to ticker — 9-character SEC CUSIP identifier. Useful when a security has multiple share classes with different tickers.
        schema:
          type: string
      - name: fund_name
        in: query
        required: false
        description: 'Full or partial fund name, at least 3 characters; case-insensitive, and it matches every name the manager has filed under (query.resolved_fund_ciks lists the managers). A name matching more than 20 managers answers FILTER_REQUIRED; use fund_cik. Examples: ''Berkshire'', ''Bridgewater'', ''Citadel''.'
        schema:
          type: string
      - name: fund_cik
        in: query
        required: false
        description: SEC CIK of the fund (10-digit, padded). Preferred over fund_name when known. Berkshire Hathaway = '0001067983'.
        schema:
          type: string
      - name: quarter
        in: query
        required: false
        description: Period end, YYYY-MM-DD (e.g. '2026-03-31'). With a fund or security and no quarter, every quarter is returned; with no filter at all, the latest complete quarter.
        schema:
          type: string
      - name: position_change
        in: query
        required: false
        description: 'Filter to position-change type. Common queries: ''increased'' for funds adding to a position, ''closed'' for funds that exited.'
        schema:
          type: string
          enum:
          - new
          - increased
          - decreased
          - closed
          - unchanged
          - INSUFFICIENT_DATA
      - name: min_value
        in: query
        required: false
        description: Filter to positions with market_value >= this amount (USD). Use to focus on large positions.
        schema:
          type: number
      - name: sort_by
        in: query
        required: false
        description: 'Field used for ordering. Default: market_value (largest positions first). shares_held and shares_change_pct need a quarter plus a fund or security.'
        schema:
          type: string
          enum:
          - market_value
          - shares_held
          - shares_change_pct
      - name: sort_order
        in: query
        required: false
        description: 'Default: desc (largest 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
      - name: cursor
        in: query
        required: false
        description: Pass the `next_cursor` from the previous response VERBATIM to fetch the next page. Keep every other filter and the sort identical while paging. Omit to start from the top. A quarter of 13F filings runs to far more than 500 rows, so a complete picture requires paging.
        schema:
          type: string
      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:
      - Institutional Holdings
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key