Skip to content

Commit ae11f25

Browse files
added Form S-1/424B4 API
added Directors & Board Members Data API added AAER API added SRO Filings API
1 parent 4135673 commit ae11f25

4 files changed

Lines changed: 347 additions & 51 deletions

File tree

README.md

Lines changed: 138 additions & 39 deletions
Original file line numberDiff line numberDiff line change
@@ -1,41 +1,62 @@
11
# SEC API - A SEC.gov EDGAR Filings Query & Real-Time Stream API
22

3-
**sec-api** is a Python package allowing you to search the entire SEC filings corpus and access over 650 terabytes of data.
3+
**sec-api** is a Python package allowing you to search the entire SEC filings corpus and access over 650 terabytes of data. It includes:
44

5-
It includes:
5+
**General APIs:**
66

77
- [SEC Filing Search and Full-Text Search API](#sec-edgar-filings-query-api)
8-
- [Real-Time Stream API](#sec-edgar-filings-real-time-stream-api)
8+
- [Real-Time Filing Stream API](#sec-edgar-filings-real-time-stream-api)
9+
- [Filing Download & PDF Render API](#filing-render--download-api)
10+
11+
**Converter & Extractor APIs:**
12+
913
- [XBRL-to-JSON Converter API + Financial Statements](#xbrl-to-json-converter-api)
1014
- [10-K/10-Q/8-K Section Extraction API](#10-k10-q8-k-section-extractor-api)
11-
- [Filing Download & PDF Render API](#filing-render--download-api)
15+
16+
**Directors, Executives and Board Members:**
17+
18+
- [Directors & Board Members API](#directors--board-members-data-api)
1219
- [Executive Compensation Data API](#executive-compensation-data-api)
13-
- [Insider Trading Data API](#insider-trading-data-api)
14-
- [13F Institutional Investor Database](#13f-institutional-investor-database)
20+
21+
**Ownership Data APIs:**
22+
23+
- [Form 3/4/5 API - Insider Trading](#insider-trading-data-api)
24+
- [Form 13F API - Institutional Investment Manager Holdings](#13f-institutional-investor-database)
25+
- [Form 13D/13G API - Activist and Passive Investor Holdings](#form-13d-13g-api)
26+
- [Form N-PORT API - Mutual Fund Holdings](#form-n-port-api)
27+
28+
**Security Offerings APIs:**
29+
30+
- [Form S-1/424B4 API - Registration Statements and Prospectuses (IPOs, Debt/Warrants/... Offerings)](#form-s-1424b4-api)
31+
- [Form D API - Private Security Offerings](#form-d-api)
32+
33+
**Investment Advisers:**
34+
35+
- [Form ADV API - Investment Advisors (Firm & Indvl. Advisors, Brochures, Schedules)](#form-adv-api)
36+
37+
**Other APIs:**
38+
1539
- [CUSIP/CIK/Ticker Mapping API](#cusipcikticker-mapping-api)
16-
- [Form N-PORT API](#form-n-port-api)
17-
- [Form D API](#form-d-api)
18-
- [Form ADV API](#form-adv-api)
19-
- [Form 13D/13G API](#form-13d-13g-api)
2040
- [Float (Outstanding Shares) API](#float-outstanding-shares-api)
21-
- [Subsidiary API](#subsidiary-api)
41+
- [Company Subsidiary API](#subsidiary-api)
42+
- [AAER Database API - Accounting and Auditing Enforcement Releases](#aaer-database-api)
43+
- [SRO Filings Database API](#sro-filings-database-api)
2244

2345
## Data Coverage
2446

25-
- All +18 million SEC EDGAR filings dating back to 1993 - 650,000 gigabyte of filings data.
26-
- **All +150 filing types** are supported, eg 10-Q, 10-K, 4, 8-K, 13-F, S-1, 424B4 and many more.
27-
[See the list of supported form types here.](https://sec-api.io/list-of-sec-filing-types)
28-
- Newly published filings are accessible in real-time
29-
- XBRL-to-JSON converter and parser API. Extract standardized financial statements from any 10-K and 10-Q filing.
30-
- 13F holdings API included. Monitor all institutional ownerships in real-time.
31-
- Every filing is **mapped to a CIK and ticker**
32-
- All filings in JSON - **no XBRL/XML**
47+
- Access to over 18 million SEC EDGAR filings from 1993 to the present, encompassing 650,000+ gigabytes of data.
48+
- Supports all 150+ filing types, including 10-Q, 10-K, Form 4, 8-K, 13-F, S-1, 424B4, and many others. [See the full list of supported form types here.](https://sec-api.io/list-of-sec-filing-types)
49+
- Real-time access to newly published filings.
50+
- Includes XBRL-to-JSON converter and parser APIs for extracting standardized financial statements from any 10-K or 10-Q filing.
51+
- 13F Holdings API provided, allowing real-time monitoring of institutional ownership.
52+
- Every filing is linked to its corresponding CIK and ticker.
53+
- All filings available in JSON format — no need for XBRL/XML parsing.
3354

3455
## Overview
3556

36-
- The query API gives access to all over 18 million SEC Edgar filings of **over 8000** publicly listed companies, ETFs, hedge funds, mutual funds, and investors dating back to 1993.
57+
- The Query API gives access to all over 18 million SEC EDGAR filings of over 8,000 publicly listed companies, ETFs, hedge funds, mutual funds, and investors dating back to 1993.
3758
- Connect to the real-time stream API to receive new filings as soon as they are published on SEC EDGAR
38-
- The full-text search API allows you to search the full text of all filings submitted since 2001. The full text of a filing includes all data in the filing itself as well as all attachments (such as exhibits) to the filing.
59+
- The Full-Text Search API allows you to search the full text of all filings submitted since 2001. The full text of a filing includes all data in the filing itself as well as all attachments (such as exhibits) to the filing.
3960
- Free API key available on [sec-api.io](https://sec-api.io)
4061

4162
See the official documentation for more: [sec-api.io/docs](https://sec-api.io/docs)
@@ -105,8 +126,7 @@ filings = queryApi.get_filings(query)
105126
106127
## SEC EDGAR Filings Real-Time Stream API
107128

108-
The Stream API provides a live stream (aka feed) of newly published filings on SEC EDGAR via WebSockets.
109-
A new filing is sent to your connected client as soon as it is published.
129+
The Stream API provides a live stream (aka feed) of newly published filings on SEC EDGAR via WebSockets. A new filing is sent to your connected client as soon as it is published.
110130

111131
---
112132

@@ -176,7 +196,7 @@ print(filings)
176196
177197
## XBRL-To-JSON Converter API
178198

179-
Parse and standardize any XBRL and convert it to JSON or pandas dataframes. Extract financial statements and meta data from 10-K and 10-Q filings.
199+
Parse and standardize any XBRL and convert it to JSON or pandas dataframes. Extract financial statements and metadata from 10-K, 10-Q and any other SEC filing supporting XBRL.
180200

181201
The entire US GAAP taxonomy is fully supported. All XBRL items are fully converted into JSON, including `us-gaap`, `dei` and custom items. XBRL facts are automatically mapped to their respective context including period instants and date ranges.
182202

@@ -580,6 +600,28 @@ result4 = mappingApi.resolve("exchange", "NASDAQ")
580600

581601
> See the documentation for more details: https://sec-api.io/docs/mapping-api
582602
603+
## Directors & Board Members Data API
604+
605+
Access and search the entire database of all directors and board members of all publicly listed companies on US stock exchanges. The database includes information about the CIK, ticker and company name the director is associated with, the name of the director, her/his age, position, director class, date of first election, independence status, committee memberships as well as qualifications and experiences.
606+
607+
```python
608+
from sec_api import DirectorsBoardMembersApi
609+
610+
directorsBoardMembersApi = DirectorsBoardMembersApi("YOUR_API_KEY")
611+
612+
query = {
613+
"query": "ticker:AMZN",
614+
"from": 0,
615+
"size": 50,
616+
"sort": [{"filedAt": {"order": "desc"}}],
617+
}
618+
619+
response = directorsBoardMembersApi.get_data(query)
620+
print(response["data"])
621+
```
622+
623+
> See the documentation for more details: https://sec-api.io/docs/directors-and-board-members-data-api
624+
583625
## Executive Compensation Data API
584626

585627
The API provides standardized compensation data of all key executives as reported in SEC filing DEF 14A. The dataset is updated in real-time.
@@ -636,12 +678,7 @@ result_query = execCompApi.get_data(query)
636678
637679
## Insider Trading Data API
638680

639-
The Insider Trading Data API allows you to search and list all insider buy and sell transactions of all publicly listed
640-
companies on US stock exchanges. Insider activities of company directors, officers, 10% owners and other executives are
641-
fully searchable. The insider trading database includes information about the CIK and name of the insider,
642-
her/his relationship to the company, the number of shares and securities purchased or sold, the purchase or selling price,
643-
the date of the transaction, the amount of securities held before and after the transaction occured, any footnotes such
644-
as the effect of Rule 10b-18 or 10b5-1 stock purchase plans and more. The full list of all data points is available below.
681+
The Insider Trading Data API allows you to search and list all insider buy and sell transactions of all publicly listed companies on US stock exchanges. Insider activities of company directors, officers, 10% owners and other executives are fully searchable. The insider trading database includes information about the CIK and name of the insider, her/his relationship to the company, the number of shares and securities purchased or sold, the purchase or selling price, the date of the transaction, the amount of securities held before and after the transaction occured, any footnotes such as the effect of Rule 10b-18 or 10b5-1 stock purchase plans and more. The full list of all data points is available below.
645682

646683
```python
647684
from sec_api import InsiderTradingApi
@@ -736,10 +773,29 @@ print(response["filings"])
736773

737774
> See the documentation for more details: https://sec-api.io/docs/n-port-data-api
738775
776+
## Form S-1/424B4 API
777+
778+
Access and find structured and standardized data extracted from S-1, F-1, and S-11 registration statements as well as 424B4 prospectus filings. The JSON data includes public offering prices, underwriting discounts, proceeds before expenses, security types being offered, underwriters (lead and co-managers), law firms, auditors, employee counts and management information (name, age, position).
779+
780+
```python
781+
form_s1_424B4_api = Form_S1_424B4_Api("YOUR_API_KEY")
782+
783+
query = {
784+
"query": "ticker:V",
785+
"from": "0",
786+
"size": "50",
787+
"sort": [{"filedAt": {"order": "desc"}}],
788+
}
789+
790+
response = form_s1_424B4_api.get_data(query)
791+
print(response["data"])
792+
```
793+
794+
> See the documentation for more details: https://sec-api.io/docs/form-s1-424b4-data-search-api
795+
739796
## Form D API
740797

741-
Search and find Form D offering filings by any filing property, e.g. total offering amount, offerings filed by
742-
hedge funds, type of securities offered and many more.
798+
Search and find Form D offering filings by any filing property, e.g. total offering amount, offerings filed by hedge funds, type of securities offered and many more.
743799

744800
```python
745801
from sec_api import FormDApi
@@ -762,11 +818,7 @@ print(response["offerings"])
762818
763819
## Form ADV API
764820

765-
Search the entire ADV filing database and find all ADV filings filed by firm advisers (SEC and state registered),
766-
individual advisers and firm brochures published in part 2 of ADV filings. The database comprises 41,000 ADV filings
767-
filed by advisory firms and 380,000 individual advisers and is updated daily.
768-
Search and find ADV filings by any filing property, such as CRD, assets under management,
769-
type of adviser (e.g. broker dealer) and more. Direct owners from Schedule A, indirect owners from Schedule B as well as private funds from Schedule D are easily accessible.
821+
Search the entire Form ADV filing database and find all ADV filings filed by firm advisers (SEC and state registered), individual advisers and firm brochures published in part 2 of ADV filings. The database comprises 41,000 ADV filings filed by advisory firms and 380,000 individual advisers and is updated daily. Search and find ADV filings by any filing property, such as CRD, assets under management, type of adviser (e.g. broker dealer) and more. Direct owners from Schedule A, indirect owners from Schedule B as well as private funds from Schedule D are easily accessible.
770822

771823
```python
772824
from sec_api import FormAdvApi
@@ -1006,6 +1058,50 @@ print(response["data"])
10061058
}
10071059
```
10081060

1061+
## AAER Database API
1062+
1063+
Access and search the Accounting and Auditing Enforcement Releases (AAER) database. The database includes all AAERs filed from 1997 to present.
1064+
1065+
```python
1066+
from sec_api import AaerApi
1067+
1068+
aaerApi = AaerApi("YOUR_API_KEY")
1069+
1070+
query = {
1071+
"query": "dateTime:[2012-01-01 TO 2020-12-31]",
1072+
"from": "0",
1073+
"size": "50",
1074+
"sort": [{"dateTime": {"order": "desc"}}],
1075+
}
1076+
1077+
response = aaerApi.get_data(query)
1078+
print(response["data"])
1079+
```
1080+
1081+
> See the documentation for more details: https://sec-api.io/docs/aaer-database-api
1082+
1083+
## SRO Filings Database API
1084+
1085+
Access and search all SRO filings published from 1995 to present. The database includes more than 30,000 SRO filings from all types of organizations, including National Securities Exchanges (NYSE, NASDAQ, CBOE, etc.), Joint Industry Plans, FINRA, Futures Exchanges (CME, CBOT, etc.), and more.
1086+
1087+
```python
1088+
from sec_api import SroFilingsApi
1089+
1090+
sroFilingsApi = SroFilingsApi("YOUR_API_KEY")
1091+
1092+
query = {
1093+
"query": "sro:NASDAQ",
1094+
"from": "0",
1095+
"size": "10",
1096+
"sort": [{"issueDate": {"order": "desc"}}],
1097+
}
1098+
1099+
response = sroFilingsApi.get_data(query)
1100+
print(response["data"])
1101+
```
1102+
1103+
> See the documentation for more details: https://sec-api.io/docs/sro-filings-database-api
1104+
10091105
## Proxy Support
10101106

10111107
In certain cases, your corporate IT infrastructure may encounter issues with HTTPS requests, leading to SSL certificate errors. To resolve this, HTTP and HTTPS proxies can be passed into all API wrappers as shown in the example below. If you're unsure about which proxies to use, please consult your company's IT administrator.
@@ -1038,6 +1134,10 @@ renderApi = RenderApi(api_key="YOUR_API_KEY", proxies=proxies)
10381134
- `filedAt` (string) - The date (format: YYYY-MM-DD HH:mm:SS TZ) the filing was filed, eg 2019-12-06T14:41:26-05:00.
10391135
- `periodOfReport` (string, if reported) - Period of report, e.g. 2021-06-08
10401136
- `effectivenessDate` (string, if reported) - Effectiveness date, e.g. 2021-06-08
1137+
- `registrationForm` (string, if reported) - Registration form as reported on EFFECT forms, e.g. S-1
1138+
- `referenceAccessionNo` (string, if reported) - Reference accession number as reported on EFFECT forms, e.g. 0001213900-22-001446
1139+
- `items` (array of strings, if reported) - Items represents an array of item strings as reported on form 8-K, 8-K/A, D, D/A, ABS-15G, ABS-15G/A, 1-U, 1-U/A. For example: `["Item 3.02: Unregistered Sales of Equity Securities", "Item 9.01: Financial Statements and Exhibits"]`
1140+
- `groupMembers` (array, if reported) - Group members represents an array of member strings as reported on SC 13G, SC 13G/A, SC 13D, SC 13D/A filings, e.g. `[ "ALEC N. LITOWITZMAGNETAR CAPITAL PARTNERS LPSUPERNOVA MANAGEMENT LLC" ]`
10411141
- `id` (string) - Unique ID of the filing.
10421142
- `entities` (array) - A list of all entities referred to in the filing. The first item in the array always represents the filing issuer. Each array element is an object with the following keys:
10431143
- `companyName` (string) - Company name of the entity, e.g. DILLARD'S, INC. (Issuer)
@@ -1216,7 +1316,6 @@ renderApi = RenderApi(api_key="YOUR_API_KEY", proxies=proxies)
12161316

12171317
## Contact
12181318

1219-
Let us know how we can improve the library or if you have any feature
1220-
suggestions. We're happy to implement them.
1319+
Let us know how we can improve the library or if you have any feature suggestions. We're happy to implement them.
12211320

12221321
support@sec-api.io

0 commit comments

Comments
 (0)