Webhooks
Scale plan · every hour · signed with HMAC-SHA256
Matching filings, sent to Slack, Discord or your own endpoint.
On the Scale plan, every saved watch can post signed JSON payloads to any HTTPS webhook URL, or deliver formatted messages directly to Slack and Discord channels. Watches run every hour.
- Content-Type
- application/json
- User-Agent
- Convexity-Webhooks/1.0
- X-Convexity-Event
- wiremark.raise_matched
- X-Convexity-Delivery
- the delivery id
- X-Convexity-Signature
- sha256=<hex digest>
Any 2xx answer within 5 seconds counts as delivered.
Event types
Three events, one for each filing channel
One event for each kind of filing a watch can match.
- Form D · Form C
wiremark.raise_matchedFired when a newly accepted SEC Form D or Form C operating round matches your watch.
- Form 8-K
wiremark.exec_move_matchedFired when an SEC Form 8-K officer, auditor, M&A, restructuring, or cyber filing matches your watch.
- Form 144
wiremark.liquidity_matchedFired when an SEC Form 144 planned insider share sale clears your value threshold.
PCAOB Form AP matches arrive in your inbox and email digest, not by webhook.
What arrives
One event, in either shape
The same match, as JSON for your code or a post for your channel.
{"id": "3f6c2a9e-8d41-4b7a-9c35-1e2f0a7b5d64","event": "wiremark.raise_matched","created_at": "2026-11-13T08:14:02.418306","data": {"watch_id": 14,"watch_name": "US technology raises $10M+","trigger_id": "raise:0001784241-26-000004","channel": "raise","event_date": "2026-11-12","company_name": "Databento Inc.","cik": "0001784241","ticker": null,"headline": "Filed Form D raise ($100.4M)","subline": "Other Technology | Salt Lake City, UT | Rev: Decline to Disclose","amount_usd": 100449711.0,"state": "UT","industry": "Other Technology","people": ["Christina Qi", "Luca Lin", "Geoffrey Bernstein", "Rick Yang"],"filing_form": "Form D","filing_url": "https://www.sec.gov/Archives/edgar/data/1784241/000178424126000004/primary_doc.xml"}}
Wiremark private raise matched
- Watch id
- 14
- Watch name
- US technology raises $10M+
- Trigger id
- raise:0001784241-26-000004
- Channel
- raise
- Event date
- 2026-11-12
- Company name
- Databento Inc.
- Cik
- 0001784241
- Headline
- Filed Form D raise ($100.4M)
- Subline
- Other Technology | Salt Lake City, UT | Rev: Decline to Disclose
- Amount usd
- 100449711.0
A chat endpoint gets the event's title and the payload's first ten fields, in the shape that service accepts. This is a drawing of that post, not either app's own look.
Sign it yourself
Type a secret. The header is computed here, in your browser, over the sample's bytes.
HMAC-SHA256 over 714 bytes of raw body. Change one character of the secret and every character of the digest changes.
Verify a delivery
Before you parse it
Every request is signed, so your receiver can check it first.
import hashlibimport hmac def is_from_wiremark(secret: str, raw_body: bytes, header: str) -> bool:digest = hmac.new(secret.encode(), raw_body, hashlib.sha256).hexdigest()return hmac.compare_digest("sha256=" + digest, header)
import { createHmac, timingSafeEqual } from 'node:crypto'; export function isFromWiremark(secret, rawBody, header) {const digest = createHmac('sha256', secret).update(rawBody).digest('hex');const expected = Buffer.from('sha256=' + digest);const given = Buffer.from(header);return expected.length === given.length && timingSafeEqual(expected, given);}
Every JSON request carries an X-Convexity-Signature header: the prefix sha256= followed by the hex HMAC-SHA256 of the raw body keyed with your endpoint's secret, so your receiver can verify it before processing. Compute it over the bytes as they arrived, before any JSON parsing, and compare in constant time.
Retries
Five tries, then the delivery is marked exhausted
A failed delivery is retried with backoff, not dropped.
- First try
- after 1 minSecond
- after 5 minThird
- after 30 minFourth
- after 2 hoursFifth
A timeout, a refused connection or any answer outside 2xx counts as a failure. You can send a signed test ping to an endpoint from the app before a real filing does.
Point a watch at your endpoint.
Webhooks, Slack and Discord delivery are part of the Scale plan.