Sign in

v46

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-211591,0051.4 MB

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.

postWebhookwallet_action.swap.failed

Payload

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

Type of wallet action

caip2string required

Chain identifier.

created_atstring required

ISO 8601 timestamp of when the wallet action was created.

failed_atstring required

ISO 8601 timestamp of when the wallet action failed.

input_amountstring nullable required

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

input_tokenstring required

Token address being sold.

output_tokenstring required

Token address being bought.

status'failed' required

The status of the wallet action.

type'wallet_action.swap.failed' 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.