Skip to main content
WEBHOOK
wallet_action.swap.succeeded
{
  "type": "wallet_action.swap.succeeded",
  "wallet_action_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "wallet_id": "fmfdj6yqly31huorjqzq38zc",
  "action_type": "swap",
  "status": "succeeded",
  "created_at": "2026-06-15T15:24:00.000Z",
  "completed_at": "2026-06-15T15:24:12.000Z",
  "caip2": "eip155:8453",
  "input_token": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
  "output_token": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
  "input_amount": "1000000",
  "output_amount": "550000000000000",
  "steps": [
    {
      "type": "evm_transaction",
      "status": "confirmed",
      "caip2": "eip155:8453",
      "transaction_hash": "0x2446f1fd773fbb9f080e674b60c6a033c7ed7427b8b9413cf28a2a4a6da9b56c"
    }
  ]
}

Body

application/json

Payload for the wallet_action.swap.succeeded webhook event.

​
type
enum<string>
required

The type of webhook event.

Available options:
wallet_action.swap.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
​
created_at
string
required

ISO 8601 timestamp of when the wallet action was created.

​
caip2
string
required

Chain identifier.

​
input_token
string
required

Token address being sold.

​
output_token
string
required

Token address being bought.

​
input_amount
string | null
required

Amount of input token in base units. Populated after onchain confirmation.

​
output_amount
string | null
required

Amount of output token received, in base units. Populated after onchain confirmation.

​
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.

Response

200

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