Skip to main content
WEBHOOK
wallet.funds_deposited
{
  "type": "wallet.funds_deposited",
  "wallet_id": "fmfdj6yqly31huorjqzq38zc",
  "idempotency_key": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "caip2": "eip155:1",
  "asset": {
    "type": "native-token",
    "address": null
  },
  "amount": "1000000000000000000",
  "transaction_hash": "0x2446f1fd773fbb9f080e674b60c6a033c7ed7427b8b9413cf28a2a4a6da9b56c",
  "sender": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "recipient": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F",
  "block": {
    "number": 19832451,
    "timestamp": 1715000003
  }
}

Body

application/json

Payload for the wallet.funds_deposited webhook event.

​
type
enum<string>
required

The type of webhook event.

Available options:
wallet.funds_deposited
​
wallet_id
string
required

The ID of the wallet.

​
idempotency_key
string
required

A unique key for this event.

​
caip2
string
required

The CAIP-2 chain identifier.

​
asset
WalletFundsNativeTokenAsset · object
required

The asset type being transferred.

​
amount
string
required

The amount transferred, as a stringified bigint.

​
transaction_hash
string
required

The blockchain transaction hash.

​
sender
string
required

The sender address.

​
recipient
string
required

The recipient address.

​
block
object
required
​
transaction_fee
string

The transaction fee paid, as a stringified bigint in the chain's native token.

​
bridge_metadata
BridgeCryptoDepositMetadata · object

Optional Bridge metadata for custodial wallet deposits.

Response

200

Return a 200 status to indicate that the webhook was received successfully.