CounterTools.io is in early alpha development. Expect many things to be broken much of the time as we build initial functionality. Bug reports to @SamadhiSpeaks
Counterparty Platform Suite
Loading...
How Counterparty dispensers work and what the different price fields mean.
A dispenser is an automated vending machine for Counterparty assets, always priced in BTC. When you "dispense", you send BTC to the dispenser address and automatically receive a predetermined quantity of the asset.
Understanding these three distinct price concepts is key to using dispensers effectively:
What it means: The amount of BTC you pay when you click "dispense"
This is what you actually send to the dispenser. Same calculation for all assets.
What it means: How much of the asset you receive per dispense action
Divisible assets (like PEPECASH) use 8 decimal places. Indivisible assets (like most NFTs) are whole numbers.
What it means: The effective BTC price per single whole unit of the asset
For indivisible assets where give_quantity = 1, this equals Cost/Dispense.
Like currencies - can be split into fractions
Examples: PEPECASH, XCP, FDCARD
Storage: Quantities stored as satoshis (x100M)
Display: Divide by 100,000,000
Like collectibles - whole units only
Examples: RAREPEPE, most NFTs
Storage: Quantities stored as integers
Display: Show as-is (no conversion)
Browse dispensers on CounterTools asset pages or TokenScan.io
Look at "Cost/Dispense" - this is exactly what you'll send
Send the exact BTC amount to the dispenser address from a Counterparty-compatible wallet
Once BTC confirms, the asset is automatically sent to your address
On CounterTools asset pages, dispenser tables show:
| Column | Meaning |
|---|---|
| Source | Dispenser creator's address |
| Give Qty | Amount of asset per dispense |
| Cost/Dispense | BTC you send per dispense action |
| Price/Unit | BTC cost per whole unit of asset |
| Inventory | Remaining assets in dispenser |
| Age | How long dispenser has been active |