swap

Get swap transaction confirmation status. (admin access required, mainnet only)

Check on-chain confirmation status of a swap transaction by transaction hash. Use after POST /swap/ to poll until status is confirmed. Mainnet only.

get/swap/confirm

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/confirm
  • Auth: API key in header token

Query parameters

txHashstring required

Transaction hash to check

walletVkeystring required

Wallet verification key (vKey) that submitted the swap

Response

Confirmation status (Pending, Confirmed, or NotFound)

status'Pending' | 'Confirmed' | 'NotFound' required

On-chain status: Pending (not yet in a block), Confirmed (in a block), NotFound (tx unknown)

swapStatusstring

Swap lifecycle status (OrderPending, OrderConfirmed, CancelPending, CancelConfirmed, Completed)

swapTransactionIdstring

SwapTransaction ID, returned when lifecycle transition occurs

confirmationsinteger nullable

Number of block confirmations. Present when status is confirmed.

Example response

{
  "status": "Confirmed",
  "swapStatus": "OrderConfirmed",
  "confirmations": 15
}

Changes

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