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

Quantmetrics API: Measure Risk & Reward in One Call

Token Metrics Team
5

Most traders see price—quants see probabilities. The Quantmetrics API turns raw performance into risk-adjusted stats like Sharpe, Sortino, volatility, drawdown, and CAGR so you can compare tokens objectively and build smarter bots and dashboards. In minutes, you’ll query /v2/quantmetrics, render a clear performance snapshot, and ship a feature that customers trust. Start by grabbing your key at Get API Key, Run Hello-TM to verify your first call, then Clone a Template to go live fast.

What You’ll Build in 2 Minutes

  • A minimal script that fetches Quantmetrics for a token via /v2/quantmetrics (e.g., BTC, ETH, SOL).
  • A smoke-test curl you can paste into your terminal.
  • A UI pattern that displays Sharpe, Sortino, volatility, max drawdown, CAGR, and lookback window.

Next Endpoints to Add

  • /v2/tm-grade (one-score signal)
  • /v2/trading-signals
  • /v2/hourly-trading-signals (timing)
  • /v2/resistance-support (risk placement)
  • /v2/price-prediction (scenario planning)

Why This Matters

Risk-adjusted truth beats hype. Price alone hides tail risk and whipsaws. Quantmetrics compresses edge, risk, and consistency into metrics that travel across assets and timeframes—so you can rank universes, size positions, and communicate performance like a professional.

Built for dev speed

A clean REST schema, predictable latency, and easy auth mean you can plug Sharpe/Sortino into bots, dashboards, and screeners without maintaining your own analytics pipeline. Pair with caching and batching to serve fast pages at scale.

Where to Find

The Quant Metrics cURL request is located in the top right of the API Reference, allowing you to easily integrate it with your application.

Build Smarter Crypto Apps & AI Agents with Token Metrics

Token Metrics provides real-time prices, trading signals, and on-chain insights all from one powerful API. Grab a Free API Key

How It Works (Under the Hood)

Quantmetrics computes risk-adjusted performance over a chosen lookback (e.g., 30d, 90d, 1y). You’ll receive a JSON snapshot with core statistics:

  • Sharpe ratio: excess return per unit of total volatility.
  • Sortino ratio: penalizes downside volatility more than upside.
  • Volatility: standard deviation of returns over the window.
  • Max drawdown: worst peak-to-trough decline.
  • CAGR / performance snapshot: geometric growth rate and best/worst periods.

Call /v2/quantmetrics?symbol=<ASSET>&window=<LOOKBACK> to fetch the current snapshot. For dashboards spanning many tokens, batch symbols and apply short-TTL caching. If you generate alerts (e.g., “Sharpe crossed 1.5”), run a scheduled job and queue notifications to avoid bursty polling.

Production Checklist

  • Rate limits: Understand your tier caps; add client-side throttling and queues.
  • Retries & backoff: Exponential backoff with jitter; treat 429/5xx as transient.
  • Idempotency: Prevent duplicate downstream actions on retried jobs.
  • Caching: Memory/Redis/KV with short TTLs; pre-warm popular symbols and windows.
  • Batching: Fetch multiple symbols per cycle; parallelize carefully within limits.
  • Error catalog: Map 4xx/5xx to clear remediation; log request IDs for tracing.
  • Observability: Track p95/p99 latency and error rates; alert on drift.
  • Security: Store API keys in secrets managers; rotate regularly.

Use Cases & Patterns

  • Bot Builder (Headless): Gate entries by Sharpe ≥ threshold and drawdown ≤ limit, then trigger with /v2/trading-signals; size by inverse volatility.
  • Dashboard Builder (Product): Add a Quantmetrics panel to token pages; allow switching lookbacks (30d/90d/1y) and export CSV.
  • Screener Maker (Lightweight Tools): Top-N by Sortino with filters for volatility and sector; add alert toggles when thresholds cross.
  • Allocator/PM Tools: Blend CAGR, Sharpe, drawdown into a composite score to rank reallocations; show methodology for trust.
  • Research/Reporting: Weekly digest of tokens with Sharpe ↑, drawdown ↓, and volatility ↓.

Next Steps

  • Get API Key — start free and generate a key in seconds.
  • Run Hello-TM — verify your first successful call.
  • Clone a Template — deploy a screener or dashboard today.
  • Watch the demo: VIDEO_URL_HERE
  • Compare plans: Scale with API plans.

FAQs

1) What does the Quantmetrics API return?

A JSON snapshot of risk-adjusted metrics (e.g., Sharpe, Sortino, volatility, max drawdown, CAGR) for a symbol and lookback window—ideal for ranking, sizing, and dashboards.

2) How fresh are the stats? What about latency/SLOs?

Responses are engineered for predictable latency. For heavy UI usage, add short-TTL caching and batch requests; for alerts, use scheduled jobs or webhooks where available.

3) Can I use Quantmetrics to size positions in a live bot?

Yes—many quants size inversely to volatility or require Sharpe ≥ X to trade. Always backtest and paper-trade before going live; past results are illustrative, not guarantees.

4) Which lookback window should I choose?

Short windows (30–90d) adapt faster but are noisier; longer windows (6–12m) are steadier but slower to react. Offer users a toggle and cache each window.

5) Do you provide SDKs or examples?

REST is straightforward (JS/Python above). Docs include quickstarts, Postman collections, and templates—start with Run Hello-TM.

6) Polling vs webhooks for quant alerts?

Dashboards usually use cached polling. For threshold alerts (e.g., Sharpe crosses 1.0), run scheduled jobs and queue notifications to keep usage smooth and idempotent.

7) Pricing, limits, and enterprise SLAs?

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

Disclaimer

All information provided in this blog is for educational purposes only. It is not intended as financial advice. Users should perform their own research and consult with licensed professionals before making any investment or trading decisions.

Research

Crypto Trading Signals API: Put Bullish/Bearish Calls Right in Your App

Token Metrics Team
4

Timing makes or breaks every trade. The crypto trading signals API from Token Metrics lets you surface bullish and bearish calls directly in your product—no spreadsheet wrangling, no chart gymnastics. In this guide, you’ll hit the /v2/trading-signals endpoint, display actionable signals on a token (e.g., SOL, BTC, ETH), and ship a conversion-ready feature for bots, dashboards, or Discord. Start by creating a key on Get API Key, then Run Hello-TM and Clone a Template to go live fast.

What You’ll Build in 2 Minutes

  • A minimal script that fetches Trading Signals via /v2/trading-signals for one symbol (e.g., SOL).
  • A copy-paste curl to smoke-test your key.
  • A UI pattern to render signal, confidence/score, and timestamp in your dashboard or bot.

Endpoints to add next

  • /v2/hourly-trading-signals (intraday updates)
  • /v2/resistance-support (risk placement)
  • /v2/tm-grade (one-score view)
  • /v2/quantmetrics (risk/return context)

Why This Matters

Action over analysis paralysis. Traders don’t need more lines on a chart—they need an opinionated call they can automate. The trading signals API compresses technical momentum and regime reads into Bullish/Bearish events you can rank, alert on, and route into strategies.

Built for dev speed and reliability. A clean schema, predictable performance, and straightforward auth make it easy to wire signals into bots, dashboards, and community tools. Pair with short-TTL caching or webhooks to minimize polling and keep latency low.

Where to Find

You can find the cURL request for Crypto Trading Signals in the top right corner of the API Reference. Use it to access the latest signals!

Live Demo & Templates

  • Trading Bot Starter: Use Bullish/Bearish calls to trigger paper trades; add take-profit/stop rules with Support/Resistance.
  • Dashboard Signal Panel: Show the latest call, confidence, and last-updated time; add a history table for context.
  • Discord/Telegram Alerts: Post signal changes to a channel with a link back to your app.

How It Works (Under the Hood)

Trading Signals distill model evidence (e.g., momentum regimes and pattern detections) into Bullish or Bearish calls with metadata such as confidence/score and timestamp. You request /v2/trading-signals?symbol=<ASSET> and render the most recent event, or a small history, in your UI.

For intraday workflows, use /v2/hourly-trading-signals to update positions or alerts more frequently. Dashboards typically use short-TTL caching or batched fetches; headless bots lean on webhooks, queues, or short polling with backoff to avoid spiky API usage.

Production Checklist

  • Rate limits: Know your tier caps; add client-side throttling and queues.
  • Retries/backoff: Exponential backoff with jitter; treat 429/5xx as transient.
  • Idempotency: Guard downstream actions (don’t double-trade on retries).
  • Caching: Memory/Redis/KV with short TTLs for reads; pre-warm popular symbols.
  • Webhooks & jobs: Prefer webhooks or scheduled workers for signal change alerts.
  • Pagination/Bulk: Batch symbols; parallelize with care; respect limits.
  • Error catalog: Map common 4xx/5xx to clear fixes; log request IDs.
  • Observability: Track p95/p99 latency, error rate, and alert delivery success.
  • Security: Keep keys in a secrets manager; rotate regularly.

Use Cases & Patterns

  • Bot Builder (Headless): Route Bullish into candidate entries; confirm with /v2/resistance-support for risk and TM Grade for quality.
  • Dashboard Builder (Product): Add a “Signals” module per token; color-code state and show history for credibility.
  • Screener Maker (Lightweight Tools): Filter lists by Bullish state; sort by confidence/score; add alert toggles.
  • Community/Discord: Post signal changes with links to token pages; throttle to avoid noise.
  • Allocator/PM Tools: Track signal hit rates by sector/timeframe to inform position sizing (paper-trade first).

Next Steps

  1. Get API Key — create a key and start free.
  2. Run Hello-TM — confirm your first successful call.
  3. Clone a Template — deploy a bot, dashboard, or alerting tool today.

FAQs

1) What does the Trading Signals API return?

A JSON payload with the latest Bullish/Bearish call for a symbol, typically including a confidence/score and generated_at timestamp. You can render the latest call or a recent history for context.

2) Is it real-time? What about latency/SLOs?

Signals are designed for timely, programmatic use with predictable latency. For faster cycles, use /v2/hourly-trading-signals. Add caching and queues/webhooks to reduce round-trips.

3) Can I use the signals in a live trading bot?

Yes—many developers do. A common pattern is: Signals → candidate entry, Support/Resistance → stop/targets, Quantmetrics → risk sizing. Always backtest and paper-trade before going live.

4) How accurate are the signals?

Backtests are illustrative, not guarantees. Treat signals as one input in a broader framework with risk controls. Evaluate hit rates and drawdowns on your universe/timeframe.

5) Do you provide SDKs and examples?

You can integrate via REST using JavaScript and Python snippets above. The docs include quickstarts, Postman collections, and templates—start with Run Hello-TM.

6) Polling vs webhooks for alerts?

Dashboards often use cached polling. For bots/alerts, prefer webhooks or scheduled jobs and keep retries idempotent to avoid duplicate trades or messages.

7) Pricing, limits, and enterprise SLAs?

Begin free and scale as you grow. See API plans for allowances; enterprise SLAs and support are available.

Research

Fundamental Grade Crypto API: Real Crypto Fundamentals in One Score

Token Metrics Team
5 min read

Most traders chase price action; Fundamental Grade Crypto API helps you see the business behind the token—community traction, tokenomics design, exchange presence, VC signals, and DeFi health—consolidated into one score you can query in code. In a few minutes, you’ll fetch Fundamental Grade, render it in your product, and ship a due-diligence UX that drives trust. Start by grabbing your key at the Get API Key page, Run Hello-TM to verify your first call, then Clone a Template to go live fast.

What You’ll Build in 2 Minutes

A minimal script to fetch Fundamental Grade from /v2/fundamental-grade for any symbol (e.g., BTC).

  • Optional curl to smoke-test your key in seconds.
  • A drop-in pattern to display the grade + key drivers in dashboards, screeners, and research tools.

Endpoints to consider next

  • /v2/tm-grade (technical/sentiment/momentum)
  • /v2/price-prediction (scenario planning)
  • /v2/resistance-support (risk levels)
  • /v2/quantmetrics (risk/return stats)

Why This Matters

Beyond price, toward quality. Markets are noisy—hype rises and fades. Fundamental Grade consolidates hard-to-track signals (community growth, token distribution, liquidity venues, investor quality, DeFi integrations) into a clear, comparable score. You get a fast “is this worth time and capital?” answer for screening, allocation, and monitoring.

Build trust into your product. Whether you run an investor terminal, exchange research tab, or a portfolio tool, Token Metrics discovery helps users justify positions. Pair it with TM Grade or Quantmetrics for a balanced picture: what to buy (fundamentals) and when to act (signals/levels).

Where to Find

The Fundamental Grade is easily accessible in the top right of the API Reference. Grab the cURL request for seamless access!

Ready to build?

  • Get API Key — generate a key and start free.
  • Run Hello-TM — verify your first successful call.
  • Clone a Template — deploy a screener or token page today.

Watch the demo: VIDEO_URL_HERE. Compare plans: Scale confidently with API plans.

Build with Token Metrics: The Essential Data Layer for Crypto Apps

Integrate the Token Metrics API to empower your platform with institutional-grade crypto research, signals, and analytics—all in one endpoint suite.

FAQs

1) What does the Fundamental Grade API return?

A JSON payload with the overall score/grade plus component scores (e.g., community, tokenomics, exchange presence, VC backing, DeFi health) and timestamps. Use the overall grade for ranking and component scores for explanations.

2) How fast is the endpoint? Do you publish SLOs?

The API is engineered for predictable latency. For high-traffic dashboards, add short-TTL caching and batch requests; for alerts, use jobs/webhooks to minimize round-trips.

3) Can I combine Fundamental Grade with TM Grade or signals?

Yes. A common pattern is Fundamental Grade for quality filter + TM Grade for technical/sentiment context + Trading Signals for timing and Support/Resistance for risk placement.

4) How “accurate” is the grade?

It’s an opinionated synthesis of multiple inputs—not financial advice. Historical studies can inform usage, but past performance doesn’t guarantee future results. Always layer risk management and testing.

5) Do you offer SDKs and examples?

You can use REST directly (see JS/Python above). The docs include quickstarts, Postman, and ready-to-clone templates—start with Run Hello-TM.

6) Polling vs webhooks for fundamentals updates?

For UI pages, cached polling works well. For event-style notifications (upgrades/downgrades), prefer webhooks or scheduled jobs to avoid spiky traffic.

7) What about pricing, limits, and enterprise SLAs?

Begin free and scale as you grow. See API plans for allowances; enterprise SLAs and support are available—contact us.

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