KeyVex Nport Filings API

The Nport Filings API from KeyVex — 1 operation(s) for nport filings.

GitHub OpenAPI

Operations 1

GET /v1/nport-filings Returns SEC Form N-PORT filings — monthly portfolio reports from registered… #

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-nport-filings-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-nport-filings-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: KeyVex Nport Filings 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: Nport Filings
paths:
  /v1/nport-filings:
    get:
      operationId: get_nport_filings
      summary: Returns SEC Form N-PORT filings — monthly portfolio reports from registered…
      description: 'Returns SEC Form N-PORT filings — monthly portfolio reports from registered investment companies (mutual funds, ETFs, closed-end funds). Use this when the user asks about: recent fund portfolio filings, when a specific fund family last reported, monthly cadence of fund disclosures, or to bridge from a fund trust name to the primary_doc.xml that contains full per-holding portfolio detail. Source: SEC EDGAR full-text search. Covers both NPORT-P (original filing) and NPORT-P/A (amendments). N-PORT is filed within 60 days of each month-end; period_ending tells you which month the report covers. v1A returns metadata only: filer trust name + CIK, period_ending, filing type, SEC investment company file number (e.g., ''811-21864''), filer state + state of incorporation, and the URL to the full primary_doc.xml. Per-holding portfolio detail (every security in the fund''s portfolio with quantity, fair value, currency, etc.) lives in that XML — agents follow the URL when they need security-level data. Pairs with get_institutional_holdings (13F): 13F is quarterly, filed by INVESTMENT MANAGERS (Berkshire, Vanguard, BlackRock); N-PORT is monthly, filed by the FUND TRUST. Together = fresher snapshots across two complementary universes (manager-level vs fund-level).'
      parameters:
      - name: filing_id
        in: query
        required: false
        description: EDGAR accession number. Direct doc lookup, fastest.
        schema:
          type: string
      - name: filer_cik
        in: query
        required: false
        description: Fund trust's SEC CIK (1-10 digits; we zero-pad internally).
        schema:
          type: string
      - name: filer_name
        in: query
        required: false
        description: Case-insensitive substring against the fund trust name (e.g., 'wisdomtree', 'vanguard', 'fidelity').
        schema:
          type: string
      - name: period_ending
        in: query
        required: false
        description: Filter to a specific reporting period — the month-end the filing covers (YYYY-MM-DD).
        schema:
          type: string
      - name: sec_file_number
        in: query
        required: false
        description: SEC Investment Company file number, e.g., '811-21864'. Each fund trust has a stable number.
        schema:
          type: string
      - name: is_amendment
        in: query
        required: false
        description: 'When set, restricts to NPORT-P/A amendments (true) or original NPORT-P (false). Default: both.'
        schema:
          type: boolean
      - name: since
        in: query
        required: false
        description: file_date lower bound (YYYY-MM-DD inclusive).
        schema:
          type: string
      - name: until
        in: query
        required: false
        description: file_date upper bound (YYYY-MM-DD inclusive).
        schema:
          type: string
      - name: sort_by
        in: query
        required: false
        description: 'Default: file_date (most recently filed first). period_ending sorts by the month the report covers.'
        schema:
          type: string
          enum:
          - file_date
          - period_ending
      - name: sort_order
        in: query
        required: false
        description: 'Default: desc.'
        schema:
          type: string
          enum:
          - asc
          - desc
      - name: limit
        in: query
        required: false
        description: Maximum filings 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:
      - Nport Filings
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key