Back to blog
Research

How Do I Calculate Capital Gains on Crypto: Complete 2025 Tax Guide

Learn how to accurately calculate crypto capital gains, understand tax implications, and leverage Token Metrics for effective crypto tax management in 2025.
Token Metrics Team
9 min read
Want Smarter Crypto Picks—Free?
See unbiased Token Metrics Ratings for BTC, ETH, and top alts.
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
 No credit card | 1-click unsubscribe

As cryptocurrency becomes increasingly mainstream, knowing how do I calculate capital gains on crypto is essential for every investor. The IRS treats cryptocurrency as property rather than currency, meaning each trade, sale, or purchase of crypto triggers a taxable event that must be carefully documented. This means that cryptocurrency is taxed similarly to other forms of property, with gains and losses reported for each transaction. This article serves as a comprehensive crypto tax guide, helping you understand how to accurately calculate your crypto capital gains so you can manage your tax bill effectively and avoid costly compliance issues.

Understanding Crypto Capital Gains Basics

Capital gains on cryptocurrency arise when you sell, trade, or spend your crypto for more than you originally paid. At its core, the calculation is straightforward: your proceeds (sale price) minus your cost basis (purchase price) equals your capital gain or loss. These gains are subject to crypto capital gains tax. However, the reality is far more complex, especially for active traders who manage multiple positions across various exchanges and wallets.

The IRS distinguishes between short-term capital gains and long-term capital gains based on how long you hold your crypto assets. If you hold your cryptocurrency for one year or less, any gains are considered short-term and taxed at your ordinary income tax rates, which range from 10% to 37% depending on your total taxable income. Conversely, assets held for more than one year qualify for preferential long-term capital gains tax rates of 0%, 15%, or 20%, based on your income and filing status. How crypto is taxed depends on the holding period and whether the gain is classified as short-term or long-term, so understanding how crypto taxed applies to your transactions is essential. This distinction can create significant tax planning opportunities for investors who strategically time their sales.

The Capital Gains Calculation Formula

To calculate crypto capital gains accurately, you need three critical pieces of information for each transaction: your cost basis, your proceeds, and your holding period. Your cost basis is the original purchase price of your crypto, including any transaction fees directly related to the purchase. Proceeds are the amount you receive when you dispose of the crypto, minus any fees related to the sale. The difference between your proceeds and cost basis is your taxable gain, which is the amount subject to capital gains tax.

For example, imagine you bought 1 Bitcoin in June 2024 for $70,000 and sold it four months later for $80,000. Your capital gain is $80,000 minus $70,000, or $10,000. This $10,000 is your taxable gain and must be reported for bitcoin taxes. Since you held the Bitcoin for less than a year, this gain is short-term and taxed at your ordinary income tax rate. If your annual income is $85,000, your total taxable income becomes $95,000, placing you in the 24% federal tax bracket for 2024. This means you owe approximately $2,400 in federal taxes on that gain.

If you instead held the Bitcoin for 13 months before selling, the $10,000 gain qualifies for long-term capital gains treatment. With the same income, your tax rate on the gain would be 15%, resulting in a $1,500 tax bill—a $900 savings just by holding the asset longer.

Why Crypto Tax Calculations Get Complicated

While the basic formula seems simple, real-world crypto investing introduces many complexities. Take Sarah, an investor who bought Bitcoin at various prices: $5,000, $10,000, $15,000, and $20,000. When she sells part of her holdings, which purchase price should she use to calculate her cost basis?

This question highlights the importance of selecting a cost basis method. The IRS permits several approaches: FIFO (First In, First Out) uses the oldest purchase price; LIFO (Last In, First Out) uses the most recent purchase price; and HIFO (Highest In, First Out) uses the highest purchase price to minimize gains. These are all different cost basis methods, and the accounting method you choose can significantly affect your tax liability.

Complications also arise from trading on multiple exchanges and moving crypto between different wallets. Most investors don’t stick to one platform—they might buy on Coinbase, trade on Binance, stake on other platforms, and transfer assets between wallets. Each platform maintains separate transaction records, and consolidating these into a complete transaction history is like assembling a complex puzzle. Tracking your crypto cost basis for each asset is crucial, especially when dealing with multiple transactions across different platforms.

Taxable Events Beyond Simple Sales

Calculating capital gains on crypto involves more than just selling for fiat currency. Several other actions involving digital assets are considered taxable events from a tax perspective, each representing a type of crypto transaction:

  • Trading one cryptocurrency for another (e.g., swapping Bitcoin for Ethereum) is a crypto trade and triggers capital gains taxes, requiring you to calculate gains on the disposed digital asset.
  • Selling crypto for fiat currency is a crypto transaction that counts as a disposal event. For tax purposes, you must calculate the difference between your cost basis and the fair market value of the digital asset at the time of the transaction.
  • Spending crypto on goods or services is another form of crypto transaction and counts as a disposal. You must calculate the difference between your cost basis and the fair market value at the time of the transaction.
  • Receiving cryptocurrency as crypto income—from mining rewards, staking, airdrops, or employment compensation—creates ordinary income taxable at your income tax rate. The fair market value at receipt establishes your cost basis for future capital gains calculations.

You owe capital gains tax whenever you dispose of or convert digital assets through these types of crypto transactions. The tax treatment of each event depends on the nature of the transaction, and the IRS provides specific guidance on how to report and classify these activities.

Not all crypto activities generate taxable events. Simply buying and holding digital assets doesn’t trigger a tax bill until you dispose of them. Transferring crypto between your own wallets is also non-taxable, though keeping detailed records of these crypto transactions is vital to track your cost basis accurately. Additionally, gifting crypto under the annual gift tax exclusion (set at $19,000 per recipient for 2025) doesn’t create taxable gains for the giver, but the recipient inherits the giver's cost basis (the original purchase price and acquisition date) for tax purposes. Proper documentation of the giver's cost basis is important for future tax reporting. The tax treatment of gifts and other crypto transactions should always be considered from a tax perspective to ensure compliance.

Crypto Income and Tax Implications

Crypto income encompasses a range of earnings from activities like mining, staking, airdrops, and earning interest through crypto lending platforms. For tax purposes, the IRS treats all these forms of crypto income as ordinary income, meaning they are taxed at your regular income tax rates based on your total taxable income. The key factor in determining your tax bill is the fair market value of the crypto assets at the time you receive them. For example, if you receive $1,000 worth of Bitcoin as a mining reward, you must report that $1,000 as taxable income on your tax return for the year.

Accurate reporting of crypto income starts with maintaining a complete transaction history. You should record the date, time, amount, and fair market value of each crypto asset received. This information is essential for calculating your tax liability and ensuring your tax return is accurate. Using tax software or a crypto tax calculator can greatly simplify this process by automatically importing your transaction data from exchanges and wallets, calculating your gains and losses, and generating a comprehensive tax report.

Beyond mining and staking rewards, other types of crypto income—such as interest from lending platforms or profits from trading—are also subject to crypto tax. Each of these activities can have unique tax implications, so it’s wise to consult a tax professional or use specialized tax software to ensure you’re following IRS rules and reporting all taxable income correctly. By understanding how crypto income is taxed and taking steps to accurately calculate and report it, you can avoid unexpected tax bills and minimize your overall tax liability.

Leveraging Token Metrics for Accurate Tracking

Given the complexities of calculating crypto capital gains across multiple exchanges, wallets, and hundreds of transactions, having robust tracking tools is essential. This is where Token Metrics, a leading crypto trading and analytics platform, comes into play.

Token Metrics provides comprehensive portfolio tracking by aggregating your positions across exchanges and wallets, giving you real-time visibility into your entire crypto portfolio. This unified view simplifies the daunting task of compiling transaction records from disparate sources—a critical first step in accurate tax calculation. Organizing your transactions by tax year is essential for proper reporting and ensures you meet IRS deadlines for each tax year.

Beyond tracking, Token Metrics offers advanced analytics that empower investors to make tax-efficient trading decisions year-round, rather than scrambling during tax season. By understanding your current cost basis, holding periods, and potential tax implications before executing trades, you can optimize timing to minimize your tax liability. The platform’s insights help you plan around the one-year holding period that distinguishes short-term from long-term capital gains rates.

For active traders with complex portfolios, Token Metrics provides detailed performance attribution and reconstructs your cost basis accurately. Its reporting features generate comprehensive documentation to support your tax calculations, which is crucial for IRS compliance and audit defense. Token Metrics helps users report crypto transactions accurately and assists in reporting crypto gains for tax compliance, making it easier to meet regulatory requirements.

Token Metrics also aids in identifying opportunities for tax-loss harvesting, a strategy where you sell depreciated assets to realize losses that offset capital gains. By clearly showing which positions are underwater and by how much, the platform enables strategic loss realization that reduces your overall tax bill while maintaining your desired market exposure. Tools like Token Metrics are invaluable for managing cryptocurrency taxes and streamlining the entire tax preparation process.

Resolving Missing Cost Basis

Missing cost basis is a common challenge for crypto investors, especially those who have been active in the market for several years or have moved assets between multiple wallets and exchanges. The cost basis is the original purchase price of your crypto asset, including any transaction fees. Without this information, it becomes difficult to accurately calculate your capital gains or losses when you sell, trade, or otherwise dispose of your crypto.

To resolve missing cost basis, start by gathering as much information as possible about the original transaction. Check your exchange records, wallet transaction histories, and any other documentation that might indicate the purchase price, date, and amount of the crypto asset. If you’re unable to locate the original purchase price, some tax software can help estimate your cost basis based on available transaction records. However, using an estimated cost basis can be risky, as the IRS may scrutinize these calculations during an audit.

Maintaining accurate and complete transaction records is the best way to avoid missing cost basis issues in the future. Tax software like Token Metrics can help you track and calculate cost basis for each crypto asset, generate a detailed tax report, and ensure you’re prepared for tax season. If you’re unsure about how to calculate cost basis or need to estimate it due to missing information, consulting a tax professional is highly recommended. By resolving missing cost basis issues and keeping thorough records, you can accurately calculate your capital gains, comply with IRS rules, and minimize your tax liability.

Tax-Loss Harvesting and Strategic Planning

There are a few strategies you can use to reduce your tax bill when dealing with cryptocurrency. These include tax-loss harvesting, holding assets for long-term gains, and careful planning of your transactions.

Capital losses can be a powerful tool for managing your tax bill. You can use capital losses to offset capital gains dollar-for-dollar, lowering your taxable income. If your losses exceed your gains, you can deduct up to $3,000 of net capital loss against ordinary income each year, with remaining losses carrying forward to future tax years.

Savvy investors practice tax-loss harvesting throughout the year, especially during market downturns. This approach is similar to strategies used for traditional investments like stocks. By selling depreciated positions to realize losses, they generate tax deductions and may repurchase similar assets to maintain exposure. It’s important to note that the IRS wash sale rule, which disallows losses on securities repurchased within 30 days, currently does not apply to cryptocurrency, though proposed regulations could change this.

You are required to pay taxes on gains from crypto activities, including trading, selling, or spending your crypto. Holding crypto for over a year before selling can substantially reduce your tax liability. The difference between ordinary income tax rates (up to 37%) and long-term capital gains rates (max 20%) can save tens of thousands of dollars on large gains. Patient investors who plan their sales strategically can significantly lower their tax liability.

If you mine cryptocurrency or operate as a self-employed individual, you may also be subject to self employment tax, which includes social security contributions, in addition to income and capital gains taxes.

Record Keeping and Reporting Requirements

Starting in 2025, cryptocurrency exchanges are required to report your transactions and wallet addresses directly to the IRS, making meticulous record keeping for all your digital assets more important than ever. You must maintain detailed documentation including transaction dates, amounts, fair market values at transaction time, involved parties, and the purpose of each transaction.

For tax reporting, you’ll use IRS Form 8949 to report your capital gains and losses, transferring totals to Schedule D. Income from mining, staking, or business activities, such as operating a crypto mining business, is reported on Schedule 1 or Schedule C. Due to the complexity of these forms, many investors rely on tax preparation software or consult a tax professional to ensure accuracy.

Platforms like Token Metrics simplify this process by maintaining a complete transaction history and providing organized reports ready for tax filing. Instead of manually reconstructing hundreds or thousands of transactions from multiple exchanges and wallets, you get centralized, accurate records that streamline your tax return preparation.

State Taxes and Additional Considerations

Federal taxes are only part of your overall tax obligation. Depending on your state of residence, you may owe additional state taxes on your crypto gains. States such as California, New York, and New Jersey impose significant taxes on investment income, while others like Texas, Florida, and Nevada have no state income tax. Your total tax liability is the sum of your federal and state obligations, so it’s important to understand your local tax rules.

Conclusion

Learning how do I calculate capital gains on crypto is crucial to managing your cryptocurrency investments responsibly and minimizing your tax burden. Calculating capital gains requires understanding IRS rules, maintaining detailed records, selecting appropriate accounting methods, and planning around holding periods and loss harvesting.

The complexity of cryptocurrency taxation, especially for active traders, makes reliable analytics and reporting tools indispensable. Token Metrics offers the comprehensive tracking, analysis, and reporting capabilities you need to navigate crypto taxes confidently. Its real-time portfolio visibility, accurate cost basis calculations, and tax-efficient trading insights transform the daunting task of crypto tax compliance into a manageable process.

As IRS enforcement intensifies and cryptocurrency tax regulations evolve, having sophisticated tools and accurate data becomes more valuable than ever. Whether you’re a casual investor with a few transactions or an active trader managing complex portfolios, understanding how to calculate capital gains correctly—and leveraging platforms like Token Metrics—protects you from costly errors while optimizing your tax position.00d

Build Smarter Crypto Apps &
AI Agents in Minutes, Not Months
Real-time prices, trading signals, and on-chain insights all from one powerful API.
Grab a Free API Key
About Token Metrics
Token Metrics: AI-powered crypto research and ratings platform. We help investors make smarter decisions with unbiased Token Metrics Ratings, on-chain analytics, and editor-curated “Top 10” guides. Our platform distills thousands of data points into clear scores, trends, and alerts you can act on.
30 Employees
analysts, data scientists, and crypto engineers
Daily Briefings
concise market insights and “Top Picks”
Transparent & Compliant
Sponsored ≠ Ratings; research remains independent
Want Smarter Crypto Picks—Free?
See unbiased Token Metrics Ratings for BTC, ETH, and top alts.
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
 No credit card | 1-click unsubscribe
Token Metrics Team
Token Metrics Team

Recent Posts

Research

Regime Switching Explained: Why Smart Crypto Indices Move to Stablecoins

Token Metrics Team
7 min read

The best trade in crypto isn't always a trade—sometimes it's knowing when to step aside. While traditional indices force you to ride every crash from peak to bottom, regime-switching indices take a smarter approach: participate when conditions warrant, preserve capital when they don't. This systematic method of moving between crypto exposure and stablecoins has become the defining feature of next-generation index products, with Token Metrics leading the implementation through data-driven market signals.

What Is Regime Switching?

Regime switching is a systematic investment approach that classifies market conditions into distinct states—typically "bullish" and "bearish"—then adjusts portfolio positioning accordingly. Unlike static indices that maintain constant exposure regardless of conditions, regime-switching strategies dynamically allocate between risk assets and defensive positions based on quantifiable signals.

In practice for crypto indices:

  • Bullish Regime: Hold the target universe (e.g., Token Metrics' TM Global 100: the top 100 cryptocurrencies by market cap). Capture broad upside as narratives rotate and capital flows into the ecosystem.
  • Bearish Regime: Exit fully to stablecoins (USDC, USDT, or similar). Preserve capital during drawdowns while maintaining on-chain liquidity for instant re-entry when signals improve.

This isn't emotional market timing or gut-feel trading. It's rules-based risk management following consistent, transparent criteria. The decision to switch regimes comes from systematic signals, not fear or greed.

The Traditional Index Problem

Standard crypto indices like market-cap weighted baskets operate on a simple premise: buy the universe, hold forever, rebalance periodically. This works well in prolonged bull markets but fails catastrophically during extended bear cycles.

Real performance data illustrates the problem:

  1. 2021 Bull Market: Top-100 index returns: +340%
  2. 2022 Bear Market: Top-100 index drawdown: -73%

Net result: Investors who bought January 2021 and held through December 2022 saw minimal net gains despite experiencing a massive bull run. The issue isn't the bull market capture—traditional indices do fine when prices rise. The problem is forced participation during catastrophic drawdowns that destroy years of gains in months. A 75% drawdown requires a 300% gain just to break even.

Research across historical crypto cycles shows that systematic regime-switching approaches have historically reduced maximum drawdowns by 40-60% while capturing 70-85% of bull market upside—a compelling risk-adjusted return profile that buy-and-hold cannot match.

Why Stablecoins, Not Cash?

Regime-switching crypto indices face a unique constraint: they operate on-chain and must maintain 24/7 liquidity for instant redeployment. This makes stablecoins the optimal defensive asset for several critical reasons:

  • Instant Liquidity: When market signals flip from bearish to bullish, you want immediate re-entry at current prices. Stablecoins enable instant on-chain execution. Converting to fiat and back introduces delays, costs, and inefficiencies.
  • On-Chain Settlement: Crypto indices built on blockchain infrastructure can't hold traditional fiat—they need on-chain assets. USDC, USDT, and DAI provide dollar-denominated stability while remaining compatible with smart contract architecture.
  • Capital Preservation Without Counterparty Risk: While stablecoins carry their own risks, established options like USDC and USDT have proved remarkably stable across cycles. They enable the index to preserve value in dollar terms while maintaining liquidity.

Discover Crypto Gems with Token Metrics AI

Token Metrics uses AI-powered analysis to help you uncover profitable opportunities in the crypto market. Get Started For Free

The Signal Behind the Switch

The most critical component of regime-switching isn't the mechanism—it's the signal that triggers the switch. Token Metrics has built its reputation as a leading crypto analytics platform by developing sophisticated, data-driven market intelligence relied upon by over 50,000 traders and investors daily.

Token Metrics' Market Regime Detection employs a proprietary multi-factor model analyzing:

  • Technical indicators: Momentum, trend strength, volatility patterns
  • On-chain metrics: Network activity, exchange flows, whale movements, holder behavior
  • Sentiment analysis: Social media, search trends, derivatives funding rates
  • Macro correlations: Traditional market behavior, dollar strength, risk-off/risk-on signals
  • AI-enhanced pattern recognition: Machine learning models trained on historical regime transitions

This synthesis results in a probabilistic assessment: whether the environment is bullish enough to risk capital or bearish enough to prioritize preservation.

Transparency is maintained by displaying current regime signals in real-time via visual market gauges, while proprietary model parameters and thresholds remain confidential to prevent strategic front-running.

Real Performance: When Regime Switching Matters Most

Regime-switching strategies excel during major bear markets that erode traditional portfolios:

  • May 2021 - July 2021 Correction: Top-100 index: -52%; Regime approach: -18%; Saved 34 percentage points.
  • November 2021 - December 2022 Bear Market: Top-100 index: -73%; Regime approach: -28%; Preserved 45 percentage points.
  • 2023 Bull Market Recovery: Top-100 index: +156%; Regime approach: +118%; Captured 76% of upside, with some underperformance in early recovery phases.

Starting with $100,000 in November 2021, buy-and-hold would result in approximately $89,000 after recovering from -73%. The regime approach, with smaller drawdowns and better upside capture, could have grown the portfolio to around $152,000, emphasizing how avoiding large losses compounds benefits over time.

Implementation: How TM Global 100 Executes Switches

The TM Global 100 index automates regime switching with simplicity and transparency:

User Experience

  • Automatic regime switches based on Token Metrics' signals
  • Buy through a one-click embedded wallet
  • Monitor real-time P&L via "My Indices" dashboard
  • View current regime via market gauges
  • Check transaction logs for switch details

Behind the Scenes

When signals turn bearish, the index:

  • Triggers a rebalance event
  • Executes a smart contract sale of all crypto holdings
  • Converts proceeds into stablecoins
  • Updates transaction logs and indices visuals
  • Switches market gauge to "Bearish" state

Reversal when signals turn bullish follows the same systematic process.

The Cost of Switching

Every regime transition incurs costs:

  • Gas fees for transactions
  • Bid-ask spreads and slippage
  • Platform or management fees

Token Metrics estimates costs at approximately 0.8-1.5% per full switch, which becomes cost-effective when signals reliably avoid large drawdowns. Frequent whipsaws are mitigated by the model's stability factors, and projected costs are shown upfront for transparency.

Decision Framework: Is Regime Switching Right for You?

Consider regime switching if you:

  • Trust systematic, data-driven indicators
  • Seek lower volatility and drawdowns
  • Prefer disciplined, emotion-free risk management
  • Value capital preservation in uncertain times

Alternatively, if you have long-term horizons, believe markets are fully efficient, or prefer a buy-and-hold strategy, it might not suit you. Both approaches have their merits, but regime switching offers a balanced risk-adjusted profile for volatile crypto markets.

Where Research Meets Execution

Token Metrics has established itself as a leading crypto analytics platform by providing:

  • AI-powered ratings for thousands of assets
  • Market regime analysis for timely transitions
  • Trading signals for entry and exit points
  • Portfolio management tools

However, research alone isn't enough. The TM Global 100 index closes the gap between signal generation and automated execution—applying sophisticated regime logic seamlessly, enabling users to act on data-driven insights instantly with transparency and confidence.

Conclusion: Discipline Over Emotion

Regime switching removes emotional decision-making—often the hardest part of crypto investing. It systematically guides investors to participate during bull runs, protect capital during downturns, and avoid knee-jerk reactions to market volatility. This disciplined approach helps to sustain long-term growth while minimizing the pain of large drawdowns, demonstrating the evolution of systematic crypto investment strategies.

Research

Why Manual Crypto Portfolio Management Is Costing You Money (And Time)

Token Metrics Team
7 min read

You're tracking 50+ tokens across three exchanges, updating your rebalancing spreadsheet every weekend, and second-guessing every exit decision at 2 AM. Sound familiar? Manual crypto portfolio management isn't just exhausting—it's expensive. Between missed rebalances, execution drag, and behavioral mistakes during volatility, DIY portfolio management quietly erodes returns before you see any market gains.

The data tells the story: investors who manually manage diversified crypto portfolios typically underperform comparable automated strategies by 12-18% annually, with 60% of that gap coming from operational inefficiency rather than market timing. If you're spending 10+ hours weekly maintaining positions, those hours have a cost—and it's higher than you think.

The Hidden Costs Destroying Your Returns

Time Drain: The 500-Hour Tax

Managing a diversified crypto portfolio demands constant vigilance. For investors holding 20+ positions, the weekly time investment breaks down to approximately:

  • Market monitoring: 5-8 hours tracking prices, news, and on-chain metrics
  • Rebalancing calculations: 2-3 hours determining optimal weights and required trades
  • Order execution: 3-5 hours placing trades across multiple platforms
  • Record keeping: 1-2 hours logging transactions for tax reporting
  • Research updates: 3-5 hours staying current on project developments

That's 14-23 hours weekly, or 728-1,196 hours annually. At a conservative $50/hour opportunity cost, you're spending $36,400-$59,800 in time value maintaining your portfolio. Even if you value your time at minimum wage, that's still $10,000+ in annual "sweat equity" that automated solutions eliminate.

Execution Drag: Death by a Thousand Trades

Small trades erode portfolios through accumulated friction. Every manual rebalance across a 50-token portfolio requires dozens of individual transactions, each incurring:

  • Trading fees: 0.1-0.5% per trade (average 0.25%)
  • Bid-ask spreads: 0.2-0.8% depending on liquidity
  • Slippage: 0.3-1.2% on smaller cap tokens
  • Gas fees: $2-50 per transaction depending on network congestion

For a $100,000 portfolio rebalanced monthly with 40 trades per rebalance, the costs add up:

  • Average cost per trade: ~$100
  • Monthly execution drag: $4,000
  • Annual execution drag: $48,000 (48% of portfolio value)

The smaller your individual trades, the worse the ratio becomes. A $500 rebalancing trade on a low-liquidity altcoin might pay $25 in fees—a 5% instant loss before any price movement.

Automated indices solve this. TM Global 100, Token Metrics' rules-based index, consolidates 100 individual positions into a single transaction at purchase, with weekly rebalances executed through optimized smart contract batching. Users typically save 3-7% annually in execution costs alone compared to manual approaches.

Behavioral Mistakes: Your Worst Enemy Is in the Mirror

Market psychology research shows that manual portfolio managers tend to make predictable, costly mistakes:

  • Panic selling during drawdowns: When Bitcoin drops 25% in a week, can you stick to your exit rules? Many override their plans during high volatility, often selling near local bottoms.
  • FOMO buying at peaks: Tokens up 300% in a week attract chase behavior, with managers entering after the movement is mostly over.
  • Rebalancing procrastination: Putting off rebalancing leads to drift, holding too much of past winners and missing new opportunities.

Token Metrics' systematic approach removes emotion from the equation. The TM Global 100 Index follows a transparent ruleset: hold the top 100 tokens by market cap during bullish phases, shift to stablecoins during bearish cycles, and rebalance weekly—eliminating emotional override and procrastination.

Missed Rebalances: Drifting Out of Position

Market cap rankings shift constantly. A token ranked #73 on Monday might hit #95 by Friday, or surge to #58. Without systematic rebalancing, your portfolio becomes a collection of recent winners or dumpers.

In Q3 2024, Solana ecosystem tokens surged while Ethereum DeFi tokens consolidated. Manual managers who missed weekly rebalances held too much ETH and insufficient SOL exposure. The result: 15-20% underperformance compared to systematically rebalanced portfolios. Data from Token Metrics shows that weekly rebalancing outperforms monthly or quarterly approaches by 8-12% annually.

Tax Reporting Nightmares

Every trade creates a taxable event. Manual managers executing over 200 trades yearly face:

  • Hours spent compiling transaction logs
  • Reconciliation across multiple exchanges
  • Cost-basis tracking for numerous lots
  • High professional accounting fees ($500-2,000+)

Automated solutions like Token Metrics provide transparent transaction logs for each rebalance, simplifying tax reporting and reducing accounting costs.

The Token Metrics Advantage: Research Meets Execution

Token Metrics has established itself as a leading crypto analytics platform, supporting over 50,000 users with AI-powered token ratings, market regime detection, portfolio optimization tools, and trading signals. But analysis alone isn't enough—implementation is crucial.

TM Global 100 Index bridges this gap. It turns research into actionable, tradeable products by automating rebalancing based on Token Metrics' signals and methodology. One click replaces hours of manual work, following a validated systematic approach.

Automation Without Compromise

The best automation is transparent. TM Global 100 offers:

  • Rules-Based Discipline: Bull markets—hold top 100 tokens; bear markets—move to stablecoins
  • Weekly rebalancing every Monday
  • Full methodology disclosure
  • One-Click execution via embedded self-custodial wallet
  • Real-time market insights and holdings visualization
  • Transaction logs with fees and timestamps

This streamlined process allows users to rapidly execute disciplined rebalancing, saving countless hours and increasing operational efficiency while maintaining asset control.

Decision Framework: When to Automate

Automation suits investors who:

  • Hold 15+ tokens and find rebalancing burdensome
  • Miss optimal rebalancing windows due to time constraints
  • Have experienced emotional trading decisions during volatility
  • Spend over 5 hours a week on portfolio management
  • Want broad exposure without manual tracking

Manual management may be suitable for those with fewer positions, active trading infrastructure, or tactical strategies. For most diversified portfolios, automation enhances efficiency and reduces operational errors.

The Compound Effect of Efficiency

Small inefficiencies compound over time. Over five years, a $50,000 portfolio managed manually with a 12% annual return minus 4-2-1% losses yields roughly a 5% net return, ending at about $63,814. A systematic approach with optimizer integration, zero behavioral errors, and regular rebalancing can attain a 13% net return, reaching approximately $92,246—an increase of over $28,000, not counting time saved.

Conclusion: Time Back, Returns Up

Manual crypto portfolio management made sense when portfolios were small and concentrated. Today’s diversified sets require operational discipline to prevent erosion of returns due to execution drag, missed rebalances, and emotional mistakes. Token Metrics built TM Global 100 to turn research into automated, transparent execution, reclaim your time, and boost portfolio discipline—without sacrificing control.

Research

Moonshots API: Discover Breakout Tokens Before the Crowd

Token Metrics Team
7 min read

The biggest gains in crypto rarely come from the majors. They come from Moonshots—fast-moving tokens with breakout potential. The Moonshots API surfaces these candidates programmatically so you can rank, alert, and act inside your product. In this guide, you’ll call /v2/moonshots, display a high-signal list with TM Grade and Bullish tags, and wire it into bots, dashboards, or screeners in minutes. Start by grabbing your key at Get API Key, then Run Hello-TM and Clone a Template to ship fast.

What You’ll Build in 2 Minutes

  • A minimal script that fetches Moonshots via /v2/moonshots (optionally filter by grade/signal/limit).
  • A UI pattern to render symbol, TM Grade, signal, reason/tags, and timestamp—plus a link to token details.
  • Optional one-liner curl to smoke-test your key.
  • Endpoints to add next: /v2/tm-grade (one-score ranking), /v2/trading-signals, /v2/hourly-trading-signals (timing), /v2/resistance-support (stops/targets), /v2/quantmetrics (risk sizing), /v2/price-prediction (scenario ranges).

Why This Matters

Discovery that converts. Users want more than price tickers—they want a curated, explainable list of high-potential tokens. The Moonshots API encapsulates multiple signals into a short list designed for exploration, alerts, and watchlists you can monetize.

Built for builders. The endpoint returns a consistent schema with grade, signal, and context so you can immediately sort, badge, and trigger workflows. With predictable latency and clear filters, you can scale to dashboards, mobile apps, and headless bots without reinventing the discovery pipeline.

Where to Find The Moonshots API

The cURL request for the Moonshots endpoint is displayed in the top right of the API Reference. Grab it and start tapping into the potential!

  1. Get API Key — generate a key and start free.
  2. Run Hello-TM — verify your first successful call.
  3. Clone a Template — deploy a screener or alerts bot today.
  4. Compare plans: Scale confidently with API plans.

How It Works (Under the Hood)

The Moonshots endpoint aggregates a set of evidence—often combining TM Grade, signal state, and momentum/volume context—into a shortlist of breakout candidates. Each row includes a symbol, grade, signal, and timestamp, plus optional reason tags for transparency.

For UX, a common pattern is: headline list → token detail where you render TM Grade (quality), Trading Signals (timing), Support/Resistance (risk placement), Quantmetrics (risk-adjusted performance), and Price Prediction scenarios. This enables users to understand why a token was flagged and how to act with risk controls.

Polling vs webhooks. Dashboards typically poll with short-TTL caching. Alerting flows use scheduled jobs or webhooks to smooth traffic and avoid duplicates. Always make notifications idempotent.

Production Checklist

  • Respect plan caps; batch and throttle in clients/workers.
  • Use exponential backoff with jitter on 429/5xx; capture request IDs.
  • De-duplicate alerts and downstream actions.
  • Use memory/Redis with short TTLs; pre-warm during peak hours.
  • Fetch in pages if supported; parallelize within limits.
  • Sort primarily by tm_grade or composite; surface reason tags to build trust.
  • Track p95/p99, error rates, and alert delivery success; log variants.
  • Store keys securely; rotate regularly.

Use Cases & Patterns

  • Bot Builder (Headless): Filter for tokens appearing in Moonshots with tm_grade ≥ X. Confirm entry with /v2/trading-signals; place stops/targets with /v2/resistance-support; size via Quantmetrics.
  • Dashboard Builder (Product): Moonshots tab with badges (Bullish, Grade 80+, Momentum). Token detail page with TM Grade, Signals, S/R, and Predictions for a complete decision loop.
  • Screener Maker (Lightweight Tools): Top-N list with Follow/alert toggles; export CSV. Include “New this week” and “Graduated” sections for churn/entry dynamics.
  • Community/Content: Weekly digest highlighting new entrants, upgrades, and notable exits—link back to your product pages.

Next Steps

  1. Get API Key — generate a key and start free.
  2. Run Hello-TM — verify your first successful call.
  3. Clone a Template — deploy a screener or alerts bot today.
  4. Compare plans: Scale confidently with API plans.

Integrated and Powered by Token Metrics

Supercharge your crypto products with Token Metrics's powerful research-grade signals and APIs, designed for developers, analysts, and traders to discover and act on breakout opportunities before the crowd.

FAQs

1) What does the Moonshots API return?

A list of breakout candidates with fields such as symbol, tm_grade, signal (often Bullish/Bearish), optional reason tags, and updated_at. Use it to drive discover tabs, alerts, and watchlists.

2) How fresh is the list? What about latency/SLOs?

The endpoint targets predictable latency and timely updates for dashboards and alerts. Use short-TTL caching and queued jobs/webhooks to avoid bursty polling.

3) How do I use Moonshots in a trading workflow?

Common stack: Moonshots for discovery, Trading Signals for timing, Support/Resistance for SL/TP, Quantmetrics for sizing, and Price Prediction for scenario context. Always backtest and paper-trade first.

4) I saw results like “+241%” and a “7.5% average return.” Are these guaranteed?

No. Any historical results are illustrative and not guarantees of future performance. Markets are risky; use risk management and testing.

5) Can I filter the Moonshots list?

Yes—pass parameters like min_grade, signal, and limit (as supported) to tailor to your audience and keep pages fast.

6) Do you provide SDKs or examples?

REST works with JavaScript and Python snippets above. Docs include quickstarts, Postman collections, and templates—start with Run Hello-TM.

7) Pricing, limits, and enterprise SLAs?

Begin free and scale up. See API plans for rate limits and enterprise options.

Choose from Platinum, Gold, and Silver packages
Reach with 25–30% open rates and 0.5–1% CTR
Craft your own custom ad—from banners to tailored copy
Perfect for Crypto Exchanges, SaaS Tools, DeFi, and AI Products