Webhook event

Crypto Deposit Created

POSTCRYPTO_DEPOSIT_CREATED

Fired when a new on-chain deposit is detected on an account deposit address.

Body

application/json

idstringrequired

Unique event identifier for idempotency

typestringrequired

Webhook event type

Available options:CRYPTO_DEPOSIT_CREATED

dataobjectrequired

Show child attributes

idstring<uuid>required

Unique deposit identifier

accountIdstring<uuid>required

Account that received the deposit

chainIdstringrequired

Blockchain network identifier

Available options:ETHEREUM_MAINNETETHEREUM_SEPOLIABASE_MAINNETBASE_SEPOLIAARBITRUM_ONE_MAINNETARBITRUM_ONE_SEPOLIAPOLYGON_MAINNETPOLYGON_AMOYSOLANA_MAINNETSOLANA_DEVNET

transactionIdstringrequired

On-chain transaction hash/signature

statusstringrequired

Current deposit status

Available options:PENDINGCONFIRMEDAPPROVEDREJECTED

rejectionReasonstring | nullrequired

Reason for rejection (only when status is REJECTED)

Available options:TRANSACTION_FAILEDASSET_NOT_ACCEPTEDKYT_CHECK_FAILEDAMOUNT_TOO_SMALL

amountstringrequired

Amount with decimals applied (string for full precision)

feeAmountstring | nullrequired

Deposit fee charged on this deposit, in the same asset as amount. null when the deposit is not subject to a deposit fee

senderAddressstringrequired

Address that sent the deposit

occurredAtstring | nullrequired

ISO 8601 timestamp of on-chain transfer

createdAtstringrequired

ISO 8601 timestamp of creation

updatedAtstringrequired

ISO 8601 timestamp of last update

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

Response

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