SEC filing alerts and webhooks
Have new SEC filings sent to your server as they are published. Filter by form type, 8-K item, company, or a search query, or follow every filing change as a stream.
What you get
- Webhooks
- Create an HTTPS endpoint, then a subscription that says which filings to send. Each delivery is signed with your endpoint's secret, and you can retry one delivery or replay a time window.
- Search subscriptions
- A subscription holds the same parameters as full-text search, so it can match words as well as form types and 8-K items.
- A stream to follow
- GET /v3/stream returns every filing change after a cursor: new, updated, and corrected filings. When there are none, it waits up to 30 seconds.
- Test before you rely on it
- Send an endpoint one sample event, or preview what a subscription would have sent for filings of the last 7 days.
Example calls
Set SECBLAST_API_KEY to your key first.
Follow new 8-K filings with item 5.02 (changes of directors and officers), waiting up to 30 seconds for each batch:
import os
import requests
r = requests.get(
"https://api.secblast.com/v3/stream",
params={"forms": "8-K", "items": "5.02", "wait": "30", "limit": "10"},
headers={"Authorization": f"Bearer {os.environ['SECBLAST_API_KEY']}"},
timeout=30,
)
r.raise_for_status()
print(r.json())Or have the same filings sent to a webhook endpoint. Create the endpoint first with POST /v3/callbacks/endpoints and use its id:
import os
import requests
r = requests.post(
"https://api.secblast.com/v3/search/subscriptions",
headers={"Authorization": f"Bearer {os.environ['SECBLAST_API_KEY']}"},
json={
"name": "Executive changes (8-K item 5.02)",
"query": {
"forms": "8-K",
"items": "5.02",
},
"endpoint_id": "cbe_0123456789abcdef01234567",
},
timeout=30,
)
r.raise_for_status()
print(r.json())In the API reference
- GET /v3/streamFollow every filing change from a cursor.
- POST /v3/callbacks/endpointsCreate a webhook endpoint.
- POST /v3/search/subscriptionsCreate a search subscription.
- GET /v3/callbacks/deliveriesList your webhook deliveries, newest first.
Questions
- Webhook or stream?
- Use webhooks when SEC Blast should call your server. Use the stream when your program asks for new filings and keeps its own place with a cursor.
- How do I check that an event came from SEC Blast?
- Each event is signed with your endpoint's secret. Webhooks shows how to verify it.
- What if my server is down?
- Failed deliveries are tried again. You can retry one delivery, or replay an endpoint's failed deliveries from a window of up to 30 days.
- Can I alert on a phrase?
- Yes. A search subscription takes the same
qas full-text search, for examplegoing concernin 10-K filings. - Which plans include webhooks?
- Not every plan includes webhooks or the stream. A request on a plan without them gets
403with the codeplan_required. The limits of each plan are on the fees page.
Make your first request
Create a key, then use it in the examples above. The fees page lists what each plan includes.