Alerts

FREE to register — HMAC webhook on series.changed and/or source.changed (retention bind)

Free to register. Webhook instead of caching: series.changed when a served value moves, source.changed when an official source's bytes change. HMAC secret shown once. First 3 deliveries free, then $0.05 each from a prepaid api_key. Or poll GET /v1/changes.

post/alerts

Request

  • Base URL: https://euroref.dev
  • URL: https://euroref.dev/alerts
  • Auth: one of:
    • none
    • API key in header PAYMENT-SIGNATURE

Request body

urlstring uri required

Webhook endpoint to receive events

seriesstring[]

Value watches. Patterns like "ng/policy-rate", "ke/", or ""

sourcesstring[]

Document watches. Exact official-source URLs from the provenance ledger (see each series' source.url). Unknown URLs are refused free with error source_not_fingerprinted.

api_keystring

Optional prepaid key to fund deliveries after the free trial

Response

Subscription created; response includes the HMAC secret (shown once)

Changes

No recorded changes to this operation across all 1 revision of this API.