sec.gov EDGAR filings real-time API

• Covers SEC Edgar filings for over 8000 publicly listed companies, ETFs, hedge funds, mutual funds, and investors.
• Every filing is mapped to a CIK and ticker.
• Over 150 form types are supported, eg 10-Q, 10-K, 4, 8-K, 13-F and many more. See the list of supported form types here.
• The API returns a new filing as soon as it is published on SEC EDGAR.
• No XBRL/XML needed - JSON formatted.
• Python, R, Java, C++, Excel scripts are supported through websockets
• Client- and server-side JavaScript supported (Node.js, React, React Native, Angular, Vue, etc.)
• Free API key available on sec-api.io

The official documentation explains how to use the query API to filter historical filings: sec-api.io/docs

Data source: sec.gov

Getting Started

You can use the API in your command line, or develop your own application using the API as imported package. Both options are explained below.

Before you start:

• Install Node.js if you haven't already. On Mac in the command line type brew install node.
• Get your free API key here: sec-api.io

Command Line

In your command line, type

1. npm install sec-api -g to install the package
2. sec-api YOUR_API_KEY to connect to the stream. Replace YOUR_API_KEY with the API key provided on sec-api.io
3. Done! You will see new filings printed in your command line as soon as they are published on SEC EDGAR.

Node.js

Type in your command line:

1. mkdir my-project && cd my-project to create a new folder for your project.
2. npm init -y to set up Node.js boilerplate.
3. npm install sec-api to install the package.
4. touch index.js to create a new file. Copy/paste the example code below into the file index.js. Replace YOUR_API_KEY with the API key provided on sec-api.io

const api = require('sec-api')('YOUR_API_KEY');
api.on('filing', filing => console.log(filing));

5. node index.js to start listening for new filings. New filings are printed in your console as soon as they are published on SEC EDGAR.

Python

• Install the socket.io client: pip install "python-socketio[client]"
• Run the example script below. Get your free API key on sec-api.io and replace YOUR_API_KEY with it.

import socketio

sio = socketio.Client()

@sio.on('connect', namespace='/all-filings')
def on_connect():
    print("Connected to https://api.sec-api.io:3334/all-filings")

@sio.on('filing', namespace='/all-filings')
def on_filings(filing):
    print(filing)

sio.connect('https://api.sec-api.io:3334?apiKey=YOUR_API_KEY', namespaces=['/all-filings'])
sio.wait()

React

Live Demo: https://codesandbox.io/s/01xqz2ml9l (requires an API key to work)

import api from 'sec-api';

class Filings extends React.Component {
  componentDidMount() {
    const socket = api('YOUR_API_KEY');
    socket.on('filing', filing => console.log(filing));
  }

  // ...
}

Response Format

• id (string) - unique ID (md5 hash of link to original filing) of filing, eg e6a4da06fefffcaa65655b3b4602dd7f
• companyName (string) - name of company, e.g. Apple Inc.
• companyNameLong (string) - company name long format including original CIK and ownership type (Issuer, Reporting), e.g. Apple Inc. (0000320193) (Issuer)
• ticker (string) - ticker symbol of the company, e.g. AAPL
• cik (string) - CIK of company without trailing 0, e.g. 1001039
• formType (string) - sec.gov form type, e.g 10-K. See the list of all form types here: https://www.sec.gov/info/edgar/forms/edgform.pdf
• description (string) - description of filing, e.g. Statement of changes in beneficial ownership of securities
• linkToFilingDetails (string) - link to HTML or XML file of filing
• linkToTxt (string) - link to text version (.txt) of filing
• linkToHtml (string) - link to attachements of filing
• linkToXbrl (string) - link to XBRL file (in XML format) of filing. Is not set, if no XBRL file is attached to the original filing on EDGAR.
• filedAt (string) - ISO 8601 conform filing date and time, e.g. 2020-02-28T18:35:51-05:00

Example JSON Response

{
  "id": "4ca00d307b1e8d07dd1c75ae20ed0cb9",
  "cik": "320193",
  "ticker": "AAPL",
  "companyName": "Apple Inc.",
  "companyNameLong": "Apple Inc. (0000320193) (Issuer)",
  "formType": "4",
  "description": "Statement of changes in beneficial ownership of securities",
  "filedAt": "2020-02-28T18:35:51-05:00",
  "linkToTxt": "https://www.sec.gov/Archives/edgar/data/320193/000032019320000034/0000320193-20-000034.txt",
  "linkToHtml": "https://www.sec.gov/Archives/edgar/data/320193/000032019320000034/0000320193-20-000034-index.htm",
  "linkToXbrl": "",
  "linkToFilingDetails": "https://www.sec.gov/Archives/edgar/data/320193/000032019320000034/xslF345X03/wf-form4_158293293482087.xml"
}

Contact

Let me know how I can improve the library or if you have any feature suggestions. I'm happy to implement them.

Just open a new issue on github here: https://github.com/janlukasschroeder/sec-api/issues