Skip to main content
WEBHOOK
swapUpdated
{
  "swap_updated": {
    "orderId": "e1f2a3b4-c5d6-7890-abcd-ef1234567890",
    "customerId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "sendTransaction": "AQAAAAAAAA...",
    "sendTransactionHash": "5KtP...",
    "receiveTransactionHash": "3JmN...",
    "status": "completed",
    "createdAt": "2026-05-02T09:15:00Z",
    "updatedAt": "2026-05-02T09:18:00Z"
  }
}

Authorizations

Authorization
string
header
required

API key sent in the Authorization header.

Headers

X-Signature
string
required

HMAC-SHA256 signature: sha256={hex}. Computed over the canonicalized (RFC 8785) request body using your webhook secret.

Body

application/json

Webhook envelope for swap status changes.

swap_updated
object
required

Payload for swap_updated webhooks.

Example:
{
"orderId": "e1f2a3b4-c5d6-7890-abcd-ef1234567890",
"customerId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"sendTransaction": "AQAAAAAAAA...",
"sendTransactionHash": "5KtP...",
"receiveTransactionHash": null,
"status": "funded",
"createdAt": "2026-05-02T09:15:00Z",
"updatedAt": "2026-05-02T09:15:30Z"
}

Response

200

Return any 2xx to acknowledge receipt.