Altcoin BTC-Relative Performance — Alt Season Indicator

Altcoin BTC-Relative Performance ranks 488+ altcoin/BTC pairs by their 24-hour returns against Bitcoin using live Binance data. Computes change_vs_btc_pct for every pair, identifies top gainers/losers/volume leaders, and outputs a market breadth signal (strong_altseason to strong_btc_dominance) as a real-time alt season indicator. No API key required. $0.005/run flat.

When altcoins broadly outperform Bitcoin, capital is rotating from BTC into alts — historically the highest-return phase of a crypto bull cycle. This actor quantifies that rotation in real time with a single market_breadth_pct number and actionable signal labels.

---

Why use Altcoin BTC-Relative Performance?

1. Early alt season detection — market_breadth_pct ≥ 70% signals strong_altseason. Catching this before the crowd is what creates outsized altcoin returns — this actor gives you a quantitative trigger.
2. Rotation opportunity screening — Individual change_vs_btc_pct values show which sectors or L1s are leading rotation. SOL, AVAX, and MATIC each have their own moments — this data reveals them.
3. Systematic allocation decisions — Use signal as a binary switch: altseason → increase altcoin allocation; btc_dominance → rotate back to BTC. Automate without emotional decision-making.
4. Volume-weighted watchlist filtering — minVolumeBtc excludes micro-caps with fake pump percentages. Focus only on liquid pairs where moves mean something.
5. Time-series alt season database — Schedule hourly runs and build a historical market_breadth_pct chart. The trend of the breadth signal is more valuable than any single snapshot.

---

How to use

1. Open the actor on Apify Store and click Try for free.
2. Set topN (default 30) for how many gainers/losers/volume leaders to return.
3. Set minVolumeBtc (default 1.0 BTC) to exclude illiquid micro-caps.
4. Set includeStables: false to exclude stablecoin pairs from rankings.
5. Click Start — results arrive in under 30 seconds. First record is always the market_summary.

---

Input

Field	Type	Default	Description
topN	integer	30	Number of results per category (gainers/losers/volume leaders)
minVolumeBtc	number	1.0	Minimum 24h BTC volume to include a pair
includeStables	boolean	false	Include stablecoin/BTC pairs in rankings

---

Output

[
  {
    "_type": "market_summary",
    "btc_price_usd": 62450.30,
    "btc_change_24h_pct": 1.82,
    "market_breadth_pct": 68.4,
    "signal": "altseason",
    "total_pairs_analyzed": 488,
    "timestamp_utc": "2026-09-02T09:00:00Z"
  },
  {
    "_type": "altcoin",
    "rank_type": "top_gainer",
    "rank": 1,
    "symbol": "SOLUSDT",
    "base_asset": "SOL",
    "change_24h_pct": 8.45,
    "change_vs_btc_pct": 6.49,
    "volume_24h_btc": 12340.5,
    "volume_24h_usd": 770668335.0
  }
]

Market breadth signal bands

Signal	market_breadth_pct	Interpretation
strong_altseason	≥ 70%	Most alts beating BTC — peak rotation
altseason	55–70%	Alt-favorable conditions
mixed	45–55%	No clear trend
btc_dominance	30–45%	BTC outperforming most alts
strong_btc_dominance	< 30%	Strong BTC relative strength

Key output fields

Field	Description
market_breadth_pct	% of pairs where altcoin beat BTC in 24h
change_vs_btc_pct	Altcoin 24h % minus BTC 24h %
rank_type	top_gainer, top_loser, or volume_leader
volume_24h_btc	24h trading volume in BTC

---

Cost estimation

Flat $0.005 per run — all 488+ pairs analyzed regardless of topN.

Usage pattern	Runs/month	Monthly cost
Daily alt season check	30	$0.15
Hourly market breadth tracking	720	$3.60
Weekly research snapshot	4	$0.02

---

FAQ

How is change_vs_btc_pct calculated? change_vs_btc_pct = altcoin 24h% − BTC 24h%. Positive = outperformed BTC; negative = lagged. market_breadth_pct is the share of all filtered pairs with positive change_vs_btc_pct.

Why does alt season matter if I just hold BTC? Alt season signals capital rotation out of BTC into smaller caps — BTC dominance falling usually means BTC price goes sideways or slightly down while alts 2–10x. Monitoring the signal helps decide when to diversify into higher-beta positions.

Can I exclude specific coins? includeStables: false handles stablecoins/wrapped tokens. For custom exclusions, download all results and filter by symbol in your code.

---

Related actors

• Crypto Whale Flow Monitor — On-chain whale flows that often precede alt rotation
• Social Sentiment Aggregator — Reddit + Fear & Greed sentiment to confirm alt season thesis
• Long/Short OI Aggregator — Open interest positioning data to complement price-based alt season signals

Disclaimer: This actor is for informational and research purposes only and does not constitute financial advice.

Feedback

If this actor helps your crypto rotation strategy, a quick review helps others find it: Leave a review on Apify Store