The Product Guides are moving to a new location. We’ll remove this website soon!
Atomic Swaps enable you to exchange assets with another member on the Qredo Network. Quotes can be shared with individual members or posted to the Liquidity Hub for all members.
The member you want to trade with must have a fund containing both assets you want to swap with (e.g. ETH & BTC).
- A Maker creates and posts their quote.
- The quote is authorized by the Maker's Custodians.
- The quote is added to the Liquidity Hub OR passed directly to another Network Member.
- A potential Taker views quotes on the Liquidity Hub
- A Taker uses the swap transaction_id to take the quote.
- The quote is authorized by the Taker's Custodians
- The Atomic swap completes in a single transaction.
Select a fund with required assets and quantities to swap with and note its fund_id.
Specify the assets and quantities you want to send and receive.
Set an expiry time for the swap.
Use this endpoint to make a quote and initiate an Atomic Swap.
Once an Atomic Swap request has been made it must be approved by Custodians before it can be taken. This is either by the Custodian's Qredo Signing App or via the Qredo Core Client.
The Liquidity Hub is the place to broadcast quotes and view available quotes.
Add your Atomic Swap quote using the tx_id obtained in the first step.
Use the Maker company_id.
A standard HTTP 200 OK response is returned.
The Atomic Swap quote is now viewable by all members of the network.
As a potential Taker, you can view all active Swaps at the Liquidity Hub in two ways:
Use this endpoint to get a list of all active swaps:
Use a specific company_id to view all Atomic Swaps associated with that company. These will be indicated in the 'Owner' field of the response.
Use this endpoint to get a real-time feed of all active swaps in the Liquidity Hub.
Use the Swap transaction_id from the Maker to perform the Swap.
You can also use the transaction_id to get more details about the quote using the following endpoint.
Select a fund with the required assets and quantities to receive and send.
Complete the swap at the following endpoint:
Use your fund_id, the swap_id and your reference to take the quote before it expires.
Once a request has been made it must be approved by Custodians before it can be taken. This is either by the Custodian's Qredo Signing App or via the Qredo Core Client.
Successful completion of the Atomic Swap returns a new tx_id.
View Transaction Status using the tx_id.
Retrieve Holdings to confirm the Swap has executed.