Skip to main content
WEBHOOK
wallet_action.transfer.created
{
  "type": "wallet_action.transfer.created",
  "wallet_action_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "wallet_id": "fmfdj6yqly31huorjqzq38zc",
  "action_type": "transfer",
  "status": "pending",
  "source_asset": "usdc",
  "source_amount": "1.5",
  "source_chain": "base",
  "destination_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18"
}

Body

application/json

Payload for the wallet_action.transfer.created webhook event.

​
type
enum<string>
required

The type of webhook event.

Available options:
wallet_action.transfer.created
​
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
​
status
enum<string>
required

The status of the wallet action.

Available options:
pending,
succeeded,
rejected,
failed
​
source_asset
string
required

Asset identifier (e.g. "usdc", "eth").

​
source_amount
string
required

Decimal amount as provided by the user (e.g. "1.5").

​
source_chain
string
required

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

​
destination_address
string
required

Recipient address.

Response

200

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