Sign in

Transfer created

Fired when a wallet action is created and execution has begun. The action is now pending.

postWebhookwallet_action.transfer.created

Payload

action_type'swap' | 'transfer' | 'earn_deposit' | 'earn_withdraw' | 'earn_incentive_claim' | 'earn_fee_collect' required

Type of wallet action

created_atstring required

ISO 8601 timestamp of when the wallet action was created.

destination_addressstring required

Recipient address.

source_amountstring

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

source_assetstring

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

source_asset_addressstring

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

source_asset_decimalsinteger

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

source_chainstring required

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

status'pending' required

The status of the wallet action.

type'wallet_action.transfer.created' required

The type of webhook event.

wallet_action_idstring required

The ID of the wallet action.

wallet_idstring required

The ID of the wallet involved in the action.

Response

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

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.