Get Swap Status

Get status for a swap

GET https://api-prod.chainhop.net/chainhop/getStatus

Path Parameters

Name	Type	Description
swap_id*	String	Swap id given by Quote response

200: OK

{
    // Response
}

Request Parameters

Name	Type	Description
swap_id	String	Unique id for swap

Response Parameters

Name	Type	Description
err	Optional Error Message
swap_status	SwapStatus
cbr_transfer_id	String	cBridge transfer id if the swap involves cBridge transfer
src_block_tx_link	String	source chain transaction link
dst_block_tx_link	String	destination chain transaction link

SwapStatus

Value	Description
SS_UNKNOWN(0)	Status PlaceHolder
SS_PENDING(1)	The source chain transaction is pending. It is a placeholder for FrontEnd local status and will not be provided by ChainHop Server
SS_SRC_SUCCESS(2)	Source chain transaction is processed completely.
SS_SRC_FAILED(3)	The source chain transaction failed. It is a placeholder for FrontEnd local status and will not be provided by ChainHop Server
SS_DST_COMPLETED(4)	Destination chain transaction finishes
SS_DST_REFUNDED(5)	Destination chain refund finished. No need to do anything.
SS_SRC_REFUNDED(6)	Source chain transaction refunded

SS_SRC_SUCCESS does not nessarily mean destination chain will succeed. Since ChainHop has cBridge transfer path possibility, you may also check involved cBridge transfer status. If the cBridege transfer status indicates the need of refund, you need to finish cBridge transfer refund from your side. You may refer this for more details.