Best SEC EDGAR API: free, paid and parsed

The SEC's own EDGAR API is free and needs no key, but it returns raw XBRL facts, not clean statements, filing text or insider tables. This page compares it with 12 filings APIs, for the US and for Japan, Korea and Taiwan.

Is the SEC EDGAR API free?

Yes. The SEC says its APIs on data.sec.gov need no authentication and no API key. You must send a User-Agent header that names your company and an email address, and the SEC's fair-access rule sets a maximum of 10 requests a second. It may lower that to keep access fair, and the pages do not say what happens above 10 a second.

The endpoints are submissions (a company's filing history by 10-digit CIK), companyfacts (every XBRL fact one company reported), companyconcept (one fact for one company) and frames (one fact for every company in a calendar period). Two nightly zip files hold all companyfacts and all submissions. Browsers cannot call these endpoints: there is no CORS support.

What the EDGAR API does not give you

  • 10-K and 10-Q text. The API returns filing history and XBRL numbers; the documents sit on sec.gov and you parse them yourself.
  • Standard statements. Companyfacts uses each company's own XBRL tags, so revenue is one tag for Apple and another for a bank. You map the tags.
  • 13F holdings and insider trades as tables. The SEC publishes 13F data sets and Financial Statement Data Sets as free quarterly zip files. Form 4 insider filings are XML documents you parse.
  • Anything outside the US. Japan, Korea and Taiwan each have their own registry, listed in the table below.

Call the EDGAR API from Python

This reads Apple's reported net income. Replace the User-Agent with your own name and email, or the SEC will block the request.

Python
import requests

# Change: the User-Agent (your name and email)
headers = {"User-Agent": "Your Name your@email.com"}
url = "https://data.sec.gov/api/xbrl/companyfacts/CIK0000320193.json"
facts = requests.get(url, headers=headers, timeout=20).json()

net_income = facts["facts"]["us-gaap"]["NetIncomeLoss"]["units"]["USD"]
print(net_income[-1])  # the latest reported value, with period and form

When a paid or parsed API is worth it

Stay on EDGAR when you need the source of record, one company at a time, and can map tags. Pay for a parsed API when you need the same statement items for many companies, filing text split by item, 13F or insider rows ready to query, or more than one country. The table below shows what each provider charges and what it parses.

The easy Narwhal call

Narwhal reads EDGAR and returns standard annual and quarterly statements as JSON with the same item names for every company. Search by name to get the company id (Apple is usa:0000320193), then read its financials. The same two calls work for Japanese and Korean companies.

A free Narwhal key comes with $10 of credit every month for the first 12 months, no card. After that a call costs $2 per 1,000 ($10 per 1,000 for company and filings data).

GET /v1/companies/usa:0000320193/financials
# Change: URL and key
url="https://api.narwhalapi.com"
url="$url/v1/companies/usa:0000320193/financials"
curl \
  "$url" \
  -H "Authorization: Bearer YOUR_API_KEY"

Provider shortlist

Official sources return files or raw facts, and the other providers return parsed statements, so this is a comparison of what you get back as well as of price. Rival facts were read from public pages without an account, so limits that appear only after sign-up may differ. Counts and prices change. This page is published by Narwhal.

Narwhal API

Standardised statements for the US, Japan, Korea, Taiwan, the EU and the UK under one key, with REST and MCP

Explore Narwhal product

SEC EDGAR APIs

US filing history and XBRL facts straight from the regulator, free

EDINET API

Original Japanese filings as XBRL, PDF and CSV files

Read detailed comparison

OpenDART

Korean filings and full statements from the regulator, as JSON or XML

Read detailed comparison

J-Quants API

Tokyo prices and market data, with Japanese statements on the top plan

Read detailed comparison

FinMind

Taiwan market data and statements from a Taiwan developer platform

Read detailed comparison

TEJ

Deep Taiwan and Asian data for institutions

Read detailed comparison

Intrinio

US fundamentals with as-reported and standardised statements back to 2006

Read detailed comparison

Calcbench

As-reported XBRL detail in US filings, for analysts

Read detailed comparison

SimFin

US fundamentals on a small budget, with bulk CSV downloads

Read detailed comparison

sec-api.io

Raw EDGAR work: search, full-text search, downloads and a live stream

Read detailed comparison

Financial Modeling Prep

US-first prices and fundamentals, with statements for more countries on the top plan

Read detailed comparison

EODHD

Prices and fundamentals across many exchanges

Read detailed comparison

Compare the options

Best fit is not feature parity. Check the evidence and limitation together.

ProviderBest forEvidence checkedImportant limitation
Narwhal APIStandardised statements for the US, Japan, Korea, Taiwan, the EU and the UK under one key, with REST and MCPUS from 2009. Japan has over 3,800 companies, annual and semiannual. Korea covers about half of listed companies so far. Taiwan has about 1,980 companies, 2026 half-year reports. The EU and EEA have about 3,200 companies in 26 countries, annual only. The UK has about 800 companies, annual only. Company and filings data cost $10 per 1,000 calls, with $10 free every month.No full-text search of filings and no share prices. Korea is partial, and Taiwan, the EU and the UK hold only the periods loaded so far.
SEC EDGAR APIsUS filing history and XBRL facts straight from the regulator, freeUS only. data.sec.gov returns JSON for each filer's submissions and for XBRL facts by company, concept and period. It needs no key and states no price. Fair access allows 10 requests a second.You assemble statements from XBRL facts yourself, and the API returns no filing documents.
EDINET APIOriginal Japanese filings as XBRL, PDF and CSV filesJapan. The list of filings by submission date holds 10 years. Files come as ZIP packages, PDF and CSV. A registered key is required and the specification states no price.No parsed statements. The specification is in Japanese, and the terms bar heavy access in a short time.
OpenDARTKorean filings and full statements from the regulator, as JSON or XMLKorea. Statements from 2015. Free in principle with a registered key. The request limit error normally appears above 20,000 requests.Account names are in Korean. A filing search without a company code covers at most 3 months.
J-Quants APITokyo prices and market data, with Japanese statements on the top planJapan. A free plan delayed 12 weeks, then Light 1,650 yen, Standard 3,300 yen and Premium 16,500 yen a month. Full statements come with Premium, from 2009.Aimed at individuals. Corporate use goes through J-Quants Pro, and no price is given.
FinMindTaiwan market data and statements from a Taiwan developer platformTaiwan, plus price data for some other markets. A free plan at 300 calls an hour. Backer NT$699, Sponsor NT$999 and Sponsor Pro NT$3,330 a month. Income statements from 1990.Commercial use only on Sponsor Pro. Reselling raw data is barred on every plan.
TEJDeep Taiwan and Asian data for institutionsTaiwan and eight other Asian markets. A trial key allows 500 calls a day. The API price is not published. The E Shop lists plans at 488, 888 and 8,880 a month, with no currency stated.Paid access runs through sales. The API documentation page is dated 7 May 2019.
IntrinioUS fundamentals with as-reported and standardised statements back to 2006US. Individual $150 a month, for personal use. Startup from $333 a month, $999 after a year. Enterprise from $1,250 a month. API, CSV, Snowflake and S3.No price per call and no country outside the US.
CalcbenchAs-reported XBRL detail in US filings, for analystsUS. Basic is free. Premium costs $6,000 and Professional $12,000 a year per user. A web platform, an Excel add-in and an API.API access is not part of the standard subscription.
SimFinUS fundamentals on a small budget, with bulk CSV downloadsAbout 5,000 US stocks. A free plan, then Start $15, Basic $35 and Pro $71 a month, billed yearly. A web API, Python, Excel and CSV.Its prices page lists US stocks and its home page also mentions European stocks. Commercial projects need an Enterprise quote.
sec-api.ioRaw EDGAR work: search, full-text search, downloads and a live streamUS, from 1993. A free key stops after 100 calls in total. Personal $49 a month ($588 billed yearly) and Business $199 a month ($2,388 billed yearly). XBRL-to-JSON on every plan.SEC forms only. Full-Text Search starts on the Business plan.
Financial Modeling PrepUS-first prices and fundamentals, with statements for more countries on the top planStarter $19, Premium $49 and Ultimate $99 a month billed yearly. Statement symbols cover the US on Starter, the US, UK and Canada on Premium, and every country on Ultimate.Displaying or redistributing the data needs a separate licensing agreement.
EODHDPrices and fundamentals across many exchangesThe Fundamentals plan costs $59.99 a month ($599.90 billed yearly). Fundamentals go back to 1985 for major US companies and to 2000 for non-US firms. Each fundamentals request uses 10 calls.SEC 8-K, 10-K and 10-Q filings come only with the All-In-One plan at $99.99 a month.

Choose by requirement

Start from the country

For the US, look at SEC EDGAR, Narwhal, sec-api.io, Intrinio, Calcbench and SimFin. For Japan, look at EDINET, J-Quants and Narwhal. For Korea, look at OpenDART and Narwhal. For Taiwan, look at FinMind, TEJ and Narwhal. For the EU, the EEA and the UK, Narwhal reads annual reports from regulated markets, and FMP and EODHD cover many countries through one price list.

Choose between original files and parsed statements

EDINET returns XBRL, PDF and CSV files, OpenDART returns statements with Korean account names, and SEC EDGAR returns XBRL facts. Narwhal, Intrinio, FMP, EODHD, SimFin and FinMind return statements in their own schema. Calcbench returns as-reported XBRL data with standardised metrics.

Price the calls at your volume

Narwhal charges $10 per 1,000 calls. Intrinio, Calcbench, SimFin, J-Quants and sec-api.io sell monthly or yearly plans, and TEJ publishes no API price. SEC EDGAR is free, EDINET states no price, and OpenDART is free in principle.

Check commercial use before you ship

J-Quants is aimed at individuals, FinMind allows commercial use only on Sponsor Pro, the Intrinio Individual plan is for personal use, and SimFin sends commercial projects to an Enterprise tariff. Narwhal allows commercial apps on every account.

Check the history you need

EDINET lists filings back 10 years, OpenDART statements start in 2015, and Intrinio reaches back to 2006. Narwhal starts US history in 2009, and its Taiwan, EU and UK coverage holds only the periods loaded so far.

Each detailed provider page lists the first-party documentation used, its evidence boundaries, and its review date. Reviewed:

Sources and review date