Skip to main content
WEBHOOK

Body

application/json

Shared partner payload for price-trigger-swap lifecycle webhooks.

id
string
required

Price-trigger-swap id.

user_id
string
required

Public id of the user the swap belongs to.

timestamp
string<date-time>
required

RFC3339 UTC time of the lifecycle transition.

type
enum<string>
required

Event type discriminator.

Available options:
price_trigger_swap.execution_failed
client_order_id
string

Partner-supplied order id, when provided at creation.

failure_reason
enum<string>

Partner-safe reason for a failed execution attempt or a terminal swap failure. Internal reasons, including retry exhaustion, are other. Omitted for user-requested cancels.

Available options:
system_error,
insufficient_market_liquidity,
insufficient_funds,
user_locked,
user_request,
other

Response

2XX

Return any 2xx status to acknowledge receipt.