{
"type": "wallet_action.swap.failed",
"wallet_action_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"wallet_id": "fmfdj6yqly31huorjqzq38zc",
"action_type": "swap",
"status": "failed",
"created_at": "2026-06-15T15:24:00.000Z",
"failed_at": "2026-06-15T15:24:12.000Z",
"caip2": "eip155:8453",
"input_token": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"output_token": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
"input_amount": "1000000",
"failure_reason": {
"message": "Transaction execution reverted"
},
"steps": [
{
"type": "evm_transaction",
"status": "confirmed",
"caip2": "eip155:8453",
"transaction_hash": "0x1111111111111111111111111111111111111111111111111111111111111111"
},
{
"type": "evm_transaction",
"status": "reverted",
"caip2": "eip155:8453",
"transaction_hash": "0x2222222222222222222222222222222222222222222222222222222222222222",
"failure_reason": {
"message": "Transaction execution reverted"
}
}
]
}Swap failed
Fired when a wallet action fails after at least one transaction was broadcast. There may be onchain state changes; inspect the steps for details.
{
"type": "wallet_action.swap.failed",
"wallet_action_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"wallet_id": "fmfdj6yqly31huorjqzq38zc",
"action_type": "swap",
"status": "failed",
"created_at": "2026-06-15T15:24:00.000Z",
"failed_at": "2026-06-15T15:24:12.000Z",
"caip2": "eip155:8453",
"input_token": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"output_token": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
"input_amount": "1000000",
"failure_reason": {
"message": "Transaction execution reverted"
},
"steps": [
{
"type": "evm_transaction",
"status": "confirmed",
"caip2": "eip155:8453",
"transaction_hash": "0x1111111111111111111111111111111111111111111111111111111111111111"
},
{
"type": "evm_transaction",
"status": "reverted",
"caip2": "eip155:8453",
"transaction_hash": "0x2222222222222222222222222222222222222222222222222222222222222222",
"failure_reason": {
"message": "Transaction execution reverted"
}
}
]
}Body
Payload for the wallet_action.swap.failed webhook event.
The type of webhook event.
wallet_action.swap.failed The ID of the wallet action.
The ID of the wallet involved in the action.
Type of wallet action
swap, transfer, earn_deposit, earn_withdraw, earn_incentive_claim, earn_fee_collect, payout ISO 8601 timestamp of when the wallet action was created.
Chain identifier.
Token address being sold.
Token address being bought.
Amount of input token in base units. Populated after onchain confirmation.
The status of the wallet action.
failed A description of why a wallet action (or a step within a wallet action) failed.
Show child attributes
Show child attributes
The steps of the wallet action. Completed steps will have transaction hashes; the failing step will have a failure_reason.
A wallet action step consisting of an EVM transaction.
- EVMTransactionWalletActionStep
- EVMUserOperationWalletActionStep
- SVMTransactionWalletActionStep
- TVMTransactionWalletActionStep
- ExternalTransactionWalletActionStep
- CustodianTransactionWalletActionStep
Show child attributes
Show child attributes
ISO 8601 timestamp of when the wallet action failed.
Developer-provided reference ID, if one was included in the request.
Response
Return a 200 status to indicate that the webhook was received successfully.
Was this page helpful?

