swap

Acknowledge a swap timeout and recover state. (admin access required, mainnet only)

Acknowledge a timed-out swap transaction. Checks on-chain state and recovers to the correct status: OrderConfirmed if the order UTXO still exists (allowing retry), Completed if the DEX executed the swap, or keeps the timeout state if the order tx never confirmed.

post/swap/acknowledge-timeout

Request

  • Base URL: ./../api/v1/ (relative, and the document was published on a file host, not at the API’s origin)
  • URL: ./../api/v1/swap/acknowledge-timeout
  • Auth: API key in header token

Request body

walletVkeystring required

Wallet verification key (vKey) of the wallet

swapTransactionIdstring required

ID of the timed-out SwapTransaction

Example request

{
  "walletVkey": "wallet_verification_key_here",
  "swapTransactionId": "clx1abc..."
}

Response

Timeout acknowledged, state recovered

swapStatusstring required

New swap status after acknowledgement

messagestring required

Human-readable explanation of what happened

Example response

{
  "swapStatus": "OrderConfirmed",
  "message": "Cancel tx failed but order UTXO still exists. You can retry cancelling."
}

Changes

No recorded changes to this operation across all 50 revisions of this API.