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.

One deliveryPOST · JSON
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 Cwiremark.raise_matched

    Fired when a newly accepted SEC Form D or Form C operating round matches your watch.

  • Form 8-Kwiremark.exec_move_matched

    Fired when an SEC Form 8-K officer, auditor, M&A, restructuring, or cyber filing matches your watch.

  • Form 144wiremark.liquidity_matched

    Fired 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.

wiremark.raise_matched
{"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"}}

Sign it yourself

Type a secret. The header is computed here, in your browser, over the sample's bytes.

X-Convexity-Signaturesha256=

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.

verify
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)

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.

  1. First try
  2. after 1 minSecond
  3. after 5 minThird
  4. after 30 minFourth
  5. after 2 hoursFifth

First try. What does your endpoint answer?

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.