Skip to main content
WEBHOOK

Body

application/json

Payload for the wallet_action.transfer.succeeded webhook event.

​
type
enum<string>
required

The type of webhook event.

Available options:
wallet_action.transfer.succeeded
​
wallet_action_id
string
required

The ID of the wallet action.

​
wallet_id
string
required

The ID of the wallet involved in the action.

​
action_type
enum<string>
required

Type of wallet action

Available options:
swap,
transfer,
earn_deposit,
earn_withdraw,
earn_incentive_claim,
earn_fee_collect
​
created_at
string
required

ISO 8601 timestamp of when the wallet action was created.

​
source_chain
string
required

Chain name (e.g. "tempo", "base").

​
destination_address
string
required

Recipient address.

​
status
enum<string>
required

The status of the wallet action.

Available options:
succeeded
​
steps
(EVMTransactionWalletActionStep · object | EVMUserOperationWalletActionStep · object | SVMTransactionWalletActionStep · object | TVMTransactionWalletActionStep · object | ExternalTransactionWalletActionStep · object | CustodianTransactionWalletActionStep · object)[]
required

The steps of the wallet action, including transaction hashes.

A wallet action step consisting of an EVM transaction.

​
completed_at
string
required

ISO 8601 timestamp of when the wallet action completed successfully.

​
source_asset
string

Asset identifier (e.g. "usdc", "eth"). Present when the transfer was initiated with a named asset; omitted for custom-token transfers.

​
source_asset_address
string

Token contract address (EVM) or mint address (Solana). Present when the transfer was initiated with asset_address.

​
source_asset_decimals
integer

Number of decimals for the transferred token. Present when the transfer was initiated with asset_address and the decimals were resolved onchain.

​
source_amount
string

Decimal amount sent on the source chain (e.g. "1.5"). Omitted for exact_output cross-chain transfers until the source amount is determined.

Response

200

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