Sign in

v1

latestOpenAPI 3.0.0ISC2026-07-26318688.6 KB
Exchanges

Create exchange

Create a new exchange (swap). Use type: "private" or type: "standard" for centralized exchanges or type: "dex" for decentralized exchanges.

post/exchanges

Request body

addressTostring required

Destination wallet address where funds will be sent

quoteIdstring required

Quote ID from a prior quote response. Amount, from token, to token, and swap provider are retrieved from the provided quote. For CEX exchanges, if the exchange fails with the chosen swap provider, it will fallback to the next best route.

addressFromstring

Source wallet address (required for DEX, ignored for CEX)

refundAddressstring

Sender's wallet address for refunds if a fixed-rate swap fails. Required when the quote was created with fixed: true.

refundExtraIdstring

Memo/tag for refundAddress on memo-bearing chains (e.g. XRP DestinationTag, Stellar memo, TON comment). Ignored when the destination chain has no memo concept.

destinationTagstring

Destination tag / memo (e.g. for XRP, XLM)

walletInfostring

Wallet info string

Response

Exchange created

swapNamestring required
fixedboolean
refundAddressstring
houdiniIdstring required
createdstring date-time required
modifiedstring date-time
depositAddressstring required

The CEX deposit address where the user must send funds

receiverAddressstring required
anonymousboolean required
expiresstring date-time required
status-2 | -1 | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 required
  • -2 Order is being initialized (label: INITIALIZING)
  • -1 Order initialized (label: NEW)
  • 0 Waiting for deposit confirmation (label: WAITING)
  • 1 Deposit is being confirmed (label: CONFIRMING)
  • 2 Exchange is in progress (label: EXCHANGING)
  • 3 Order is going through anonymization (label: ANONYMIZING)
  • 4 Order completed successfully (label: FINISHED)
  • 5 Order has expired (label: EXPIRED)
  • 6 Order failed (label: FAILED)
  • 7 Order was refunded (label: REFUNDED)
  • 8 Order was deleted (label: DELETED)
inAmountnumber double required
inSymbolstring required
outAmountnumber double required
outSymbolstring required
depositTagstring

Memo/tag required when depositing funds for assets that use one

notifiedboolean required
etanumber double required

ETA time, depending on swap

inAmountUsdnumber double required

USD value of the input amount at order creation time.

outAmountUsdnumber double required
multiIdstring required
inCreatedstring date-time required
idstring required
nonRefundableboolean
{"stackTrail":"components:schemas:OrderV2PublicResponse:properties:metadata","oasType":"schema","type":"unknown"}
isDexboolean required
orderFinishedReceivedstring date-time required
actionRequiredboolean required
inStatus0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 required
  • 0 New swap
  • 1 Waiting for confirmation
  • 2 Being confirmed
  • 3 Exchange in progress
  • 4 Sending to destination
  • 5 Swap completed
  • 6 Swap failed
  • 7 Swap refunded
  • 8 Verifying swap
  • 9 Swap expired
  • 10 Fallback mode
outStatus0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 required
  • 0 New swap
  • 1 Waiting for confirmation
  • 2 Being confirmed
  • 3 Exchange in progress
  • 4 Sending to destination
  • 5 Swap completed
  • 6 Swap failed
  • 7 Swap refunded
  • 8 Verifying swap
  • 9 Swap expired
  • 10 Fallback mode
outTransactionOutHashstring required
displayStatus'WAITING_FOR_DEPOSIT' | 'DEPOSIT_DETECTED' | 'EXCHANGE_IN_PROGRESS' | 'SENDING_TO_INTERMEDIARY' | 'REACHED_INTERMEDIARY' | 'INITIATING_SECOND_EXCHANGE' | 'SECOND_EXCHANGE_IN_PROGRESS' | 'SENDING_TO_RECEIVER' | 'SWAP_COMPLETED' | 'EXPIRED' | 'FAILED' | 'REFUNDED' | 'DELETED' required
receiverTagstring nullable

Memo/tag required when receiving funds for assets that use one