# secapi.dev — SEC Filings API

> secapi.dev is a developer-friendly SEC API that turns raw SEC EDGAR filings into clean, structured JSON. Standardized financial statements, Form 4 insider transactions, 13F institutional holdings, and company entity data — from REST API to official MCP server — without parsing XBRL or scraping EDGAR yourself.

## Overview

- Website: https://secapi.dev
- API base: https://api.secapi.dev
- Authentication: `x-api-key` header (create a free key at https://secapi.dev/access/signup)
- OpenAPI spec: https://api.secapi.dev/api/core/v3/api-docs
- Status & latency: https://secapi.dev/status
- Standardized financials methodology: https://secapi.dev/methodology/standardized-financials

### Scale

- 25M+ SEC filings indexed
- 1M entities tracked
- 3,000+ new filings ingested daily
- Filings parsed within seconds to a few minutes of EDGAR submission

### Key differentiators

- **Standardized financials** — filings, statements, insider trades, and 13F holdings on one canonical schema; 200+ as-reported XBRL tags mapped to one symbol per metric across income statement, balance sheet, and cash flow; 6,000+ filers; raw XBRL as-filed also available
- **Official MCP server** — open-source `secapi-mcp` with nine AI tools for Cursor, Claude, VS Code, and Windsurf; ask in plain English, get structured SEC data back
- **Insider signal tables** — Form 4 buys and sells decoded with transaction codes, roles, derivatives, and ownership snapshots; per-ticker buy/sell ratios and daily top-buyer snapshots

## Data catalog

### Financials

Canonical layer maps as-reported XBRL tags to standardized metrics so models, screeners, and charts are comparable across companies. 80+ canonical metrics for screening and time-series analysis.

- Docs: https://secapi.dev/public/docs/endpoints/financials
- Example: `GET /v1/financials/metrics?ticker=NVDA`
- Example: `GET /v1/financials/metrics/top?metric=revenue&limit=10`

### Insiders (Form 4)

Every insider buy and sell with codes, roles, derivatives, and ownership snapshots. Track clusters, unusual activity, and per-executive histories.

- Docs: https://secapi.dev/public/docs/endpoints/insiders
- Example: `GET /v1/insiders/transactions?transactionCode=P&minValue=100000`
- Example: `GET /v1/insiders/activity/daily/top-buyers`
- Example: `GET /v1/insiders/{ticker}/buy-sell-ratio`

### Institutions (Form 13F)

Quarterly holdings for every 13F manager: positions, portfolio weights, sector mix, quarter-over-quarter changes, ticker ownership, and crowding scores.

- Docs: https://secapi.dev/public/docs/endpoints/institutions
- Example: `GET /v1/institutions/{cik}/holdings?sort=weight&limit=10`
- Example: `GET /v1/institutions/{cik}/holdings-history`

### Filings & entities

Structured, queryable SEC filings and company entity data across all major EDGAR form types.

- Filings docs: https://secapi.dev/public/docs/endpoints/filings
- Entities docs: https://secapi.dev/public/docs/endpoints/entities
- Example: `GET /v1/filings?formTypes=10-Q&ticker=AAPL`

### Supported SEC forms

10-K (annual reports), 10-Q (quarterly reports), 8-K (material events), Form 4 (insider transactions), 13F (institutional holdings), S-1 (IPO registration), 20-F (foreign annual reports), 6-K (foreign current reports).

## Products

One dataset, every surface.

### REST API

Typed, predictable JSON for every filing type. 60+ endpoints, OpenAPI-documented, edge-cached with typical p95 latency around 320ms on core read endpoints.

- Docs: https://secapi.dev/public/docs/get-started/overview
- Interactive endpoint reference: https://secapi.dev/public/docs/endpoints/filings

### MCP server (`secapi-mcp`)

Official Model Context Protocol server — nine high-level tools for AI agents. Open source, built on `secapi-node`, Zod-validated inputs, AI-friendly error categories.

- GitHub: https://github.com/secapi-dev/secapi-mcp
- npm: https://www.npmjs.com/package/secapi-mcp
- Install: `npx secapi-mcp` or `npm install -g secapi-mcp`
- Tools include: `search_filings`, `analyze_filing`, `search_companies`, `company_overview`, `company_financials`, `company_ratios`, `insider_trades`, `search_institutions`, `institution_holdings`

### Python SDK (`secapi-py`)

Official typed client — filings, financials, insiders, and 13F from one resource-oriented interface. Pydantic v2 models generated from OpenAPI. Python 3.8+.

- GitHub: https://github.com/secapi-dev/secapi-python
- PyPI: https://pypi.org/project/secapi-py/
- Install: `pip install secapi-py`
- Import: `from secapi import SECClient` (reads `SECAPI_API_KEY` from environment)

### Node.js SDK (`secapi-node`)

Official TypeScript-native client for Node 18+. ESM and CJS. Powers `secapi-mcp` and server-side pipelines.

- GitHub: https://github.com/secapi-dev/secapi-node
- npm: https://www.npmjs.com/package/secapi-node
- Install: `npm install secapi-node`
- Import: `import { SECClient } from "secapi-node"` (reads `SECAPI_API_KEY` from environment)

## Use cases

- **Screener builders** — rank the market by any canonical metric (`GET /v1/financials/metrics/top`)
- **Insider trackers** — alert on conviction open-market purchases above a dollar threshold (`GET /v1/insiders/transactions`)
- **13F followers** — clone any manager's portfolio and track quarterly rebalances (`GET /v1/institutions/{cik}/holdings`)
- **AI & agent builders** — feed LLMs canonical, cross-company comparable figures via SDK or MCP instead of raw XBRL tag variants

## Pricing

Transparent monthly limits. Commercial use on every paid plan. Self-serve signup — no sales call required.

| Plan | Price | API requests / month | Highlights |
|------|-------|----------------------|------------|
| Free | $0 | 500 (recurring, not a one-time trial) | Filings, entities, insiders, institutions, as-reported financials |
| Lite | $29/mo ($290/yr) | 10,000 | Canonical statements, metrics, ratios; CSV export up to 5,000 rows |
| Pro | $99/mo ($990/yr) | 100,000 | Everything in Lite; CSV export up to 100,000 rows; priority support |
| Enterprise | $499/mo ($4,990/yr) | Unlimited | Redistribution license, SLA, dedicated support, custom integrations |

Signup: https://secapi.dev/access/signup

## Documentation

### Get started

- [Overview](https://secapi.dev/public/docs/get-started/overview)
- [Authentication & API keys](https://secapi.dev/public/docs/get-started/authentication)

### SEC form guides

- [Form 4 — Insider Transactions](https://secapi.dev/public/docs/get-started/form-4)
- [Form 6-K — Foreign Current Reports](https://secapi.dev/public/docs/get-started/form-6k)
- [Form 8-K — Current Reports](https://secapi.dev/public/docs/get-started/form-8k)
- [Form 10-K — Annual Reports](https://secapi.dev/public/docs/get-started/form-10k)
- [Form 10-Q — Quarterly Reports](https://secapi.dev/public/docs/get-started/form-10q)
- [Form 13F — Institutional Holdings](https://secapi.dev/public/docs/get-started/form-13f)
- [Form 20-F — Foreign Annual Reports](https://secapi.dev/public/docs/get-started/form-20f)
- [Form S-1 — IPO Registration](https://secapi.dev/public/docs/get-started/form-s1)

### API endpoint groups

- [Filings](https://secapi.dev/public/docs/endpoints/filings)
- [Entities](https://secapi.dev/public/docs/endpoints/entities)
- [Financials](https://secapi.dev/public/docs/endpoints/financials)
- [Insiders](https://secapi.dev/public/docs/endpoints/insiders)
- [Institutions](https://secapi.dev/public/docs/endpoints/institutions)

## FAQ

**How is secapi.dev different from the free SEC EDGAR API?**
The SEC's EDGAR system provides raw documents and as-reported XBRL tags that require heavy parsing. secapi.dev normalizes filings: hundreds of XBRL tags map to one canonical symbol per metric, with consistent JSON across companies and ready-made endpoints for insiders, institutions, and screening.

**How do I authenticate?**
Create a free account, generate an API key, and pass it as an `x-api-key` header on each request. Docs include a live request builder, code examples, and OpenAPI spec.

**How fresh is the data?**
Filings are ingested in real time and typically parsed within seconds to a few minutes of EDGAR submission.

**Is there a free tier?**
Yes — 500 API requests per month on core endpoints (filings, entities, insiders, institutions, as-reported financials). Lite unlocks canonical standardized statements, metrics, and ratios. Upgrade, downgrade, or cancel anytime.