CurrencyRateDocs
Docs › API reference › Reference › Webhooks

Webhooks

Register a URL from your dashboard and we'll POST to it whenever a rate anomaly is detected on a pair you've subscribed to — for example, when two independent sources disagree beyond a threshold.

POST <your URL>
Content-Type: application/json
X-CurrencyRate-Signature: t=1754483460,v1=<hex hmac-sha256>

{
  "event": "rate_anomaly",
  "pair": "EUR/ILS",
  "rateDate": "2026-08-06",
  "rate": "3.200000000000",
  "percentChange": "6.200000",
  "detectedAt": "2026-08-06T09:03:00.000Z"
}

Verify deliveries by recomputing the HMAC-SHA256 over {timestamp}.{raw body} with your webhook secret and comparing it to the v1 value. Manage your endpoint and inspect delivery history from the dashboard.