Skip to content

API · v1 · REST and JSON

SEC Data API for Developers

SEC filings, insider transactions, institutional holdings and company data through one REST API. Every record links back to its source on sec.gov.

Get an API keyRead the docs

Quick start

Simple integration

Plain HTTP requests with JSON responses. No SDK required.

  1. 01Get an API keySign up free and create a key in your dashboard
  2. 02Make requestsSend the key in the Authorization header
  3. 03Parse JSONPage through results with the cursor
Request · curl
curl -G https://earningsfeed.com/api/v1/filings \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d ticker=AAPL -d forms=8-K -d limit=10
example.js
// Fetch recent 8-K filings for Apple
const response = await fetch(
  'https://earningsfeed.com/api/v1/filings?ticker=AAPL&forms=8-K&limit=10',
  {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  }
);

const { items, nextCursor, hasMore } = await response.json();

// Each filing includes:
// - accessionNumber, formType, filedAt
// - company details (name, cik, ticker)
// - document URLs and filing status

Checked every minute

We check EDGAR every minute. Half of filings appear within two minutes of SEC acceptance, and 9 in 10 within five (median 114 seconds, Sep 24-30, 2026).

REST and JSON

Predictable resources, cursor-based pagination and an OpenAPI 3.1 spec.

One header to authenticate

A bearer API key in the Authorization header. No OAuth flow.

Clear rate limits

Minute and monthly usage in response headers. Scale up with Pro or Trader.

Endpoints

Available API endpoints

6 endpoints
MethodEndpoint
GET/api/v1/filingsPaginated feed of SEC filings with filters
GET/api/v1/filings/{accession}Single filing detail by accession number
GET/api/v1/insider/transactionsInsider trading transactions (Form 3/4/5)
GET/api/v1/institutional/holdingsInstitutional holdings from 13F filings
GET/api/v1/companies/{cik}Company profile by CIK
GET/api/v1/companies/searchSearch companies by name or ticker
Full API reference

Limits and pricing

Rate limits

PlanPer minutePer monthPrice
Free155,000$0
Pro60250,000$15/moor $120/yr
Trader3002,000,000$75/moor $600/yr

Every plan includes every endpoint. Monthly limits are hard caps and reset at the start of each UTC calendar month. The monthly quota is shared across API keys, interactive docs and MCP.

Compare plans

SDKs

Official client libraries

Typed, documented and open source.

View all on GitHub

Use cases

What can you build?

Trading signals

Build systems that react to 8-K filings, earnings releases and material events.

Insider activity tracking

Follow Form 4 transactions to see when officers and directors buy and sell.

Institutional flow analysis

Track 13F filings to see what hedge funds and institutions are buying and selling.

Research platforms

Power financial research tools with SEC filing data and company profiles.

Read why we built it and what the first version covers: Introducing the Earnings Feed API. Rather read the SEC’s own feeds? SEC EDGAR RSS feeds, and how to filter them

Coverage

SEC forms in the API

Earnings Feed keeps these SEC forms: 8-K, 10-K, 10-Q, 6-K, S-1, 10-D, insider Forms 3, 4 and 5, Schedules 13D and 13G, 13F and Form 144, with their amendments. Not covered yet: proxy statements (DEF 14A), shelf offerings (S-3, 424B), Form D and fund filings.

  • 10-KAnnual reportsYearly financials and disclosures
  • 10-QQuarterly reportsQuarterly financial statements and updates
  • 8-K6-KCurrent eventsMaterial events, earnings, leadership changes
  • 345Insider tradingOfficer, director and 10% owner transactions
  • 13FInstitutional holdingsQuarterly holdings of $100M+ managers
  • SC 13DSC 13GBeneficial ownership5%+ ownership stakes and activist positions
  • S-1RegistrationIPO prospectuses
  • 144Restricted stock salesNotices of proposed sales by insiders
  • 10-DAsset-backed distributionsDistribution reports from asset-backed issuers

FAQ

Frequently asked questions

What data does the Earnings Feed API provide?
Full coverage of SEC EDGAR: 10-K and 10-Q financials, 8-K material events, Form 3/4/5 insider trades, 13F institutional holdings, and 13D/13G beneficial ownership. Each response includes structured company data with CIK, tickers, and direct links to source documents.
Is the API free to use?
Yes. Free includes full endpoint access at 15 requests/minute and 5,000 requests per UTC month—no credit card or trial period. Pro ($10/mo billed annually) includes 60/min and 250,000/month; Trader ($50/mo billed annually) includes 300/min and 2,000,000/month. Monthly limits are hard caps and reset at the start of each UTC calendar month.
How fast is the data?
We check EDGAR every minute. Half of filings appear within two minutes of SEC acceptance, and 9 in 10 within five (median 114 seconds, Sep 24-30, 2026). The API serves the same filings as the feed.
What authentication method does the API use?
Bearer token via Authorization header. Generate keys instantly from your dashboard. No OAuth complexity, no token refresh logic.
Is there an OpenAPI specification available?
Complete OpenAPI 3.1 spec at /api/v1/openapi.json. Import directly into Postman, generate typed clients, or explore interactively at /api/docs.
What about rate limiting and pagination?
Tier minute limits apply to API-key and MCP requests; interactive docs tokens retain a fixed 10 requests/minute. The monthly quota is account-wide across API keys, interactive docs, and MCP. Authenticated responses that pass the minute throttle include minute and monthly usage headers. Only minute-scoped 429 responses include Retry-After; for a monthly cap, wait for X-RateLimit-Monthly-Reset, upgrade, or contact support. Cursor-based pagination handles large result sets efficiently—no offset drift or duplicate entries.

Ready to build?

Free plan: 15 requests a minute, 5,000 a month and every endpoint. No credit card required.

Get a free API keyRead the docs