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

Buying XCP and User Created Tokens from a Dispenser

PreviousUnderstanding Dispenser MarketsNextThe Decentralized Counterparty Exchange (DEx)

Last updated 6 months ago

It is possible to buy XCP (and all user created XCP tokens) by using the Dispensers function in Freewallet.

With the release of counterparty-core 10.4 and later versions, only Counterparty compatible wallets can initiate a Dispense. Make sure to only use the most recent Freewallet version (or wallet ) to initiate Dispenses.

This means you can also manually trigger these dispensers by sending BTC to a Dispenser address from Freewallet. With the Dispensers market tab, Freewallet will organize and show you the Dispenser details in an easily viewable manner.

For a quick overview, feel free to check out by RobotLoveCoffee on how to buy a Counterparty token that is listed in an open dispenser:

For specifically buying XCP from a dispenser, first navigate to the 'Dispensers' tab in the top of Freewallet and then click on 'XCP' to view the XCP Dispenser markets

If you are looking to view Dispenser markets for tokens other than XCP, you can add any token to be a custom tab (called a Dispenser Watchlist) by clicking the gear icon on the right and selecting "Add Dispenser Watchlist"

To add a Token you would like to view the Dispensers of, simply click the gear icon in the top right and select “Add Dispenser Watchlist.

To remove any custom Dispenser Watchlist, simply right click the watchlist and select 'Remove Watchlist'

For now, let us view the process for buying XCP. Navigate to the Dispenser list for XCP as stated before. Take note here you can organize this list by Escrowed, Give Amount, Give Remaining, BTC Price and Status by simply clicking on the text to sort by those details. The BTC Price sorting button is the most commonly used button here as it will show you the cheapest Dispensers

Keep in mind there is complete freedom for a seller to Dispense not just 1 whole token in a dispenser, but also fractions of tokens (such as XCP). It is up to you the user, to read the information correctly and understand how many tokens will Dispenser when sending BTC to these dispensers. Below is a good example:

When organizing the Dispensers for XCP in Freewallet by 'BTC price' as shown with the blue arrow, the cheapest dispensers actually are dispensing only fractions of an XCP per dispense (as shown in the red box). If you are looking to dispense 1 single XCP per BTC price (as shown in the blue box), make sure you are reading the information shown with a very keen eye before making any purchases.

This can be confusing so it is important you verify all of this information before making a purchase.

Make sure if you are buying assets from a dispenser you use a Counterparty compatible wallet so you can easily access this token as most third-party BTC wallets do not support showing Counterparty asset information like Freewallet does

It is very important to pick either the "High" priority fee, or to pick an even higher custom fee to match the current Bitcoin mempool fees at the time you wish to buy from a dispenser.

If you use a low fee your transaction will be “stuck” in the unconfirmed tab and may be dispensed instead by someone paying a higher fee to confirm before your transaction confirms.

To dispense XCP from this dispenser you can simply click the “Buy Now” button in Freewallet and the popup above will automatically fill the details according to the Dispenser Price you chose

Make sure to verify the details yet again as this action is irreversible

After you successfully send your Dispenser Buy, you will be shown this pop up in which you can View Your transaction and track the status of it on Tokenscan. This can take a few minutes to show up on Tokenscan, so it is best to be patient.

After you send your Dispenser Buy it will show up on Tokenscan in the “Unconfirmed” Tab at the bottom the of the Dispenser page. You can view more details of this transaction on the bottom right by clicking “View.”

This function still works without using the “Buy Now” feature in Freewallet, though as mentioned before, it is very recommended to send from a Counterparty supported wallet as well as either a Legacy or Segwit style Bitcoin address. Simply send the correct amount of BTC to the correct Source address as shown on the Tokenscan dispenser page to dispense the correct amount of XCP (or any token) you would like to buy.

This will automatically dispense the Token you bought to the address you sent the BTC from:

Note this information above that is shown on Tokenscan. As you can see this dispenser (at the time of the screenshot) is still open with 19 XCP remaining to give. To view this page simply click on the address of the dispenser in Freewallet and it will open the Dispenser details on Tokenscan.

You can also see the history of Dispenses as one day ago a user Dispensed 6 XCP paying a total of 0.00089994 BTC to do so.

It is imperative you also check the “Unconfirmed” tab and make sure nobody has already put in a BTC order to purchase the remaining XCP in this dispenser.

Please take note, if you see a dispenser and review it on Tokenscan and see this warning above, DO NOT send BTC to this dispenser as it is either closed or out of funds to dispense.

Review the section to understand what the Bitcoin fee environment might be at the time of purchase.

You can also check out by RARE PEPES DOT COM for a good overview on how the process works and how to read Tokenscan.io information correctly:

For even more useful information, take a look at for help with buying XCP from a dispenser, though take note this video covers using rarepepewallet.com but the process is so similar with Freewallet, that it is good information to look over:

This feature is still in discussion and many Community Members have voiced their opinions on making this feature better in the future. Please check out the and the for more information on this discussion.

What BTC fee should I use?
this video
this informative video
Counterparty Forums
Counterparty CIP Github
Horizon
as shown on the Counterparty website
this informational video
Dispensers tab selected as well as the XCP sub-tab selected
Gear icon options in upper right for Dispensers
Adding any Counterparty Token as a specific Dispenser Watchlist
Right-clicking any custom Dispenser watchlist reveals "Remove Watchlist" option
Clicking "BTC Price" to sort by Bitcoin price on Dispenser list
Buying from a Dispenser with a High Fee
A dispenser buy showing up in the "Unconfirmed" tab on Tokenscan
A successful confirmed dispense showing under the "Dispenses" tab on Tokenscan
How to buy a Counterparty token by RobotLoveCoffee