Overview & Event

Fortisx webhooks deliver real‑time alert events to your server via HTTP POST.

• Single subscription per account. Re‑installing the webhook overwrites the previous one.

• Subscription is configured via API (see API Reference → Webhooks). This page does not duplicate endpoints.

What you receive

POST {your-callback-url}
Content-Type: application/json
X-Fortisx-Event-Id: evt_01HXYZA12B
X-Fortisx-Signature: t=1730548800, v1=<hex-hmac>

• X-Fortisx-Event-Id — unique ID for idempotency.

• X-Fortisx-Signature — request signature (see “Signature Verification” for details).

Delivery policy (2xx ≤ 5s, retries, idempotency): see Signature Verification.

---

Event example (alert.created)

{
  "id": "evt_01HXYZA12B",
  "type": "alert.created",
  "occurredAt": "2025-11-02T12:40:00Z",
  "data": {
    "id": 1119,
    "networkCode": "SOL",
    "stakingPoolId": 82,
    "eventType": "TVL_Spike",
    "windowMinutes": 60,
    "valueFrom": "5200000.000000000000000000",
    "valueTo": "6050000.000000000000000000",
    "unit": "USD",
    "tokenSymbol": "SOL",
    "deltaAbs": "850000.000000000000000000",
    "deltaRelPct": "16.346154",
    "detectedAt": "2025-11-02 12:40:00"
  }
}