Getting Started

Welcome to ClearUTXO! This guide will help you get started with analyzing your Bitcoin and Litecoin addresses.

1 Creating an Account

1Visit gliese.io/register
2Enter your email and create a strong password
3Verify your email address by clicking the link we send you
4Complete your profile and you're ready to go!

Supported Browsers

🌐

Chrome

Version 90+

🦊

Firefox

Version 88+

🧭

Safari

Version 14+

📐

Edge

Version 90+

Dashboard

Your dashboard provides an overview of your account activity and quick access to key features.

Quick Stats

Total Scans - Number of addresses you've analyzed
API Requests - Your API usage this month
Active API Keys - Keys you've created for API access
Available Credit - Balance from overpayments

UTXO Analysis

Analyze any Bitcoin or Litecoin address to understand its UTXO health and spendability.

What is UTXO Analysis?

UTXO (Unspent Transaction Output) Analysis is a diagnostic tool that examines the "coins" sitting in your Bitcoin or Litecoin address. Unlike traditional bank accounts where you have a single balance, cryptocurrencies store your funds as individual "chunks" called UTXOs.

Think of UTXOs like physical cash in your wallet - you might have a $100 bill, three $20 bills, and some coins. When you spend, you use these individual pieces. UTXO Analysis tells you how healthy and efficient these "pieces" are in your crypto wallet.

Why UTXO Health Matters

Lower Transaction Fees

More UTXOs = higher fees. A healthy UTXO set means you pay less when sending crypto.

Faster Transactions

Fewer UTXOs means smaller transaction size and lower fees.

Avoid Stuck Funds

Identify "dust" UTXOs that cost more to spend than they're worth before it's too late.

Strategic Planning

Consolidate UTXOs when fee rates are low to reduce future transaction costs.

How to Analyze an Address

1
Go to Analyze page
Click "Analyze" in the navigation or go to your dashboard
2
Enter the address
Paste any valid Bitcoin (bc1..., 1..., 3...) or Litecoin (ltc1..., L..., M...) address
3
View results
Get a detailed breakdown of UTXOs, score, and recommendations

Understanding the Score

Score Range	Label	What It Means
90-100	Excellent	Your UTXO set is optimal. No action needed.
70-89	Good	Minor optimizations possible but not urgent.
50-69	Moderate	Some issues worth addressing when convenient.
30-49	Poor	Significant issues affecting efficiency.
0-29	Critical	Urgent attention needed to avoid high fees.

Score Factors

The health score is calculated from multiple factors:

UTXO Count

25% weight

Fewer UTXOs = lower transaction fees. Optimal is 1-10, critical is 500+.

Dust Ratio

20% weight

Percentage of balance in small (dust) UTXOs. Optimal is less than 1%.

Address Type

15% weight

Native SegWit (bc1q) is best, followed by P2SH (3...), then Legacy (1...).

Value Distribution

15% weight

How evenly distributed are your UTXOs. Few large is better than many tiny.

Consolidation Opportunity

15% weight

Potential savings from consolidating based on current fee environment.

Age Distribution

10% weight

Older UTXOs = more stable. All recent = potentially volatile.

Understanding Your Results

After analysis, you'll see a comprehensive report. Here's what each section means:

📊 Health Score

A 0-100 score representing overall UTXO health. Higher is better. This is your quick reference to know if action is needed.

💰 Spendable Balance

The actual amount you can spend after accounting for fees. This may differ from your total balance if you have many dust UTXOs.

🧩 UTXO Breakdown

A categorized view of your UTXOs: how many are large, medium, small, or dust. Ideally, you want fewer, larger UTXOs.

⚠️ Recommendations

Actionable suggestions based on your analysis. Follow these to improve your UTXO health and reduce future fees.

📈 Fee Estimation

Estimated cost to spend your entire balance at current fee rates. Compare this with your balance to understand efficiency.

💡 Real World Example

Scenario: You have 0.5 BTC spread across 150 tiny UTXOs from mining payouts.

Problem: To spend your full balance, you'd pay ~$50 in fees (at 20 sat/vB) because each UTXO adds ~57 vBytes (native SegWit) or ~68 vBytes (legacy) to your transactionConsolidating when fees are 5 sat/vB significantly reduces your future transaction costs, though the exact savings depend on the consolidation transaction fee itself.

Solution: ClearUTXO identifies this and recommends consolidation during low-fee periods. Consolidating when fees are 5 sat/vB saves you $37.50!

Result: After consolidation, you have 1 UTXO. Future transactions cost ~$0.50 instead of $50.

Transaction Simulation

Simulate a transaction before sending to know the exact fee cost and detect potential issues.

What is Transaction Simulation?

Transaction Simulation is like a "dry run" for your Bitcoin or Litecoin transaction. It calculates exactly what would happen if you sent a transaction - without actually sending anything or spending any fees.

Think of it as a flight simulator for crypto transactions. You can test different scenarios, amounts, and fee rates to find the optimal way to send your funds.

Why Use Transaction Simulation?

No Surprises

Know the exact fee before you commit. Never overpay or underpay again.

Risk-Free Testing

Test any scenario without risking real funds or paying fees.

Optimize Costs

Compare different fee rates and amounts to find the best option.

What You Can Simulate

Exact fee calculation - Know precisely what you'll pay in network fees
UTXO selection preview - See which UTXOs will be used as inputs
Balance verification - Confirm you have enough to cover amount + fees
Change output analysis - See how much change you'll receive back
Issue detection - Get warnings about dust outputs, high fees, or other problems

Understanding Simulation Results

Transaction Size

Measured in vBytes

The virtual size of your transaction. More inputs (UTXOs) = larger size = higher fees. SegWit addresses have smaller virtual size.

Input Count

UTXOs being spent

Number of UTXOs needed to cover your send amount. Fewer inputs = lower fees. If this number is high, consider consolidating first.

Total Fee

In BTC/LTC and USD

The exact amount you'll pay to miners. Calculated as: Transaction Size × Fee Rate. Compare this to your send amount to check efficiency.

Change Amount

Returned to you

The leftover amount sent back to your wallet. If change would be dust (too small), consider adjusting your send amount.

Effective Fee Rate

sat/vB

The actual fee rate of your transaction. Use this to compare with current mempool conditions and estimate confirmation time.

Common Use Cases

💸 Before Large Transfers

Moving significant funds? Simulate first to ensure you're not overpaying on fees or creating problematic change outputs.

🏪 Merchant Payments

Need to pay an exact amount? Simulate to make sure you have enough after fees and won't create dust.

🔄 Consolidation Planning

Planning to consolidate UTXOs? Simulate to find the optimal fee rate that balances speed and cost.

📊 Fee Comparison

Test different fee rates to see how much you'd pay at 1, 5, 10, or 20 sat/vB and choose accordingly.

Common Warnings

Warning	Meaning	Solution
`INSUFFICIENT_FUNDS`	Not enough balance	Add more funds or reduce amount
`DUST_OUTPUT`	Sending amount too small	Increase amount above dust threshold
`DUST_CHANGE`	Change would be dust	Adjust amount or fee
`HIGH_FEE`	Fee seems excessive	Lower the fee rate

Widget Embed

Add a live UTXO health score to any website with a single script tag.

What is the Widget?

The ClearUTXO widget is a lightweight, embeddable card that fetches a minimal health score for an address and renders a professional score display. It is designed for dashboards, blogs, portfolio trackers, and integration pages where you want a clean, trustable health indicator.

The widget can be styled with a light or dark theme, and can render in a compact or detailed layout.

Why Use the Widget?

Zero UI Work

Paste the snippet and the widget renders instantly.

Live Score

Shows score, grade, and key stats from the latest API response.

Brand Safe

Clean layout with consistent typography and neutral color palette.

How to Embed

1
Load the script
Include the widget script once on your page.
2
Add a target div
Set the address and optional theme/dimension attributes.
3
Done
The widget fetches the score and renders automatically.

Example Snippet

For dynamic content, call window.ClearUtxoWidgetInit() after you inject the element.

Widget Attributes

Attribute	Required	Default	Description
data-clearutxo-address	Yes	-	Address to analyze
data-clearutxo-chain	Yes	btc	Chain ID: btc, ltc
data-clearutxo-theme	No	dark	Theme: light or dark
data-clearutxo-dimension	No	detailed	Layout: simple or detailed

API Keys Management

Create and manage API keys to integrate ClearUTXO into your applications.

Creating an API Key

1Go to Dashboard → API Keys
2Click "Generate New Key"
3Enter a label (e.g., "Production Server")
4Copy and save your key immediately! It's shown only once.

Security Best Practices

• Never share your API key publicly
• Don't commit keys to version control
• Use environment variables in code
• Rotate keys periodically
• Delete unused keys immediately

Subscription & Billing

Choose the plan that fits your needs and pay with cryptocurrency.

Feature	Free	Basic	Pro
Price	$0	$24/mo	$99/mo
Daily Scans	5	Unlimited	Unlimited
API Access	❌	✓	✓
Monthly API Requests	-	10,000	250,000
TX Simulation	❌	✓	✓

Payment Methods

We accept cryptocurrency payments:

Bitcoin (BTC)Litecoin (LTC)Ethereum (ETH)USDTUSDCSolana (SOL)

Glossary

Common terms used in ClearUTXO and cryptocurrency.

UTXO

Unspent Transaction Output - the "coins" you own in Bitcoin/Litecoin.

Satoshi

Smallest unit of Bitcoin (0.00000001 BTC).

Dust

Very small UTXOs that cost more to spend than they're worth.

SegWit

Segregated Witness - a Bitcoin upgrade for lower fees.

Fee Rate

Transaction fee per virtual byte (sat/vB).

Mempool

Waiting area for unconfirmed transactions.

Consolidation

Combining many UTXOs into fewer, larger ones to save on future fees.

Getting Help

Need assistance? We're here to help.

Email Support

[email protected]

Twitter / X

@glieseUtxo