Skip to main content

Don't have an API key yet?

Sign-up to Moralis to get your free API key and start building today.

Get Your Free API Key

Moralis Token Score

The Moralis Token Score is a unified 0–100 rating that evaluates the onchain quality of a token using six weighted metrics, supported across all EVM chains and Solana mainnet.


What is the Token Score?

The Token Score summarizes a token's onchain fundamentals into a single value between 0 and 100, where:

  • Higher scores indicate stronger onchain quality
  • Lower scores indicate weaker liquidity, activity, distribution, or unrealistic valuations

It is designed to be:

  • Simple to display
  • Easy to filter and sort
  • Transparent and easy to explain

How is the Token Score calculated?

Each of the six metrics produces a sub-score from 0 to 100, and the final score is a weighted average. The metrics are:

  1. Age - token activity across multiple timeframes
  2. Liquidity - liquidity depth
  3. FDV - fully diluted valuation reasonableness
  4. Holder Supply - distribution of supply among top holders
  5. Volume - trading volume
  6. Activity - transaction counts

Metrics Overview

1. Token Age & Maturity

  • Evaluates activity across timeframes (10m → 30d).
  • Tokens that sustain or grow activity over longer periods receive higher scores.

2. Liquidity Depth

  • Measures liquidity across all pools belonging to a token.
  • Higher liquidity generally indicates healthier and more resilient markets.

3. Fully Diluted Valuation (FDV)

  • Penalizes extreme or unrealistic valuations.
  • Reasonably valued tokens receive higher FDV scores.

4. Holder Distribution

  • Assesses how much of the supply is concentrated in the top holders.
  • More decentralization = higher score.

5. Trading Volume

  • Measures trading volume across all time windows.
  • High volume in any timeframe positively impacts the score.

6. Transaction Activity

  • Measures frequency of swaps and transfers.
  • High transaction counts indicate stronger adoption and usage.

Dynamic Scoring

The Token Score is dynamic, meaning it updates automatically as new onchain data becomes available. Because the model incorporates multiple rolling timeframes (10 minutes up to 1 month), a token’s score may change due to:

  • Increased or decreased transaction activity
  • Shifts in liquidity
  • Changes in trading volume
  • Supply distribution evolving
  • Market valuation moving significantly

Scores naturally decay over time if a token becomes inactive, as older datapoints fall out of the model.
This ensures the score always reflects current onchain conditions.


Early & New Tokens

Scores for very new tokens can sometimes be volatile or appear inconsistent in the earliest stages of trading.
This is expected, as the scoring model is still collecting activity patterns across its time horizons.

Key points about new-token scoring:

  • Early activity is often spiky and unstable
  • Short-term timeframes dominate the score until longer periods accumulate
  • As data builds up, the score stabilizes and becomes more representative
  • Tokens with genuine early adoption will quickly rise into their appropriate score range

The model adapts rapidly to real onchain traction — tokens with strong fundamentals will see their scores normalize within a short timeframe.


Score Updates

  • Scores are recalculated whenever a token has activity
  • As long as trading continues, the score stays up to date
  • If activity stops, older data decays out of the model and the score may decline

How can the Token Score be used?

The Token Score is an informational onchain quality signal suitable for:

Wallets & Explorers

  • Displaying token quality at a glance
  • Highlighting high-quality tokens
  • Warning users about low-scoring assets

DEXs & Trading Interfaces

  • Supporting safer trading experiences
  • Powering token discovery and ranking flows

Analytics & Discovery Tools

  • Filtering tokens by score (e.g., score ≥ 70)
  • Sorting tokens by onchain quality
  • Highlighting trending or improving tokens

Risk & Monitoring Systems

  • Triggering alerts for sharp score drops
  • Flagging potentially risky assets for review

Note: The Token Score is not investment advice. It is an onchain quality indicator.


Accessing Detailed Score Data

Developers can fetch the full scoring breakdown via:

GET /tokens/{address}/score

This endpoint returns:

  • Final score (0–100)
  • Sub-scores for all six metrics
  • Raw onchain metrics used in the calculation
  • Timestamp of last update

Example response:

{
"tokenAddress": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
"chainId": "0x1",
"score": 94,
"updatedAt": "2025-12-17T13:13:16.000Z",
"metrics": {
"usdPrice": 0.00000402842434389702,
"liquidityUsd": 17796503.766060613,
"volumeUsd": {
"10m": 450.2313257520407,
"30m": 1698.933789208249,
"1h": 12046.524987589466,
"4h": 258302.39298010131,
"12h": 364831.1304703939,
"1d": 775582.3422029199,
"7d": 6831957.3632850265,
"30d": 40129952.32714323
},
"transactions": {
"10m": 4,
"30m": 27,
"1h": 47,
"4h": 106,
"12h": 389,
"1d": 1393,
"7d": 9614,
"30d": 87370
},
"supply": {
"total": 420689899653542.56,
"top10Percent": 41.53
}
}
}

Note: This endpoint is available on Pro plans and above.


Supported Endpoints

Token Scores are returned as part of token metadata across the following endpoints:

NameNetworkEndpointAPI Reference
Get Wallet HistoryEVM/wallets/:address/historyMethod Documentation
Get ERC20 Transfers by WalletEVM/:address/erc20/transfersMethod Documentation
Get ERC20 Transfers by ContractEVM/erc20/:address/transfersMethod Documentation
Get ERC20 PriceEVM/erc20/:address/priceMethod Documentation
Get Multiple ERC20 PricesEVM/erc20/pricesMethod Documentation
Get Wallet Token BalancesEVM/:address/erc20Method Documentation
Get Wallet Token Balances with PricesEVM/wallets/{address}/tokensMethod Documentation
Get ERC20 Metadata by ContractEVM/erc20/metadataMethod Documentation
Get ERC20 Metadata by SymbolEVM/erc20/metadata/symbolsMethod Documentation
Get Token ScoreEVM & Solana/tokens/:address/scoreMethod Documentation
Get Filtered TokensEVM & Solana/discovery/tokensMethod Documentation
Token SearchEVM & Solana/tokens/searchMethod Documentation
Get Top GainersEVM & Solana/discovery/tokens/top-gainersMethod Documentation
Get Top LosersEVM & Solana/discovery/tokens/top-losersMethod Documentation
Get Wallet Token BalancesSolana/account/:network/:address/tokensMethod Documentation
Get Wallet PortfolioSolana/account/:network/:address/portfolioMethod Documentation
Get Token MetadataSolana/account/:network/:address/metadataMethod Documentation
Get Token PriceSolana/token/:network/:address/priceMethod Documentation
Get Multiple Token PricesSolana/token/:network/pricesMethod Documentation

Supported Chains

The Token Score is available on all mainnet chains, for both EVM and Solana tokens. This allows you to compare token quality across EVM chains and Solana using a unified metric, while still respecting chain-specific data structures under the hood.