Qortal Project

The future of blockchain platforms

User Tools

Site Tools

Trace:
trade_portal_faq

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
trade_portal_faq [04/22/2023 16:02] – gfactortrade_portal_faq [04/22/2023 16:17] (current) – gfactor
Line 4: Line 4:
 (Page still under construction) (Page still under construction)
  
-**What is the Trade Portal?**+===== What Is The Trade Portal? =====
  
 The Trade Portal is an application which enables users to exchange The Trade Portal is an application which enables users to exchange
 coins truly peer-to-peer with other users, specifically using what is referred to as cross-chain atomic swaps. Basically the sellers list QORT (only QORT at this time) as a sell order at whatever rate they set, then buyers are able to select these orders in the marketplace as they see fit (there are no "sell walls" or "buy walls" which means trades can be conducted at whatever rates the two peers agree to (regardless of what other trades are listed in the marketplace or have previously traded). Buyers also have the ability to use the 'Auto Buy' feature in the UI, where they can set how many coin they want to set aside for buying orders that meet their criteria. The buyers are able to basically set and forget, while only needing to keep the UI open during this process. For more overview information, see [[Trade Portal Overview]]. We also have a page that explains [[How The Trade Portal Works]]. coins truly peer-to-peer with other users, specifically using what is referred to as cross-chain atomic swaps. Basically the sellers list QORT (only QORT at this time) as a sell order at whatever rate they set, then buyers are able to select these orders in the marketplace as they see fit (there are no "sell walls" or "buy walls" which means trades can be conducted at whatever rates the two peers agree to (regardless of what other trades are listed in the marketplace or have previously traded). Buyers also have the ability to use the 'Auto Buy' feature in the UI, where they can set how many coin they want to set aside for buying orders that meet their criteria. The buyers are able to basically set and forget, while only needing to keep the UI open during this process. For more overview information, see [[Trade Portal Overview]]. We also have a page that explains [[How The Trade Portal Works]].
  
-**How do I buy QORT easily?**+===== How To Buy QORT =====
  
 [[The QORT Coin]] page has a section that explains how to obtain QORT: https://wiki.qortal.org/doku.php?id=the_qort_coin#obtaining_qort [[The QORT Coin]] page has a section that explains how to obtain QORT: https://wiki.qortal.org/doku.php?id=the_qort_coin#obtaining_qort
  
-**What is a decentralized exchange (DEX)?**+===== What Is A Decentralized Exchange (DEX) =====
  
 A decentralized exchange is one where there is no centralized control.  Exchanges occur directly between the two users. When done properly, as Qortal does, this means the user never gives up control of their coins during any part of the process. The only two possibilities are that the trade succeeds, or the trade fails and each user gets their original coins back. In Qortal's case, we prefer to call our DEX a 'Trade Portal' primarily due to the bastardization of the DEX term - but it's a DEX - REAL DEX! A decentralized exchange is one where there is no centralized control.  Exchanges occur directly between the two users. When done properly, as Qortal does, this means the user never gives up control of their coins during any part of the process. The only two possibilities are that the trade succeeds, or the trade fails and each user gets their original coins back. In Qortal's case, we prefer to call our DEX a 'Trade Portal' primarily due to the bastardization of the DEX term - but it's a DEX - REAL DEX!
  
-**What is an ACCT?**+===== What Is An ACCT? =====
  
 An atomic cross-chain trade (other chains call it atomic swaps) is an exchange of two crypto coins from different blockchains where the entire transaction succeeds or fails as a unit. The key point about an ACCT is that at no time does a third party have control over the coins. Specifically, when a user lists a sell order, their QORT is removed from their wallet and placed in an 'AT' - which is a trade wallet that the user still has control over. The user can either cancel the trade order and have their coin returned to their wallet, or wait for a buyer to select the order at which time the buyer's coin is withdrawn from their wallet via a 'Tradebot' which makes the exchange with the Qortal AT, ensuring there is a clean exchange.  An atomic cross-chain trade (other chains call it atomic swaps) is an exchange of two crypto coins from different blockchains where the entire transaction succeeds or fails as a unit. The key point about an ACCT is that at no time does a third party have control over the coins. Specifically, when a user lists a sell order, their QORT is removed from their wallet and placed in an 'AT' - which is a trade wallet that the user still has control over. The user can either cancel the trade order and have their coin returned to their wallet, or wait for a buyer to select the order at which time the buyer's coin is withdrawn from their wallet via a 'Tradebot' which makes the exchange with the Qortal AT, ensuring there is a clean exchange. 
  
-**What crypto coins can be exchanged via the Trade Portal?**+===== What Coins Does The Trade Portal Support? =====
  
 As of Qortal UI v3.1.4, the following coins can be traded:  QORT, LTC, BTC, DGB, RVN, ARRR, and DOGE. Note that QORT is the base pair, so the supported pairs are: QORT-LTC, QORT-BTC, As of Qortal UI v3.1.4, the following coins can be traded:  QORT, LTC, BTC, DGB, RVN, ARRR, and DOGE. Note that QORT is the base pair, so the supported pairs are: QORT-LTC, QORT-BTC,
 QORT-DGB, QORT-RVN, QORT-ARRR, and QORT-DOGE. QORT-DGB, QORT-RVN, QORT-ARRR, and QORT-DOGE.
  
-**Why can't I list sell order in other coins besides QORT? Why can't I trade BTC-LTC directly for example?**+===== Are Sell Orders With Foreign Coins Possible? =====
  
 It can be done eventually, but hasn't been developed yet. The trade bot isn't an issue, as that is off chain. The tricky part with buy orders is the on-chain escrow that holds the funds while they are listed for sale (and during the trade). For QORT sell orders, the QORT is held in an AT on the Qortal chain. But for buy orders, the foreign currency (e.g. LTC) would need to be held in the equivalent of an AT on the LTC chain. LTC and the other listed coins don't support smart contracts, so the listed amount would likely have to be held in a P2SH address. The problem with a P2SH address (at least, in the context of HTLCs) is that you need to know the public key of the ultimate recipient _before_ funding the P2SH. So that is difficult for this case, where you are listing an LTC offer without knowing who will ultimately decide to sell their QORT to you. It can be done eventually, but hasn't been developed yet. The trade bot isn't an issue, as that is off chain. The tricky part with buy orders is the on-chain escrow that holds the funds while they are listed for sale (and during the trade). For QORT sell orders, the QORT is held in an AT on the Qortal chain. But for buy orders, the foreign currency (e.g. LTC) would need to be held in the equivalent of an AT on the LTC chain. LTC and the other listed coins don't support smart contracts, so the listed amount would likely have to be held in a P2SH address. The problem with a P2SH address (at least, in the context of HTLCs) is that you need to know the public key of the ultimate recipient _before_ funding the P2SH. So that is difficult for this case, where you are listing an LTC offer without knowing who will ultimately decide to sell their QORT to you.
Line 32: Line 32:
 That's not to say that it's impossible - there are ways to do this, but as you can see it's very different from the way the Trade Portal currently works. So it would need some focused development time. It was a long way down the list, so the auto buy was made as a quick interim solution. That's not to say that it's impossible - there are ways to do this, but as you can see it's very different from the way the Trade Portal currently works. So it would need some focused development time. It was a long way down the list, so the auto buy was made as a quick interim solution.
  
-**What do I need to use the Trade Portal?**+===== What Is Required To Use The Trade Portal? =====
  
 1. You must be running a Qortal Node and it must be synced. Since trading is truly decentralized, both sides must be running nodes to complete their side of the trade (peer-to-peer). For more information see [[Quick Start Guide]]. 1. You must be running a Qortal Node and it must be synced. Since trading is truly decentralized, both sides must be running nodes to complete their side of the trade (peer-to-peer). For more information see [[Quick Start Guide]].
Line 38: Line 38:
 2. You can follow the [[How To Use The Trade Portal]] guide. 2. You can follow the [[How To Use The Trade Portal]] guide.
  
-**Where do I find the Trade Portal**+===== How To Locate The Trade Portal In UI =====
  
 In the Qortal UI, there is a **Trading** tab in the left side menu.  Under that are two options:  In the Qortal UI, there is a **Trading** tab in the left side menu.  Under that are two options: 
Line 45: Line 45:
 **Auto Buy** - To automatically perform a series of individual trades **Auto Buy** - To automatically perform a series of individual trades
  
-**What is Auto Buy?**+===== What Is Auto Buy? =====
  
 Auto Buy is a tool which allows you to automatically buy a series of QORT sell orders. Rather than having to manually select and execute each trade, which can take time to complete, Auto Buy lets you specify the total amount of QORT, and the HIGHEST PRICE you would like to pay in the 'foreign coin'. Then the foreign coin AMOUNT is set automatically based on those two things. Auto Buy is a tool which allows you to automatically buy a series of QORT sell orders. Rather than having to manually select and execute each trade, which can take time to complete, Auto Buy lets you specify the total amount of QORT, and the HIGHEST PRICE you would like to pay in the 'foreign coin'. Then the foreign coin AMOUNT is set automatically based on those two things.
Line 51: Line 51:
 How it works is that the Auto Buy automatically picks the lowest trade value orders in the market, and buys up to as many orders as possible based on the amount of coin you’ve set to trade with, and up to the trade value you’ve specified. The Auto Buy does one trade at a time, and can only trade with a complete sell order - meaning if there was an order for 100 QORT @ 0.01 LTC, the trade would be for the entire 100 QORT order (not partially if you didn’t have enough LTC to make the trade). Once Auto Buy can no longer make complete sell orders based on the parameters you have given it, it will stop trading until either there is an order that it CAN fulfill, or you cancel it. How it works is that the Auto Buy automatically picks the lowest trade value orders in the market, and buys up to as many orders as possible based on the amount of coin you’ve set to trade with, and up to the trade value you’ve specified. The Auto Buy does one trade at a time, and can only trade with a complete sell order - meaning if there was an order for 100 QORT @ 0.01 LTC, the trade would be for the entire 100 QORT order (not partially if you didn’t have enough LTC to make the trade). Once Auto Buy can no longer make complete sell orders based on the parameters you have given it, it will stop trading until either there is an order that it CAN fulfill, or you cancel it.
  
-**How do I use Auto Buy?**+===== How To Use Auto Buy =====
  
-  * Log into the Qortal UI +Refer to the subsection on the [[How To Use The Trade Portal]] guide here: https://wiki.qortal.org/doku.php?id=how_to_use_the_trade_portal#how_to_use_auto_buy
-  * From the left side menu, click on **Trading** and select **Auto Buy** +
-  * In the **Select Trading Pair** drop-down at the top, select the pair you want to trade +
-  * The rest of the page will display the current sell orders under **Market Open Sell Orders**, your Trade History under **My Buy History**, and the currently active Auto Buy orders under **Active Auto Buy Orders** +
-  * Click on **ADD AUTO BUY ORDER** at the bottom of the page +
-  * A pop-up will be displayed (Confirm that the coin you want to sell is listed at the top) +
-  * Enter the amount of QORT you want to buy in the **Amount (QORT)** field +
-  * Enter the maximum price you are willing to pay per QORT in the **Price Each** field +
-  * Click on **ADD AUTO BUY ORDER** to initiate the Auto Buy script +
-  * Note that each buy order will take some time to complete because this is a peer-to-peer action including multiple transactions on both blockchains, and Auto Buy is doing a series of these orders, so it could easily be hours before your Auto Buy is complete, depending on how much you are buying, compared to the size of the Sell Orders available to buy +
-  * Note that Auto Buy is likely to never 'finish' 100% unless there are sell orders on the market that fill it perfectly. Most of the time you will need to cancel it once it gets to a point that it has a small balance and isn't likely to find any orders of the size it can fulfill +
-  * For more information about how the individual buy actions works, see [[How The Trade Portal Works]]+
trade_portal_faq.1682193755.txt.gz · Last modified: 04/22/2023 16:02 by gfactor

Page Tools