Freewallet.io User Manual
Freewallet.io User Manual
  • Getting Started
    • What is Freewallet?
    • What are the features of Freewallet?
    • Where can I access Freewallet?
    • Where can I access previous versions of Freewallet?
    • What is Tokenscan.io?
    • Why do I need small amounts of Bitcoin to do things in Freewallet?
    • What BTC fee should I use?
    • What is the Automatic Donation System? How do I turn it off?
    • What is an Asset/Token/NFT? How can I store them?
    • I want to trade a certain Asset, is it legitimate?
    • How to find the License Agreement
    • What else do I need to know?
  • Exploring Balances, History, Exchange and Dispensers
    • Address Balances
    • Address History
    • Viewing Tokens
    • Exploring Token Information and Enhanced Asset Information
    • Understanding Dispenser Markets
    • Buying XCP and User Created Tokens from a Dispenser
    • The Decentralized Counterparty Exchange (DEx)
    • Understanding Exchange Pairs
    • Buying and Selling XCP and Tokens on the DEx
    • Understanding BTCpay and BTC/TOKEN on the DEx
  • Freewallet Functions
    • Creating a Wallet
    • Locking and Unlocking Your Freewallet
    • Viewing, Creating and Importing Addresses
    • Show a QR Code for your Address
    • Sending and Receiving BTC
    • Sending / Receiving XCP and User Created Tokens
    • Displaying the Seed Phrase and Private Key of your Address(s)
    • Using the Multi Send function
    • Create a Counterparty Token (NFTs and FTs)
    • How to Change Token Properties
    • Changing the Token Description
    • Issuing more Token Units
    • Resetting Your Token Issuance
    • Locking Your Token Issuance
    • Transfer Token Ownership
    • Destroying Tokens
    • Paying Dividends to Token Holders
    • Voting with Tokens
    • Broadcast information on the Bitcoin blockchain
    • Signing a Message Using Freewallet
    • Signing a Transaction Using Freewallet
    • Using the Sweep Function
    • Setting up a Dispenser
    • Closing a Dispenser
    • Cancelling Exchange Orders
    • Starting an Exchange Pair that has no orders up yet on the DEx
    • Minting Open Fairmints
  • Common Questions Using Freewallet (FAQ)
    • What if you make a mistake?
    • Where can I see my current version?
    • How do I check my Freewallet Server settings?
    • How do I use the Debug function on Freewallet?
    • Can I use the Counterparty/Bitcoin Testnet in Freewallet?
    • Can I burn BTC for XCP?
    • What’s a Stamp?
    • What’s an Ordinal?
    • If Tokenscan is down for maintenance, can I still access my funds?
    • Why is there more than one input on my BTC transactions?
    • Does Freewallet support two-factor authentication?
    • Can you lock a Token description?
    • Can I run my own Counterparty server?
    • How do I use Freewallet to mint an Emblem Curated Vault?
    • How do you create a Burn Address for use on Counterparty?
  • Troubleshooting / Issues
    • I sent BTC (or a Token) to Freewallet, why doesn't it show up?
    • Why can't I see my assets I own or created with 0 issuance?
    • "Error While Trying to Broadcast Transaction"
    • "Failure to send not enough BTC in wallet"
    • My Freewallet Exchange/Dispenser tab is resetting the data when I try to sort by BTC Price?
    • "Public key was neither provided nor published in blockchain."
    • I logged in and see none of my assets but I see them on tokenscan!
    • Help! I used too small of a fee and my transaction is not confirming!
    • I sent/dispensed an XCP asset to a Wrapped Segwit Address (address beginning with "3")
    • I sent/dispensed an XCP asset to a Taproot Address (an address that starts with "bc1p")
    • I updated Freewallet and can only see my first 20 addresses! How can I get them back?
    • My second transaction on an MPMA (Multi-send) is not getting confirmed and giving me an error
    • Freewallet gave me a TX link but Tokenscan says "Transaction not found on tokenscan"
    • Error composing dividend transaction via API: ['zero dividend']
    • My MacOS/Windows is saying Freewallet is not verified by the app store. What should I do?
    • Counterparty API Communication Error!
    • What is a Counterparty API Error?
    • Stuck on "Checking Data Encoding Fees"
    • Constructed transaction does not parse correctly
    • My transaction is too low of an "Effective Fee Rate"
    • Error Composing Dispenser TX - Balance History
    • I entered my created password and stuck on "You will need to unlock..."
  • Getting Support
Powered by GitBook
On this page
  1. Exploring Balances, History, Exchange and Dispensers

Understanding Exchange Pairs

PreviousThe Decentralized Counterparty Exchange (DEx)NextBuying and Selling XCP and Tokens on the DEx

Last updated 7 months ago

Please note BTC exchange pairs are BTCpay transactions and their tutorial .

This section will go over using the “Exchange” tab to put up buy and sell orders for Counterparty assets specifically also known as the Decentralized Counterparty Exchange or DEx

Important: Before you begin, please be aware this exchange inside Freewallet is actually an interface to the Bitcoin network. This means that all tokens, buy, and sell orders are all actually individual Bitcoin transactions. These transactions are then order matched by the protocol.

This means that:

All buy and sell orders are automatically escrowed in the Bitcoin blockchain itself until they are completed. The Counterparty exchange is decentralized and peer-to-peer. This means that there is never a third party or middleman (such as a server administrator, traditional exchange, clearing house, or bank).

Disclaimer: All Freewallet (and therefore Counterparty) actions are Bitcoin transactions. And because anyone can make a Bitcoin transaction, anyone can create a decentralized token. If this concept seems confusing, consider that Bitcoin functions entirely without a central bank. This is an identical 'free-for-all' scenario. It is fundamentally impossible to have an 'owner' and or 'admins' at such an exchange. Escrowed funds are provably inaccessible until peer-to-peer orders are successfully matched, and all completed orders are irreversible.

Counterparty (the open-source Bitcoin toolkit for financial instruments and markets) itself cannot distinguish whether tokens are legitimate, so please ensure due diligence before trading. Always research the official website of the token you are trading and all details of its page on Tokenscan.

To view all XCP and Counterparty token markets simply click the Exchange tab at the top of Freewallet

You will see the tabs at the top indicating the Tokens BITCRYSTALS, PEPECASH and WILLCOIN as the default markets shown. You can also specify custom tokens to add to the ‘pinned tokens’ by clicking the gear icon to the left of the search bar in the upper right

Here you can use “Add Market” to pin any Asset market in Freewallet the Exchange homepage. Most tokens are primarily traded against XCP, but you can trade absolutely any token against any token. For instance, you pin the token BACON to the Exchange homepage and be able to quickly access all markets associated with BACON.

With this dropdown you can also Refresh the Market data as well as determine “View Options” for specific tokens you are looking to buy and sell such as Named, Subasset and Numeric tokens.

If you search for a specific asset only in the search box, Freewallet will show you all the markets that have any history of orders with that specific Token. For example here let’s search BREITBARTPEP

This example above is the Markets shown for the token: BREITBARTPEP.

If trading this token against PEPECASH or XCP is what you are looking for, then simply click the link of the token on the left side to take you to the pair. Any token on the Counterparty DEx can be traded for any other token. Despite this token having only two pairs with active or historical trades, other tokens like PEPECASH for instance will have many pairs due to its popularity.

To learn more about viewing specific pairs and creating Counterparty DEx orders, move forward to the .

If theoretically you wanted to start a new market pair that has no sales history yet (for instance: BREITBARTPEP/RAREPEPE) you can start a new order in a new market pair by checking out . Some Freewallet features may be restricted due to regulatory uncertainty in certain countries. This does not mean that they are disabled in the decentralized exchange. These features are simply hidden from the user interface by default to avoid legal issues. Like Bitcoin, Counterparty exists without international borders. So, it is absolutely possible to use any of the features in any country by running your own copy of Freewallet, Counterwallet or Counterparty-cli, but please make 100% sure you are operating within the law before attempting this.

Buying and Selling XCP and Tokens on the DEx
Starting an Exchange Pair that has no orders up yet on the DEx
can be read here
PEPECASH trades against 2057 different market pairs!