First Leeward

Webhook event

Crypto Withdrawal Status Updated

POSTCRYPTO_WITHDRAWAL_STATUS_UPDATED

Fired when a crypto withdrawal status changes (e.g., processing, completed, expired, cancelled, failed).

Body

application/json

idstringrequired

Unique event identifier for idempotency

typestringrequired

Webhook event type

Available options:CRYPTO_WITHDRAWAL_STATUS_UPDATED
dataobjectrequired
Show child attributes
idstring<uuid>required

Unique withdrawal identifier

accountIdstring<uuid>required

Account the funds are withdrawn from

chainIdstringrequired

Blockchain network the transfer happens on

Available options:ETHEREUM_MAINNETETHEREUM_SEPOLIABASE_MAINNETBASE_SEPOLIAARBITRUM_ONE_MAINNETARBITRUM_ONE_SEPOLIAPOLYGON_MAINNETPOLYGON_AMOYSOLANA_MAINNETSOLANA_DEVNET
assetobjectrequired

Asset metadata

Show child attributes
symbolstringrequired

Asset symbol

namestring | nullrequired

Full asset name

decimalsintegerrequired

Number of decimal places

logoUristring | nullrequired

URI to asset logo image

amountstringrequired

Gross amount requested, with decimals applied. The fee is taken out of this rather than charged on top.

netAmountstringrequired

Amount the destination receives: the gross less the fee

feeobjectrequired

Fee charged for the withdrawal, fixed at the time it was requested

Show child attributes
amountstringrequired

Fee retained, with decimals applied

assetobjectrequired

Asset metadata

Show child attributes
symbolstringrequired

Asset symbol

namestring | nullrequired

Full asset name

decimalsintegerrequired

Number of decimal places

logoUristring | nullrequired

URI to asset logo image

destinationAddressstringrequired

Address the funds are sent to

statusstringrequired

Current withdrawal status

Available options:PENDING_SIGNATUREPROCESSINGCOMPLETEDEXPIREDCANCELLEDFAILED
failureReasonstring | nullrequired

What went wrong. Set only when the status is FAILED.

Available options:REJECTED_BY_COMPLIANCEACCOUNT_RESTRICTEDTRANSACTION_FAILED
transactionIdstring | nullrequired

On-chain transaction identifier. Present once the transfer has been submitted to the network, which happens while the status is still PROCESSING.

expiresAtstringrequired

When the signature window closes. Past this point the withdrawal is closed and the funds become spendable again.

completedAtstring | nullrequired

When the transfer was observed to be irreversible on-chain, which is when the status became COMPLETED. Null until then.

createdAtstringrequired

ISO 8601 creation timestamp

updatedAtstringrequired

ISO 8601 last update timestamp

Response

200Webhook received successfully. Return any 2xx status to acknowledge.