Skip to content

Python script to query SEC API for "Item 1.05" to find cybersecurity incident disclosures of public companies.

License

Notifications You must be signed in to change notification settings

BadSamuraiDev/sec-item-1.05

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SEC Item 1.05 API Query

This script queries the SEC API for filings with a "Item 1.05" in the full text search and matches tickers from a watchlist. Ideally this script would be run on an interval (mind the API limits!) against a list populated manually or by a 3rd party risk job.

By default the script will search between the current date and 30 days ago. This can be changed by modifying the start_date and end_date variables in the API body.

Usage:

  python sec-item-1.05.py --token YOUR_API_TOKEN          # Run the script with an API token.
  python sec-item-1.05.py --debug --token YOUR_API_TOKEN  # Run the script in debug mode with an API token.
  python sec-item-1.05.py --debug                         # Run the script in debug mode, you'll be prompted for the API token.
  python sec-item-1.05.py --token YOUR_API_TOKEN --watchlist MY_WL.yaml --output MY_OUTPUT.json

Options:

  --token     Provide the SEC API token. If omitted, the script will prompt for it.
  --debug     Enable debug mode for additional output useful for troubleshooting.
  --watchlist Provide a different watchlist file. If omitted, the script will use the default.
  --output    Provide a different output file. If omitted, the script will print to console.
  --help      Show this message and exit.
  --readme    Show the README and exit.

Resources:

About

Python script to query SEC API for "Item 1.05" to find cybersecurity incident disclosures of public companies.

Topics

Resources

License

Stars

Watchers

Forks

Languages