OLYMPUSby New Odyssey
Menu
Answer · US SEC Filings & Financial Data API

Is there an API for SEC EDGAR filings and XBRL financials?

Yes: the SEC's own EDGAR APIs on data.sec.gov return each company's filing history and every XBRL fact it filed as JSON, free and without an API key, at up to 10 requests a second with a declared User-Agent. What they return is each fact as the company tagged it, so the same line item can sit under different concepts from one company to the next. The Olympus US SEC Filings & Financial Data API maps those facts to eight standardised metrics (revenue, net income, total assets and five more) with annual and quarterly history, restatement flags and comparison: GET /v1/sec/companies/{cik}/financials.

By New Odyssey · Published · Markdown

The official route, and what it lacks

  • The EDGAR APIs. data.sec.gov/submissions/CIK##########.json (filing history), /api/xbrl/companyconcept/... (one concept for one company), /api/xbrl/companyfacts/CIK##########.json (every concept for one company) and /api/xbrl/frames/... (one concept across companies for a period). The SEC says: "These APIs do not require any authentication or API keys to access."
  • Updates. "The APIs are updated in real-time as filings are disseminated", and the bulk archive zip files "are recompiled nightly".
  • Fair access. "Current max request rate: 10 requests/second", with a User-Agent header that declares who you are.
  • Free. "Anyone can access and download this information for free."

What that leaves to you: companyfacts "returns all the company concepts data for a company", exactly as filed. Choosing which concept is revenue for each company, separating annual from quarterly values, spotting restatements and resolving tickers or EINs to CIKs is your code's job. There is no endpoint for "revenue for these five companies, last ten years".

What the US SEC Filings & Financial Data API serves

SEC EDGAR companies by CIK, ticker or EIN, 10-K / 10-Q filing metadata and eight standardised XBRL financial metrics with annual and quarterly history and comparison.

Limits

  • Values are as filed in XBRL: nothing is estimated, derived or corrected.
  • Metrics: revenue, net_income, total_assets, total_liabilities, stockholders_equity, operating_cash_flow, eps_diluted, shares_outstanding.
  • Quarterly operating cash flow is usually year-to-date (is_ytd: true).
  • A ticker can map to more than one CIK during a reorganisation; ticker search returns every match.

Not included: real-time streams; full-text filing search; insider trading; ownership; recommendations.

Example request and response

Apple's annual revenue for fiscal 2024 (CIK 320193):

Request
curl -s "https://api.olympus.new-odyssey.com/v1/sec/companies/320193/financials?metric=revenue&period=annual&fiscal_year_from=2024&fiscal_year_to=2024" \
  -H "X-API-Key: $OLYMPUS_API_KEY"
200 OK (abridged)
{
  "data": {
    "cik": "0000320193",
    "name": "Apple Inc.",
    "period_type": "annual",
    "fiscal_year_from": 2024,
    "fiscal_year_to": 2024,
    "series": [
      {
        "metric": "revenue",
        "unit": "USD",
        "values": [
          {
            "metric": "revenue",
            "fiscal_year": 2024,
            "fiscal_period": "FY",
            "period_start": "2023-10-01",
            "period_end": "2024-09-28",
            "value": 391035000000,
            "unit": "USD",
            "is_ytd": false,
            "concept": "RevenueFromContractWithCustomerExcludingAssessedTax",
            "form": "10-K",
            "filed_date": "2024-11-01",
            "accession_number": "0000320193-24-000123",
            "evidence_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/0000320193-24-000123-index.htm",
            "is_restated": false,
            "provenance": {
              "dataset_id": "…",
              "source_id": "sec.companyfacts_bulk",
              "source_url": "https://data.sec.gov/api/xbrl/companyfacts/CIK0000320193.json",
              "source_date": "2026-10-16",
              "schema_version": "1.0.0",
              "validation_status": "passed",
              "record_id": "cik:0000320193:revenue:annual:2024-09-28"
            }
          }
        ]
      }
    ]
  },
  "meta": {
    "datasets": [
      { "dataset_id": "…", "published_at": "2026-10-17T06:10:00Z", "freshness": "fresh" }
    ]
  }
}

The value is Apple's fiscal 2024 revenue as filed in its 10-K, with the XBRL concept it was tagged with, the accession number and a link to the filing index. GET /v1/sec/companies/search?ticker=AAPL resolves a ticker to a CIK (ein= resolves an EIN), and GET /v1/sec/financials/compare lines one metric up across companies.

Coverage and refresh

Coverage: SEC registrants in the EDGAR submissions archive, with tickers as mapped by the SEC.

  • As filed: the latest filed value, with the first reported value shown on restatement (is_restated).
  • Annual values from 10-K / 10-K/A (FY); quarterly from 10-Q / 10-Q/A (Q1-Q3, no Q4). Fiscal years are each company's own.

Refresh: Nightly EDGAR bulk archives (stale after 3 days).

Price

Every Olympus plan includes the US SEC Filings & Financial Data API and every other live API. The Free plan (no card) gives 1,000 requests a month to each live API at 10 requests a minute. Paid plans: Developer $79 a month (50,000 requests per API), Growth $299 a month (250,000 requests per API), Business $999 a month (1,000,000 requests per API); Enterprise from $2,500 a month on request. Prices in USD; see pricing for rate limits and what counts as a request.

Docs

Questions

Does SEC EDGAR have an API?

Yes. data.sec.gov serves the submissions (filing history) and XBRL APIs (companyconcept, companyfacts and frames) as JSON, plus nightly bulk zip files.

Is the SEC EDGAR API free?

Yes. The SEC says anyone can access and download EDGAR data for free, and the APIs need no key. Requests are limited to 10 a second.

What does the Olympus SEC API add?

Eight standardised metrics with annual and quarterly history, the concept each value came from, restatement flags (is_restated), lookup by ticker or EIN, and cross-company comparison.

Does it include full-text search or insider trading?

No. Real-time streams, full-text filing search, insider trading, ownership and recommendations are not included. The SEC's own EDGAR full-text search covers filings since 2001.

Sources