You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+191-64
Original file line number
Diff line number
Diff line change
@@ -1,36 +1,38 @@
1
1
# SEC API - A SEC.gov EDGAR Filings Query & Real-Time Stream API
2
2
3
-
**sec-api** is a Python package allowing you to search the entire SEC EDGAR filings corpus and access petabytes of regulatory information published by public and private companies, insiders such as directors and board members, hedge and mutual funds, financial advisors, business development companies, and more.
3
+
**sec-api** is a Python package allowing you to search the entire SEC EDGAR filings corpus and access petabytes of regulatory information published by public and private companies, insiders such as directors and board members, hedge and mutual funds, financial advisors, business development companies, and more. It includes:
4
4
5
-
It includes:
6
-
7
-
**EDGAR Filing Search & Download**
5
+
**EDGAR Filing Search & Download APIs**
8
6
9
7
-[SEC Filing Search and Full-Text Search API](#sec-edgar-filings-query-api)
> See the documentation for more details: https://sec-api.io/docs/full-text-search-api
156
160
157
-
## Filing Render & Download API
161
+
## Filing & Exhibit Download API
158
162
159
-
Used to download any filing or exhibit. You can process the downloaded filing in memory or save the filing to your hard drive.
163
+
Download any SEC EDGAR filing, exhibit and attached file in its original format (HTML, XML, JPEG, Excel, text, PDF, etc.). The API supports downloading all EDGAR form types, including 10-K, 10-Q, 8-K, 13-F, S-1, 424B4, and many others published since 1993 and provides access to over 18 million filings and over 100 million exhibits and filing attachments. Download up to 40 files per second.
Find the most recently disclosed Form 13F filings that include Tesla as a holding.
701
+
Access Form 13F holdings in structured JSON format, including information on current and historical portfolio holdings of SEC-registered funds and investment managers, including issuer name, title of the securities class, CUSIP, CIK and ticker of the holding, value of the position in dollar, the number of shares held, investment discretion, voting authority, and more.
> See the documentation for more details: https://sec-api.io/docs/form-13-f-filings-institutional-holdings-api
722
+
723
+
## Form 13F Cover Pages API
724
+
725
+
Search and access cover pages of Form 13F filings in standardized JSON format. Cover pages include details about the investment manager and fund, such as CIK, SEC file and CRD number, name, address, report type, other managers, and more.
"query": "cik:1698218 AND periodOfReport:[2023-01-1 TO 2024-12-31]",
734
+
"from": "0",
735
+
"size": "10",
736
+
"sort": [{ "filedAt": { "order": "desc" }}]
737
+
}
738
+
739
+
response = form13FCoverPagesApi.get_data(query)
740
+
cover_pages = response["data"]
741
+
742
+
print(cover_pages)
694
743
```
695
744
696
-
> See the documentation for more details: https://sec-api.io/docs/query-api/13f-institutional-ownership-api
745
+
> See the documentation for more details: https://sec-api.io/docs/form-13-f-filings-institutional-holdings-api
697
746
698
747
## Form 13D/13G API
699
748
@@ -782,20 +831,54 @@ from sec_api import FormNportApi
782
831
783
832
nportApi = FormNportApi("YOUR_API_KEY")
784
833
785
-
response=nportApi.get_data(
786
-
{
787
-
"query": "fundInfo.totAssets:[100000000 TO *]",
788
-
"from": "0",
789
-
"size": "10",
790
-
"sort": [{"filedAt": {"order": "desc"}}],
791
-
}
792
-
)
834
+
search_params= {
835
+
"query": "fundInfo.totAssets:[100000000 TO *]",
836
+
"from": "0",
837
+
"size": "10",
838
+
"sort": [{"filedAt": {"order": "desc"}}],
839
+
}
840
+
841
+
response = nportApi.get_data(search_params)
793
842
794
843
print(response["filings"])
795
844
```
796
845
797
846
> See the documentation for more details: https://sec-api.io/docs/n-port-data-api
798
847
848
+
## Form N-PX Proxy Voting Records API
849
+
850
+
The Form N-PX API consists of two APIs: the N-PX Search API and the Voting Records API. The N-PX Search API enables filtering all N-PX filings published on the SEC EDGAR database since 2024. The API accepts search queries as JSON formatted payload and returns the matching N-PX filings in JSON format. The Voting Records API allows downloading the proxy voting records in structured JSON format for a specific filing by providing the filing's accession number.
851
+
852
+
```python
853
+
from sec_api import FormNPXApi
854
+
855
+
formNpxApi = FormNPXApi("YOUR_API_KEY")
856
+
857
+
search_params = {
858
+
"query": "cik:884546",
859
+
"from": "0",
860
+
"size": "1",
861
+
"sort": [{"filedAt": {"order": "desc"}}],
862
+
}
863
+
864
+
# get N-PX filing metadata: registrant type, investment company type,
865
+
# series and class IDs, report type, period of report, and more
> See the documentation for more details: https://sec-api.io/docs/form-npx-proxy-voting-records-api
881
+
799
882
## Form S-1/424B4 API
800
883
801
884
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).
@@ -1102,27 +1185,27 @@ print(response["data"])
1102
1185
}
1103
1186
```
1104
1187
1105
-
## AAER Database API
1188
+
## SEC Enforcement Actions Database API
1106
1189
1107
-
Access and search the Accounting and Auditing Enforcement Releases (AAER) database. The database includes all AAERs filed from 1997 to present.
1190
+
Access and search SEC enforcement actions published from 1997 to present. The database includes information about the parties involved in the action, nature of charges and complaints, penalty amounts, requested reliefs, violated rules and regulations, and more.
> See the documentation for more details: https://sec-api.io/docs/aaer-database-api
1208
+
> See the documentation for more details: https://sec-api.io/docs/sec-enforcement-actions-database-api
1126
1209
1127
1210
## SEC Litigation Releases Database API
1128
1211
@@ -1146,6 +1229,50 @@ print(response["data"])
1146
1229
1147
1230
> See the documentation for more details: https://sec-api.io/docs/sec-litigation-releases-database-api
1148
1231
1232
+
## SEC Administrative Proceedings Database API
1233
+
1234
+
Access and search all 18,000+ administrative proceedings filed by the SEC from 1995 to present. The database includes information about respondents (name, CIK, ticker), type of proceeding, publication dates, complaints and orders, violated rules and regulations, disgorgement amounts, penalties, and more.
1235
+
1236
+
```python
1237
+
from sec_api import SecAdministrativeProceedingsApi
> See the documentation for more details: https://sec-api.io/docs/sec-administrative-proceedings-database-api
1253
+
1254
+
## AAER Database API
1255
+
1256
+
Access and search the Accounting and Auditing Enforcement Releases (AAER) database. The database includes all AAERs filed from 1997 to present.
1257
+
1258
+
```python
1259
+
from sec_api import AaerApi
1260
+
1261
+
aaerApi = AaerApi("YOUR_API_KEY")
1262
+
1263
+
query = {
1264
+
"query": "dateTime:[2012-01-01 TO 2020-12-31]",
1265
+
"from": "0",
1266
+
"size": "50",
1267
+
"sort": [{"dateTime": {"order": "desc"}}],
1268
+
}
1269
+
1270
+
response = aaerApi.get_data(query)
1271
+
print(response["data"])
1272
+
```
1273
+
1274
+
> See the documentation for more details: https://sec-api.io/docs/aaer-database-api
1275
+
1149
1276
## SRO Filings Database API
1150
1277
1151
1278
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.
0 commit comments