KeyVex Institutional Holdings API
The Institutional Holdings API from KeyVex — 1 operation(s) for institutional holdings.
The Institutional Holdings API from KeyVex — 1 operation(s) for institutional holdings.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/keyvex-com:keyvex-com-institutional-holdings-api"
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.
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: 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