Sign in
latestOpenAPI 3.0.02026-08-15161451.7 KB

6ffb6a8fd74a

Swaps

Get swap status

Look up the current status of a swap by its quote ID. Pass txHash on the first call after broadcasting to bind it to the quote and start tracking. Subsequent calls can omit txHash.

get/v1/swap/status

Query parameters

quoteIdstring uuid required
txHashstring

Headers

X-Partner-Codestring

Partner code for affiliate fee attribution. The API resolves the code to the registered affiliate address and BPS. Register a code at the affiliate dashboard.

Response

Swap status

quoteIdstring uuid required
txHashstring
status'pending' | 'submitted' | 'confirmed' | 'failed' required
swapperNamestring required
sellAssetIdstring required
buyAssetIdstring required
sellAmountCryptoBaseUnitstring required
buyAmountAfterFeesCryptoBaseUnitstring required
partnerAddressstring
affiliateBpsstring required

Total on-chain fee in bps.

partnerBpsstring

Partner share in bps.

shapeshiftBpsstring required

ShapeShift platform fee in bps.

registeredAtnumber
buyTxHashstring
isAffiliateVerifiedboolean

Example response

{
  "partnerAddress": "0x1234567890123456789012345678901234567890",
  "affiliateBps": "60",
  "partnerBps": "50",
  "shapeshiftBps": "10"
}