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.
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:
- Age - token activity across multiple timeframes
- Liquidity - liquidity depth
- FDV - fully diluted valuation reasonableness
- Holder Supply - distribution of supply among top holders
- Volume - trading volume
- 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
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:
| Name | Endpoint | API Reference |
|---|---|---|
| Get Wallet History | /wallets/:address/history | Method Documentation |
| Get ERC20 Transfers by Wallet | /:address/erc20/transfers | Method Documentation |
| Get ERC20 Transfers by Contract | /erc20/:address/transfers | Method Documentation |
| Get ERC20 Price | /erc20/:address/price | Method Documentation |
| Get Multiple ERC20 Prices | /erc20/prices | Method Documentation |
| Get Wallet Token Balances | /:address/erc20 | Method Documentation |
| Get Wallet Token Balances with Prices | /wallets/{address}/tokens | Method Documentation |
| Get ERC20 Metadata by Contract | /erc20/metadata | Method Documentation |
| Get ERC20 Metadata by Symbol | /erc20/metadata/symbols | Method Documentation |
| Get Filtered Tokens | /discovery/tokens | Method Documentation |
| Token Search | /tokens/search | Method Documentation |
| Get Top Gainers | /discovery/tokens/top-gainers | Method Documentation |
| Get Top Losers | /discovery/tokens/top-losers | Method Documentation |
Supported Chains
The Token Score is available on all mainnet chains.