Frequently asked questions

From Bisq Wiki
Jump to navigation Jump to search

Below is a compilation of frequently-asked questions (FAQ) about Bisq, how to use it, and how to help the project.

Feel free to ask further questions on any of Bisq's many outreach channels.

Contents

About

How is Bisq different from other decentralized exchanges?

Bisq is a peer-to-peer trading network, not a website or "app" or other centralized service. It's software you run on your own hardware, which connects to other people running the Bisq software to facilitate trades. It's open-source and community-driven.

And you can trade bitcoin for fiat currencies with it!

The difference between Bisq and other so-called decentralized exchanges is as stark as the difference between owning your own home and renting someone else's—in the former case you have full control over the property, and in the latter you're always subject to the landlord's whims and demands (no matter how nice the landlord may seem to be).

With Bisq you're always the owner—not just owner of your bitcoin, but also owner of your data.

  • Bisq does not hold any bitcoin. All bitcoin used for trading is held in 2-of-2 multisignature addresses controlled solely by the trading peers themselves.
  • Bisq does not hold any national currency. National currency is transferred directly from one trader to the other using traditional banking and payment services.
  • All Bisq data is transferred over its own secure peer-to-peer network, which is built on top of the Tor network—no central servers. This means there are no data honeypots, rendering large-scale hacks of customer information databases impossible.
  • Bisq does not know anything about traders who use its network, and no data is stored on who trades with whom.
  • Bisq does not require registration, so your privacy is protected, and you can begin trading instantly.
  • Bisq is code, not a company. It is an open-source project organized as a decentralized autonomous organization (DAO) built on top of Bitcoin.

See more in the Introduction.

Is Bisq open-source software?

Bisq's software is free/libre open-source licensed under Version 3 of the GNU Affero General Public License.

Here's the source code and license.

Is Bisq safe?

Thanks to strong incentives encouraging traders to play fairly, the vast majority of trades on Bisq go smoothly and quickly.

Bisq employs three primary mechanisms to achieve security:

  • All bitcoin traded with Bisq is secured in a 2-of-2 multisignature address.
  • Both traders are required to pay security deposits, which are refunded after trades are completed.
  • Trade disputes are handled through a 3-tier mechanism that includes end-to-end encrypted trader chat, mediation, and arbitration.

When trading fiat currency for bitcoin, there is always some chargeback risk, as fiat transactions can often be reversed.

To mitigate this risk, Bisq:

  • only supports payment methods which are known to make chargebacks difficult—this is why Bisq does not support PayPal and credit cards, for example. See more on chargeback risks.
  • employs an signing mechanism that forces 0.01 BTC buy limits until a buyer's integrity (not identity!) is verified.

Getting started

I find Bisq very confusing. I've tried using it but just end up getting lost!

Some people find Bisq's interface intuitive, but many people don't. Check out this tour video to help you make sense of the interface, and then check out the Bird's Eye View of a Bisq Trade video for a high-level overview of how Bisq trading works.

Then check out the getting-started guide to see how to get up and running quickly.

As of April 2021, Bisq contributors have designed a whole new beautiful interface that should make Bisq significantly more intuitive, and are also in touch with a talented UI developer to turn the design into code. You can follow progress on this initiative here.

I can't use Bisq to trade because there are hardly ever any offers in my currency. What can I do?

While Bisq can technically support any market, only a handful of markets are consistently active on Bisq—mainly because they offer good payment methods and had strong on-the-ground support to bootstrap them in the beginning.

Note
Note that a weak offer book in a particular market doesn't necessarily mean trades don't take place in that market. It could be that there are people lurking there that will happily take an offer if you take the initiative to make one (this is often the case in markets like CAD, AUD, and GBP, for example).

You can check trade history for your market by going to Market > Trades and picking your currency from the dropdown.

If your market has no recent trades, a little more work will need to be done to get it going. At a minimum, payment methods common in your market should be added (suggest them here), and some form of marketing should be done to get users and market-makers to bootstrap a market.

Bisq contributors are more than happy to help if you can help with guidance, connections to people who can help, and/or events and translations and other vehicles for reaching your target demographics.

I heard I need bitcoin in order to buy bitcoin on Bisq...but I don't have any bitcoin. What can I do?

Yes, the chicken-and-egg problem with Bisq is real.

Here are some ways to get just enough bitcoin to do your first trade on Bisq:

Trading

What are trading fees?

Trading fees are calculated as a percentage of trade size: 0.1% for makers and 0.7% for takers if paid in BTC and about half of that if paid in BSQ.

Keep in mind that you'll also need to pay mining fees for the on-chain transactions, as well as a deposit to lock into the multisig escrow. You'll get the deposit back in full after the trade completes successfully.

Mining fees are too high. How can I trade on Bisq cost-effectively?

Bisq's current trade protocol requires 4 on-chain transactions. Takers pay for 3 of these transactions and makers pay for 1 of them.

Therefore, to make trading on Bisq as cost-effective as possible, consider making your own offers at times when mining fees are lower.

Other things you can do:

  • make offers to trade larger amounts of BTC (bigger offers tend to get better pricing)
  • pay trade fees with BSQ (BSQ trade fees tend to be about half of BTC trading fees)

Why does Bisq require a security deposit in BTC?

Security deposits create strong incentives for buyers and sellers to follow the rules of Bisq's trading protocol. Deposits are locked into multisig escrow along with the bitcoin being traded, and are returned to each user when the trade is complete.

If a trade is disputed through a mediator or arbitrator, some or all of the offending party's security deposit may be awarded to the counterparty. Examples of protocol violations include a buyer failing to pay a seller, paying with a different account or with a different name, or a seller failing to acknowledge receipt of a buyer's payment.

Most Bisq trades complete without any problem thanks in part to the incentives that security deposits create.

See full trading rules.

What are trading limits? How much bitcoin can I buy/sell at once?

Trading limits vary based on payment method, since some payment methods are more secure than others.

Relatively safe payment methods such as Japan's Furikomi and Australia's PayID are set to allow trades of up to 1 BTC, but other payment methods such as Zelle and SEPA have a cap of 0.25 BTC. See the full list of payment methods and limits.

Altoins are not possible to charge back, so all altcoin trades have a limit of 2 BTC.

Which payment methods are available?

See payment methods.

If you'd like to suggest a payment method to be added, please submit a new issue.

How does Bisq handle fiat like dollars and euros? Where does it go?

Bisq doesn't handle fiat at all -- it only handles BTC. Trades are settled outside of Bisq, meaning fiat payments are sent outside Bisq via traditional banking services.

Bisq merely matches peers and sets incentives (e.g. locking a BTC security deposit from both peers, as a sort of escrow) to encourage both trading peers to act in good faith. This is also why you need bitcoin to begin trading on Bisq.

How long does a trade take?

There is no automatic order matching on Bisq, and trades are settled manually by humans. As a result, trades are not completed as quickly as they would be on centralized exchanges, but can still be fairly quick.

Some payment methods are instant (e.g., Faster Payment) while others can take a few days (e.g., SEPA).

As far as Bisq is concerned, the deposit transaction needs to be confirmed once before the buyer can send payment. Bitcoin transactions take about 10 minutes to confirm, so with quick traders and quick payment method, a Bisq trade can be completed in a matter of minutes.

Altcoin trade periods are always 1 day (or 1 hour for Altcoins Instant trades).

See the list of payment methods for complete details.

How does Bisq protect my privacy?

Bisq is standalone, open-source software that you can inspect before running on your machine, and as a result, you don't have to trust that any server is logging your personal details (as you would in the case of a website).

As for the trading process, your payment information is stored locally on your machine, and only your trading partner (and your mediator or arbitrator, in case of a dispute) can ever see it. All data exchanged between users is encrypted and signed.

To transmit data from one user to another, Bisq uses a P2P network built on top of Tor, which provides a high degree of anonymity. The user doesn't need to do any additional work for all of this to work—it is all integrated in the application.

Do I need to keep Bisq online for my offers to remain online?

Yes. There are no central servers on the Bisq network—so all peers are responsible for keeping their offers online.

If you have published an offer, your Bisq application needs to stay online so it can react when another trader wants to take your offer (the multisig deposit transaction is created in the take-offer process). Be sure you have deactivated your computer's standby mode so your Bisq application can stay online (monitor standby is not a problem).

If your Bisq application does go offline, your offer will get removed from the distributed offerbook. It will be re-published the next time you start your Bisq application.

After an offer has been taken and the trade process has started, neither trader needs to be online continuously, but each trader will need to be online periodically to check if any action is needed on their side (e.g. sending fiat/altcoin, confirming payment receipt, etc).

Do I have to use the Bisq wallet?

No, but you may find it convenient to keep a small amount of trading capital there.

When entering a new trade on Bisq, you will get the option to transfer funds from your Bisq wallet or send funds from an external wallet.

Likewise, when concluding a trade on Bisq, you can withdraw your funds to the Bisq wallet or to an external wallet.

Do I have to use the Bisq token?

No, using BSQ is totally optional. However, using it gets you a ~50% discount on trading fees while helping to compensate Bisq contributors at the same time.

Will my bank know I'm trading bitcoin?

Generally speaking, Bisq doesn't deal with banks at all. All fiat transfers take place directly between users.

But there have been reports of banks closing accounts upon suspecting bitcoin activity. As a result, Bisq requires that the "reason for payment" field always be left BLANK when making a payment (if the payment method offers such a field).

If a reason is required, it should be something trivial like a "-" or "payment". If you want to use something else, please agree on an alternative with your peer using trader chat. See full trading rules for more information.

Common Technical Niggles

Bisq on macOS won't open, or it's asking for permission to record my keystrokes!

If Bisq won't open, try right-clicking the app and clicking Open.

If you get the prompt asking to record your keystrokes, rest assured it's a bug (Bisq is absolutely not recording your keystrokes). This bug should be fixed with a [LTS version update] coming soon.

Bisq seems to bog down my computer. When I open it, CPU and memory usage spike. Can this be prevented?

Bisq has had memory usage and CPU usage issue on certain operating systems in the past, but these issues should be resolved now. You can manually set the max RAM usage by following these instructions.

Chances are Bisq is probably just trying to sync blockchain data. New releases of Bisq include data stores updated at release time to reduce this syncing time, but as a release gets older (i.e., beyond 3-4 weeks old), the data stores get older, and syncing takes longer. Just let it finish and your computer resources should go back down to normal again.

If the issue doesn't go away on its own, please reach out for help in the Support room on Matrix or open an issue on GitHub.

I'm on a high-resolution monitor on Linux and everything is way too small. Help?

See this article for a tip on fixing this issue.

Bisq says "this offer cannot be taken due to counterparty trade restrictions". What does that mean?

This happens in rare circumstances. Bisq checks information about an account such as its age to determine if it is allowed to trade over certain limits. The information is stored in the P2P network, and it may not yet have propagated to your node. Try again after restarting Bisq. The offer maker may need to restart Bisq in order for the information to propagate.

My SPV resync is taking all day and it keeps freezing. What can I do to make it go faster?

Unfortunately this can happen sometimes if your wallet is over a year old and/or has a lot of transactions. If the resync stalls, close and restart Bisq to continue the resync. It will go faster if you connect to a local Bitcoin node. After your SPV resync is completed, it would be best to switch to a fresh wallet.

How can I get a fresh Bisq wallet and transfer my BSQ balance to it?

The procedure involves setting aside the existing wallet directory (by renaming) in order to get a fresh wallet. The wallet directory is at btc_mainnet/wallet from the main data directory location. You'll then be able to activate either the old or new wallet by renaming the directory before starting Bisq. Be sure that Bisq is never running when you rename a directory.

  1. You have some BSQ and also some BTC balance existing in your wallet. (You need BTC to pay mining fees for sending BSQ).
  2. Close Bisq then rename your wallet directory to oldWallet.
  3. Start Bisq and it will create a fresh wallet. Note down your BSQ receiving address and also your BTC receiving address. Write down your recovery seed phrase (Under Account / Wallet Seed menu) and store it in a safe place (not online).
  4. Close Bisq and rename your wallet dir to newWallet, rename your old wallet dir to wallet, then restart Bisq.
  5. Send BSQ to your new receiving address you saved in the earlier step. Then send BTC the same way. Close Bisq.
  6. Rename wallet to oldWallet and newWallet to wallet. Then restart Bisq.

Done! Your BSQ and BTC balances have been moved to a fresh wallet.

"heightOfLastBlock must match chainHeight" error on starting Bisq

The following procedure should fix itː

  • make a backup of your data folder
  • close Bisq
  • from inside data folder, delete DaoStateStore and BsqBlocks
  • restart Bisq

"Payment started" button will not stick, always says "Please send confirmation again"

This is a known issue, stemming from how the application will err on the side of caution when P2P network conditions are less than favorable. It most often happens when the peer is offline, so usually when a seller taker accepts an open offer with a non-instant payment method, like SEPA, and then goes offline, since the payment will take at least a day to be credited and they do not need to stay connected while the buyer maker's payment arrives. Here are some things that might work

  • Send a message in trader chat
  • Insist on pressing the button tens of times
  • Restart Bisq
  • Follow menus Settings -> Network Info -> Open Tor Settings -> Delete Outdated Tor Files And Shutdown, then restart Bisq
  • Do nothing and stay online, as the button will sometimes finally "register" by itself with a random delay
  • When everything else fails, and the trade period is almost at its end, communicate your intentions to the peer in trader chat and open mediation by pressing Ctrl-O in trade window, explaining what happened to the mediator, even better by attaching a screenshot of the issue; a support ticket will be opened and both peers will have the opportunity to accept the original payout

I want to install Bisq on a VPS or on an otherwise headless system

Bisq needs a graphical desktop environment to be ran, but in order to keep offers online without the need to have your PC always on, some users reported good results by using https://www.xpra.org as a graphical endpoint which you can forward to a client.

I receive an error message on Linux, regarding Java heap space

You can increase the memory allowance to Bisq, by editing the file /opt/bisq/lib/app/Bisq.cfg, to make it read java-options=-XX:MaxRAM=16g where it says java-options=-XX:MaxRAM=8g

Dispute resolution

How does dispute resolution work?

Bisq provides a 3-layer mechanism for resolving disputes: trader chat, mediation, and arbitration.

Trader chat enables traders to resolve small issues themselves privately over end-to-end encrypted chat right in Bisq. If this doesn't work, traders can engage a mediator to examine the situation and suggest a payout. In rare circumstances that mediation fails, a trader can choose to engage an arbitrator to re-examine the situation and make a payout.

Veteran users: please note that the arbitrator role changed significantly with the launch of the new trade protocol on v1.2.

See trading rules and dispute resolution for more.

How is collusion between mediators, arbitrators, and traders prevented?

With the launch of the new trading protocol in v1.2, multisig escrows went from 2-of-3 to 2-of-2 arrangements, so that only the two trading peers have control of trading funds (instead of the 2 trading peers and an arbitrator). With no keys in the multisig escrow, it is no longer possible for a mediator or arbitrator to collude with another trader to release funds maliciously.

Mediators and arbitrators are still bonded roles, however, because even though they cannot sign a payout transaction to resolve a dispute, they can advise how to resolve a dispute, and it's important that they be responsive, responsible, and fair when doing so.

What happens if the person buying bitcoin does a chargeback after the bitcoin has been released from the multisig address?

Bisq only supports payment methods for which chargebacks are not easy (e.g., this is why PayPal and credit cards are not supported). But there is still a little chargeback risk with banks. If a bank executes a chargeback after the BTC has been released, there is nothing a mediator or arbitrator can do.

Bisq's goal is to make this scenario as unattractive as possible, using three primary mechanisms:

  1. Account aging requires newly-created fiat payment accounts on Bisq to have lower trade limits, and those limits are increased over time.
  2. Account signing requires higher-risk payment methods to be signed upon verifying the integrity of a trader before account aging kicks in. Until such accounts are signed, buy limits are set to 0.01 BTC.
  3. National currency payment methods which are found to be used for chargebacks are quickly removed.

Wouldn't a pure reputation system among traders make mediators and arbitrators unnecessary?

Pure reputation without additional dispute resolution measures is a weak protection system, as you can never avoid sybil or long con attacks.

Such mechanisms are also problematic for protecting privacy and for keeping the service decentralized.

How can I contact my trading peer?

Bisq has a built-in end-to-end encrypted chat mechanism that you can use to talk to your trading peer while the trade is in progress.

DAO

What is the Bisq DAO?

The Bisq DAO (decentralized autonomous organization) is a decentralized governance mechanism for the Bisq software, built on Bitcoin. It takes the place of a company. How good can decentralized software possibly be if it's still controlled by a single entity, like a company?

Decentralized software is no good without decentralized governance.

That's why Bisq is not a company or legal entity of any kind—instead, it's organized as a DAO. The DAO handles the software's funding and strategy-making to enable the Bisq network to thrive, and at the same time, harden it against attacks on the infrastructure that powers its leadership and operation.

In a nutshell, the Bisq DAO enables Bisq to become even more censorship-resistant, a core principle of the project from the very beginning.

Read more about the Bisq DAO in this introductory article.

How does the Bisq DAO work?

The primary purposes of the Bisq DAO are financing the project and determining strategy.

  1. Trading fees are distributed directly from traders to contributors with a token (colored bitcoin) called BSQ.
  2. Strategy is determined collectively through voting done in the Bisq software and recorded on the Bitcoin network.

Learn more about how this actually works in this series of short 3-5 minute videos.

See this article for a full list of resources to learn more.

What do I need to know about the DAO, as a trader?

First of all, you are NOT required to use the BSQ token or Bisq DAO to use Bisq.

But there are benefits to doing so: you'll pay lower trading fees by using BSQ instead of BTC.

But why have the BSQ token at all? Because it enables Bisq contributors to be paid for their work without any central wallets or points of control. When you buy BSQ, you're directly paying a Bisq contributor for their work, and in the process, helping to sustain the whole project. The dynamic this token enables is not possible with plain bitcoin.

When you use BSQ to pay trading fees, it's destroyed and 'burned' out of existence.

See more on this dynamic here.

Is Bisq using a token because it needs money? What's the issuance schedule for the token?

Bisq already earns revenue from trading fees. It's not launching this DAO and BSQ token for earning revenue—it's doing it to distribute the revenue it already earns to more people without any central points of control.

BSQ tokens are issued every time a contributor's compensation request is approved through voting, and the tokens are destroyed every time a trader uses BSQ to pay trading fees.

BSQ issuance is not a 1-time event, and its purpose is not to raise capital. You can see a walk-through of the BSQ issuance process in this video series.

Can I use Bisq without BSQ and without this DAO?

You can pay trading fees with BTC instead of BSQ. Since v1.9.8, the DAO has to be always activated.

Before the Bisq DAO, trading fees went to just a couple of wallets owned by specific Bisq contributors (arbitrators). All other contributors were not paid. Bisq needs its contributors to be paid in regular, predictable ways to ensure continual (and reliable) development, service, and growth; the Bisq DAO enables this to happen by distributing trading fees to all contributors in a totally decentralized way.

The Bisq DAO and BSQ enable a funding and governance mechanism that is [not possible with plain bitcoin]. We highly recommend you check out the documentation and video series] to learn more.

Other

This project is cool! How can I help out?

Check out the contributor checklist. We'd love to hear from you!

I have a question that isn’t covered here...?

Feel free to reach out on Matrix or any other channel.