.png?fit=max&auto=format&n=ML35RDblT1Ol-zJb&q=85&s=062e79ad9c4540929eec204aff020178)
.png?fit=max&auto=format&n=ML35RDblT1Ol-zJb&q=85&s=f6328956931c9664a2a070c2edb6e9b3)
Event Type
Each notifications flow consists of aparent method with sub-methods representing the lifecycle, status, or progress of an event.
| Parent methods | Description |
|---|---|
wallets:deposit | |
wallets:withdraw | |
wallets:swap |
Event Schema
Deposit
Deposit
Withdraw
Withdraw
Swap
Swap
Event Examples
Incoming Deposit (pending) example
Incoming Deposit (pending) example
{
"requestId": "04afc1dd8ffae1f6f8c66f96eed0f5",
"method": "wallets:withdraw.pending",
"params": {
"id": "6a382b941e117b9527366499",
"refId": "2a1ee011-e5b5-419e-a967-bb0a8f0626c3",
"idempotencyKey": "0e620f37-0f8a-4cee-b0e7-72235b697449",
"tokenName": "USD Coin",
"tokenSymbol": "USDC",
"tokenTicker": "USDC_BASE",
"tokenAddress": "0x036cbd53842c5426634e7929541ec2318f3dcf7e",
"decimals": 6,
"isNative": false,
"amount": {
"value": "5",
"rawValue": "5000000"
},
"totalAmount": {
"value": "5.028011",
"rawValue": "5028011"
},
"chainDecimals": 18,
"blockchain": "BASE",
"protocol": "EVM",
"environment": "testnet",
"network": "base-sepolia",
"txType": "outgoing",
"status": "pending",
"fromAddress": "0xda0348137a73899a156944e31c81f05f646d168c",
"toAddress": "0x226917bdc6d659672050e48ca6ce73dbd3a1d318",
"txHash": "0xee30898cdfaee9c810996756337044fd98b4b0406583dd2d5706288b97f472e5",
"totalFee": {
"value": "0.000001224105803529",
"rawValue": "1224105803529"
},
"feeLevel": "fast",
"feeToken": "ETH",
"isBatch": false,
"destinations": [
{
"address": "0x226917bdc6d659672050e48ca6ce73dbd3a1d318",
"value": "5",
"rawValue": "5000000"
},
{
"address": "0x7a750d8d6e12cce09a7c15482077a8a4d4c37de4",
"value": "0.028011",
"rawValue": "28011"
}
],
"note": null,
"triggerOrigin": "blockchain",
"confirmation": null,
"confirmed": false,
"confirmedAt": null,
"userId": "69f60c8561a6152a39f39005",
"walletId": "69f60c8561a6152a39f39005",
"accountId": "69eba97c3f7e15428aef8811",
"workspaceId": "67e723ed4b44a4f73dd2e8a2",
"createdAt": "2026-06-21T18:21:08.349Z",
"updatedAt": "2026-06-21T18:21:08.349Z",
"wallet": {
"id": "69f60c8561a6152a39f39005",
"address": "0xDA0348137A73899A156944e31C81f05F646d168c",
"type": "deposit",
"protocol": "EVM",
"isEvmCompatible": true,
"name": "user_0_Zee",
"userId": "69f60c8561a6152a39f39005",
"refId": "f3f14dcf-a233-4128-8044-5c8f03feb230",
"custodyType": "DEVELOPER",
"token": {
"name": "USD Coin",
"symbol": "USDC",
"blockchain": "BASE",
"tokenAddress": "0x036cbd53842c5426634e7929541ec2318f3dcf7e",
"isNative": false,
"decimals": 6,
"standard": "ERC20",
"balance": {
"value": "12.471989",
"rawValue": "12471989"
}
}
}
}
}
}
Incoming Deposit (success) example
Incoming Deposit (success) example
{
"requestId": "04afc1dd8ffae1f6f8c66f96eed0f5",
"method": "wallets:deposit.success",
"params": {
"id": "6a382b951e117b952736649a",
"refId": "9395d9b3-b58a-4856-8a3e-886c687f8d6f",
"idempotencyKey": "d1526226-27c2-440f-8d57-a2e3bc980e89",
"tokenName": "USD Coin",
"tokenSymbol": "USDC",
"tokenTicker": "USDC_BASE",
"tokenAddress": "0x036cbd53842c5426634e7929541ec2318f3dcf7e",
"decimals": 6,
"isNative": false,
"amount": {
"value": "5",
"rawValue": "5000000"
},
"chainDecimals": 18,
"blockchain": "BASE",
"protocol": "EVM",
"environment": "testnet",
"network": "base-sepolia",
"txType": "incoming",
"status": "success",
"fromAddress": "0xda0348137a73899a156944e31c81f05f646d168c",
"toAddress": "0x226917bdc6d659672050e48ca6ce73dbd3a1d318",
"txHash": "0xee30898cdfaee9c810996756337044fd98b4b0406583dd2d5706288b97f472e5",
"note": null,
"triggerOrigin": "blockchain",
"confirmation": "1",
"confirmed": true,
"confirmedAt": "2026-06-21T18:24:28.849Z",
"userId": "69f60c8561a6152a39f39005",
"walletId": "6a38259e7b6635a105154d11",
"accountId": "69eba97c3f7e15428aef8811",
"workspaceId": "67e723ed4b44a4f73dd2e8a2",
"createdAt": "2026-06-21T18:21:08.955Z",
"updatedAt": "2026-06-21T18:24:29.478Z",
"wallet": {
"id": "6a38259e7b6635a105154d11",
"address": "0x226917Bdc6d659672050E48ca6CE73dbd3A1D318",
"type": "deposit",
"protocol": "EVM",
"isEvmCompatible": true,
"name": "dev-user-4",
"userId": "69f60c8561a6152a39f39005",
"refId": "2198ddd0-4738-4ef6-b703-d1bfa79531d0",
"custodyType": "DEVELOPER",
"token": {
"name": "USD Coin",
"symbol": "USDC",
"blockchain": "BASE",
"tokenAddress": "0x036cbd53842c5426634e7929541ec2318f3dcf7e",
"isNative": false,
"decimals": 6,
"standard": "ERC20",
"balance": {
"value": "5",
"rawValue": "5000000"
}
}
}
}
}
}
Outgoing Transfer (pending) example
Outgoing Transfer (pending) example
{
"requestId": "04afc1dd8ffae1f6f8c66f96eed0f5",
"method": "wallets:withdraw.pending",
"params": {
"id": "6a382b941e117b9527366499",
"refId": "2a1ee011-e5b5-419e-a967-bb0a8f0626c3",
"idempotencyKey": "0e620f37-0f8a-4cee-b0e7-72235b697449",
"tokenName": "USD Coin",
"tokenSymbol": "USDC",
"tokenTicker": "USDC_BASE",
"tokenAddress": "0x036cbd53842c5426634e7929541ec2318f3dcf7e",
"decimals": 6,
"isNative": false,
"amount": {
"value": "5",
"rawValue": "5000000"
},
"totalAmount": {
"value": "5.028011",
"rawValue": "5028011"
},
"chainDecimals": 18,
"blockchain": "BASE",
"protocol": "EVM",
"environment": "testnet",
"network": "base-sepolia",
"txType": "outgoing",
"status": "pending",
"fromAddress": "0xda0348137a73899a156944e31c81f05f646d168c",
"toAddress": "0x226917bdc6d659672050e48ca6ce73dbd3a1d318",
"txHash": "0xee30898cdfaee9c810996756337044fd98b4b0406583dd2d5706288b97f472e5",
"totalFee": {
"value": "0.000001224105803529",
"rawValue": "1224105803529"
},
"feeLevel": "fast",
"feeToken": "ETH",
"isBatch": false,
"destinations": [
{
"address": "0x226917bdc6d659672050e48ca6ce73dbd3a1d318",
"value": "5",
"rawValue": "5000000"
},
{
"address": "0x7a750d8d6e12cce09a7c15482077a8a4d4c37de4",
"value": "0.028011",
"rawValue": "28011"
}
],
"note": null,
"triggerOrigin": "blockchain",
"confirmation": null,
"confirmed": false,
"confirmedAt": null,
"userId": "69f60c8561a6152a39f39005",
"walletId": "69f60c8561a6152a39f39005",
"accountId": "69eba97c3f7e15428aef8811",
"workspaceId": "67e723ed4b44a4f73dd2e8a2",
"createdAt": "2026-06-21T18:21:08.349Z",
"updatedAt": "2026-06-21T18:21:08.349Z",
"wallet": {
"id": "69f60c8561a6152a39f39005",
"address": "0xDA0348137A73899A156944e31C81f05F646d168c",
"type": "deposit",
"protocol": "EVM",
"isEvmCompatible": true,
"name": "user_0_Zee",
"userId": "69f60c8561a6152a39f39005",
"refId": "f3f14dcf-a233-4128-8044-5c8f03feb230",
"custodyType": "DEVELOPER",
"token": {
"name": "USD Coin",
"symbol": "USDC",
"blockchain": "BASE",
"tokenAddress": "0x036cbd53842c5426634e7929541ec2318f3dcf7e",
"isNative": false,
"decimals": 6,
"standard": "ERC20",
"balance": {
"value": "12.471989",
"rawValue": "12471989"
}
}
}
}
}
}
Outgoing Transfer (success) example
Outgoing Transfer (success) example
{
"requestId": "04afc1dd8ffae1f6f8c66f96eed0f5",
"method": "wallets:withdraw.success",
"params": {
"id": "6a382b941e117b9527366499",
"refId": "2a1ee011-e5b5-419e-a967-bb0a8f0626c3",
"idempotencyKey": "0e620f37-0f8a-4cee-b0e7-72235b697449",
"tokenName": "USD Coin",
"tokenSymbol": "USDC",
"tokenTicker": "USDC_BASE",
"tokenAddress": "0x036cbd53842c5426634e7929541ec2318f3dcf7e",
"decimals": 6,
"isNative": false,
"amount": {
"value": "5",
"rawValue": "5000000"
},
"totalAmount": {
"value": "5.028011",
"rawValue": "5028011"
},
"chainDecimals": 18,
"blockchain": "BASE",
"protocol": "EVM",
"environment": "testnet",
"network": "base-sepolia",
"txType": "outgoing",
"status": "success",
"fromAddress": "0xda0348137a73899a156944e31c81f05f646d168c",
"toAddress": "0x226917bdc6d659672050e48ca6ce73dbd3a1d318",
"txHash": "0xee30898cdfaee9c810996756337044fd98b4b0406583dd2d5706288b97f472e5",
"totalFee": {
"value": "0.000001224105803529",
"rawValue": "1224105803529"
},
"feeLevel": "fast",
"feeToken": "ETH",
"isBatch": false,
"destinations": [
{
"address": "0x226917bdc6d659672050e48ca6ce73dbd3a1d318",
"value": "5",
"rawValue": "5000000"
},
{
"address": "0x7a750d8d6e12cce09a7c15482077a8a4d4c37de4",
"value": "0.028011",
"rawValue": "28011"
}
],
"note": null,
"triggerOrigin": "blockchain",
"confirmation": "1",
"confirmed": true,
"confirmedAt": "2026-06-21T18:24:28.849Z",
"userId": "69f60c8561a6152a39f39005",
"walletId": "69f60c8561a6152a39f39005",
"accountId": "69eba97c3f7e15428aef8811",
"workspaceId": "67e723ed4b44a4f73dd2e8a2",
"createdAt": "2026-06-21T18:21:08.349Z",
"updatedAt": "2026-06-21T18:24:28.940Z",
"wallet": {
"id": "69f60c8561a6152a39f39005",
"address": "0xDA0348137A73899A156944e31C81f05F646d168c",
"type": "deposit",
"protocol": "EVM",
"isEvmCompatible": true,
"name": "user_0_Zee",
"userId": "69f60c8561a6152a39f39005",
"refId": "f3f14dcf-a233-4128-8044-5c8f03feb230",
"custodyType": "DEVELOPER",
"token": {
"name": "USD Coin",
"symbol": "USDC",
"blockchain": "BASE",
"tokenAddress": "0x036cbd53842c5426634e7929541ec2318f3dcf7e",
"isNative": false,
"decimals": 6,
"standard": "ERC20",
"balance": {
"value": "12.471989",
"rawValue": "12471989"
}
}
}
}
}
}
Best Practices
- Idempotent Processing: Ensure your webhook handlers are idempotent to avoid duplicate processing.
- Final Events Only: Update balances only on final events, Refer to the full list of
supported eventsto identify valid final event types. - Acknowledgment: Always respond with a 2xx HTTP status code within 1 minutes to acknowledge receipt.
- Security: Verify webhook payload signatures to ensure authenticity.