$npx skillfedfor your agent

sec-api

SEC EDGAR Filings API

With conditionsPyPI Python ModulesReleased Apr 2026557.8K downloads / mopermissive licensePure Python

Decision gist · record as of 2026-08-14

pure-Python wheel — sec_api-1.0.36-py3-none-any.whl
v1.0.36 · released 2026-04-13 · 1 runtime deps: requests

Yes, if you need programmatic access to SEC EDGAR data and are willing to use the sec-api.io service. The library is actively maintained, has low install friction, carries no security vulnerabilities, and is licensed permissively. The main constraint is that it requires an external API key and service account; it is not a standalone tool. Install it when you are already committed to using sec-api.io or are evaluating whether the service meets your needs.AI-flagged interpretation of the facts on this page — verify before relying

Before you install

  • Requires a free API key from sec-api.io; the package is a client library and cannot function without external API credentials.
  • Low install friction with a single runtime dependency (requests).
  • The package is actively maintained with recent commits and stable production status, though it requires an API key from sec-api.io to function.

License · maintenance · safety

permissive license (permissive) — Licensed under MIT (permissive), allowing free use, modification, and distribution with minimal restrictions.

last release 2026-04-13 (123 days) · last repo commit 2026-04-13 · 315 stars

0 known vulnerabilities (OSV.dev, 2026-08-14) · 557,785 downloads/mo, #6,010 on PyPI

Verify before relying

pip install sec-api

from sec_api import QueryApi

queryApi = QueryApi(api_key="YOUR_API_KEY")
query = {"query": "ticker:TSLA AND formType:\"10-Q\"", "from": "0", "size": "10"}
filings = queryApi.get_filings(query)
print(filings)
  • Rate limits and throttling behavior beyond the stated '200+ requests / second per account'
  • Whether all 500+ EDGAR form types are equally supported across all API endpoints
  • Latency and availability guarantees for real-time filing stream and bulk dataset downloads
Same gist for agents: .md · .json

What it is and what it does

sec-api is a Python wrapper around the SEC-API.io service, a commercial API platform for SEC EDGAR data. It lets you search, filter, and download SEC filings, exhibits, and structured financial data programmatically. The library provides multiple specialized APIs: a query interface for searching filings by ticker, CIK, form type, and date; a download API for retrieving individual filings and exhibits; bulk dataset downloaders for complete form-type collections; and specialized extractors for insider trading (Forms 3/4/5), institutional holdings (Form 13F), investment advisor data (Form ADV), and structured material events from 8-K filings. The underlying data covers every SEC-regulated filer ever reported, including delisted and dissolved entities, with historical coverage back to 1993 and real-time updates.

To use it, you instantiate one of the API classes (QueryApi, DownloadApi, Datasets, etc.) with your sec-api.io API key, then call methods to search or download. The library depends only on requests for HTTP communication. It is intended for financial analysts, researchers, compliance teams, and developers building tools that need programmatic access to SEC filings and structured financial data.

Use it for

  • Search and retrieve all 10-K or 10-Q filings for a specific company over a date range to build a historical financial database.
  • Download insider trading disclosures (Forms 3/4/5) to track changes in executive and director ownership positions.
  • Extract institutional holdings from Form 13F filings to analyze large fund positions and portfolio changes.
  • Bulk download entire datasets of a specific form type (e.g., all Form D private offerings) for research or compliance analysis.
  • Retrieve and parse structured 8-K material event data (auditor changes, restatements, executive changes) for real-time monitoring.
  • Map between CUSIP, CIK, and ticker symbols to normalize company identifiers across different data sources.

Worth the install?

AI-flagged interpretation of the facts on this page. Verify before relying on it.

With conditions

Yes, if you need programmatic access to SEC EDGAR data and are willing to use the sec-api.io service.

The library is actively maintained, has low install friction, carries no security vulnerabilities, and is licensed permissively. The main constraint is that it requires an external API key and service account; it is not a standalone tool. Install it when you are already committed to using sec-api.io or are evaluating whether the service meets your needs.

Install

sec-api on PyPI

Before you install

Low install friction with a single runtime dependency (requests). The package is actively maintained with recent commits and stable production status, though it requires an API key from sec-api.io to function.

Requires a free API key from sec-api.io; the package is a client library and cannot function without external API credentials.

License in practice

Licensed under MIT (permissive), allowing free use, modification, and distribution with minimal restrictions.

Quickstart

pip install sec-api

from sec_api import QueryApi

queryApi = QueryApi(api_key="YOUR_API_KEY")
query = {"query": "ticker:TSLA AND formType:\"10-Q\"", "from": "0", "size": "10"}
filings = queryApi.get_filings(query)
print(filings)

Verify before relying

  • Rate limits and throttling behavior beyond the stated '200+ requests / second per account'
  • Whether all 500+ EDGAR form types are equally supported across all API endpoints
  • Latency and availability guarantees for real-time filing stream and bulk dataset downloads

Package facts

Licensepermissive license permissive
Python supportNot specified
Install frictionLow. Pure-Python wheel
Runtime dependencies
1 package
requests
MaintenanceActively maintained 123 days since the last release
Last repo commit
First released
Downloads557,785 / month, #6,010 on PyPI 30-day window, as of 2026-08-14
Known vulnerabilitiesNone known OSV.dev, checked 2026-08-14
Classifiers
Development Status :: 5 - Production/StableIntended Audience :: DevelopersIntended Audience :: Financial and Insurance IndustryIntended Audience :: Information TechnologyLicense :: OSI Approved :: MIT LicenseOperating System :: OS IndependentProgramming Language :: Python :: 3Topic :: Office/Business :: FinancialTopic :: Office/Business :: Financial :: InvestmentTopic :: Software Development :: Build ToolsTopic :: Software Development :: Libraries :: Python Modules

Evidence: sec_api-1.0.36-py3-none-any.whl

Tags

Capabilities
SEC EDGAR filings API clientdownload SEC filings programmaticallyinsider trading data API10-K 10-Q form searchfinancial statement extractioninstitutional holdings 13FSEC filing bulk download
Topics
sec-filingsfinancial-dataapi-client
PyPI keywords
SEC EDGAR APISEC Filings APISEC Filing Search APISEC Full-Text Search APIEDGAR APIFinanceCIKCUSIPCUSIP to TickerCUSIP to CIK10-Q10-K8-KS-1424B4XBRL ConverterFinancial Statements APIInsider Trading DataExecutive Compensation DataForm D Offerings APIForm N-PORT APIForm ADV API10-K/10-Q/8-K Section Extractor API

Let your AI agent find packages like this

Example. Real query, live index.

You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.

wish › “SEC EDGAR filings API client”

  • sec-apiA Python client for the SEC-API.io service that provides programmatic…
  • sec-edgar-downloaderDownloads SEC EDGAR company filings by ticker or CIK, supporting all…
  • edgartoolsEdgarTools parses SEC EDGAR filings into typed Python objects and…

Give your agent the search over MCP, or paste the wish link into any chat.

More Python Modules packages

idna Worth it
PyPI · Python Modules · released Jun 2026

Converts domain names between Unicode and ASCII-compatible encoding (Punycode) according to IDNA 2008 and Unicode Technical Standard 46, with security validation and broader script coverage than the standard library.

Install it if you work with internationalized domain names, need to validate domains, or use HTTP clients that depend on it transitively.

BSD-3-Clausepure Python · 3.9+
1.8Bdownloads / mo
setuptools Worth it
PyPI · Python Modules · released Aug 2026

Setuptools is a Python build backend and package management tool that handles building, distributing, and installing Python packages, including support for C/C++ extension modules.

MITpure Python · 3.10+
1.6Bdownloads / mo
PyYAML Worth it
PyPI · Python Modules · released Sep 2025

PyYAML parses and emits YAML 1.1 data format, enabling serialization and deserialization of configuration files and Python objects to and from human-readable YAML text.

MITcompiled wheel · 3.8+
1.2Bdownloads / mo
pydantic Worth it
PyPI · Python Modules · released May 2026

Pydantic validates Python data structures against type hints, coercing and checking input at runtime to ensure it matches a declared schema.

MITpure Python · 3.9+
1.1Bdownloads / mo
annotated-types Worth it
PyPI · Python Modules · released Jul 2026

Provides reusable metadata objects for use with PEP-593 `typing.Annotated` to express common constraints like bounds, collection sizes, and predicates on types.

Install it if you use or build libraries that need to express type constraints in a standardized, inspectable way—or if you want to annotate your own types with…

MITpure Python · 3.10+
871.3Mdownloads / mo
typing-inspection Worth it
PyPI · Python Modules · released Aug 2026

Provides runtime tools to inspect and introspect Python type annotations, enabling programmatic examination of type hints at execution time.

MITpure Python · 3.10+
783.0Mdownloads / mo

See also edgartools · instructure-dap-client · sec-edgar-downloader · openbb-sec · openbb · yahooquery · finnhub-python · polygon-api-client · pypistats · arelle-release