BarterDEX uses marketmaker binary to perform all the swaps. There are swapfiles for all the swaps happening in the data dir. The file names are based on requestid and quoteid of the swap.

There are different stages of a swap. In the case where a swap completes, bob gets bobspend (of alicepayment) and alice gets alicespend or alice gets the bobdeposit and bob gets the alicepayment.

In all cases where the swap doesn't complete, alice is unable to spend bobpayment and bobdeposit and bob doesn't get alicepayment.


If your swap is stuck, that does NOT mean that your funds are lost. They are in stuck state. There are different ways to make a swap unstuck. Follow along to make stuck swap unstuck. This guide will work for BarterDEX CLI, GUI, HyperDEX, dICOAPP or any other GUI that is using marketmaker binary.


Note 1: If you see that swap never started message, there is nothing you can do, the swap didn't start and it could be due to connectivity or something else. If paid only DEX fee, you will not get that back.

Note 2: dICOAPP includes all variant of current dICO dAPP. i.e. BNTNdapp, OOTdapp or PRLPAYdapp etc.

Note 3: Minimum wait is 4 hours depending at the state of the swap. Please make sure you have waited minimum 4 hours before trying to unstuck a swap using any method below.


Method 1

This should work most of the times for any product or app that is using marketmaker binary as this is the default behaviour of marketmaker. This method is recommended to use first.

  1. Wait for minimum 4 hours (Your funds should come back automatically. If not, follow the next steps)
  2. Stop your GUI app or CLI
  3. Start barterDEX, login and wait for 10 minutes
  4. If using BarterDEX GUI or HyperDEX, please activate the coin pair of the stuck swap
  5. Check your wallet address in your coin's blockchain explorer for the unstuck funds


Method 2

Do a swapstatus query using terminal with requestid and quoteid after waiting for 4 hours. For this solution you need to have the userpass value of your passphrase. If you are using CLI, you already should know this value from setup or check in userpass file. GUI users can use CTRL+SHIFT+i and find the userpass value. Once you have it edit the following command with your userpass and the requestid and quoteid. (curl is required.)

  1. Start the GUI app or CLI
  2. Activate the coins that were used in the stuck swap
  3. Issue the command in your terminal
curl --url "http://127.0.0.1:7783" --data "{\"userpass\":\"c3d8c2a364b7d18c1f9d7321d017b92e9f9c791e4f5c741214fefdea8a071256\",\"method\":\"swapstatus\",\"requestid\":2291973695,\"quoteid\":3387529385}"


Method 3

Use the BarterDEX GUI Kickstart button (will work with other GUI apps that has implemented the API)

  1. Restart the BarterDEX GUI and login
  2. Activate both coins that were involved in that stuck swap
  3. Go to exchange page
  4. From the lower-left corner click on the Details button of that specific swap to open up swap details
  5. Click on `Kickstart Stagnant Trade` and wait for upto 10 minutes
  6. Check your wallet address in your coin's blockchain explorer for the unstuck funds


Method 4

Delete the .finished file from DB/SWAPS dir for the specific swap and restart marketmaker binary. Will work with any GUI and works with CLI too. For this to work, you need to know the requestid and quoteid of the swap and find the swapfiles for that swap.

  1. Use this guide to find the location of data dir and find the swapfiles for your stuck swap Where can I find my swapfiles?
  2. Stop BarterDEX or any other GUI you are using and make sure marketmaker process is not running
  3. Delete the file that ends with .finished for your stuck swap
  4. Start barterDEX, login and wait for 10 minutes
  5. If using BarterDEX GUI or HyperDEX, please activate the coin pair of the stuck swap
  6. Check your wallet address in your coin's blockchain explorer for the unstuck funds


Method 5

BarterDEX GUI in the rescue! If you are using a GUI that doesn't have Kickstart button and you prefer to use kickstart button use this method. Check this guide to find your swapfiles Where can I find my swapfiles?

  1. Make sure no marketmaker process is running
  2. Take a backup of your BarterDEX GUI SWAPS dir first
  3. Delete all files (make sure you have performed step #2 first and have a backup)
  4. Copy all your swap files from other location (different for each GUI)
  5. Start BarterDEX GUI and login
  6. Activate both coins that were involved in that stuck swap
  7. Go to exchange page
  8. From the lower-left corner click on the Details button of that specific swap to open up swap details
  9. Click on Kickstart Stagnant Trade and wait for upto 10 minutes
  10. Check your wallet address in your coin's blockchain explorer for the unstuck funds


HyperDEX Specific Guides

My swap is stuck, what to do now?


Hopefully you got back your funds!