# Altcoin Season Index — Top 50 vs BTC 90-Day Performance (`gochujang/altcoin-season-index-tracker`) Actor

Altcoin Season Index tracker: what % of top-50 altcoins outperformed BTC over 90 days. Per-coin performance, rank, and aggregate altcoin vs Bitcoin score (0-100). Track BTC dominance shifts and altcoin rotation. No API key required.

- **URL**: https://apify.com/gochujang/altcoin-season-index-tracker.md
- **Developed by:** [Hojun Lee](https://apify.com/gochujang) (community)
- **Categories:** Business
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$3.00 / 1,000 altcoin season index runs

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Altcoin Season Index — Top 50 vs BTC 90-Day Performance

**Altcoin Season Index** tracks what percentage of the top 50 cryptocurrencies have outperformed Bitcoin over the last 90 days — the definitive crypto market cycle indicator. Returns the altcoin season score (0–100), season label, per-coin BTC outperformance, top 5 outperformers, and bottom 5 underperformers. Data from CoinGecko public API. No API key required. **$0.003/run.**

If 75%+ of the top 50 beat BTC → Altcoin Season. If 25% or fewer beat BTC → Bitcoin Season. This metric (popularized by [blockchaincenter.net](https://www.blockchaincenter.net/en/altcoin-season-index/)) is one of the most-watched cycle indicators in crypto.

***

### Why use Altcoin Season Index?

1. **Cycle timing and capital rotation** — Rotate from BTC into alts when the altcoin season score crosses 75. Rotate back when it falls below 40. This single metric captures market regime more reliably than price action alone.
2. **Portfolio allocation automation** — Use the `season_label` field (`altcoin_season` / `bitcoin_season` / `neutral`) as a rule-based trigger for dynamic rebalancing between BTC and altcoin exposure.
3. **Weekly trend reporting** — Schedule daily runs to track how the altcoin season score moves over time. A rising score from 40 → 65 over two weeks is a significant momentum signal even before it hits the 75 threshold.
4. **Trading bot regime detection** — Feed `season_label` and `alt_season_probability` directly into automated strategies to adjust position sizing, leverage, and altcoin selection based on current market regime.
5. **Per-coin opportunity scanning** — The `top_5_outperformers` and per-coin `outperformance_pct` fields identify which sectors and assets are leading the cycle — essential for targeted altcoin selection during alt season.

***

### How to use

1. Open the actor on Apify Store and click **Try for free**.
2. Set `topN` to the number of top coins to analyze (default: 50, range: 10–250).
3. Toggle `excludeStablecoins` and `excludeBtcWbtc` (both default to `true`).
4. Click **Start** — completes in ~10 seconds.
5. Check the `SUMMARY` key-value store for `altcoin_season_score` and `season_label`.
6. Schedule daily runs to build a time-series of altcoin season transitions.

***

### Input

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `topN` | integer | `50` | Number of top coins to analyze (10–250) |
| `excludeStablecoins` | boolean | `true` | Remove USDT, USDC, DAI, and other stablecoins |
| `excludeBtcWbtc` | boolean | `true` | Exclude BTC and WBTC from the altcoin set |

***

### Output

**Per coin (dataset rows):**

```json
{
  "rank": 5,
  "symbol": "SOL",
  "name": "Solana",
  "change_90d_pct": 62.4,
  "btc_change_90d_pct": 18.2,
  "beat_btc": true,
  "outperformance_pct": 44.2,
  "market_cap_usd": 78500000000,
  "current_price_usd": 165.40
}
```

**SUMMARY (key-value store):**

```json
{
  "altcoin_season_score": 68,
  "season_label": "neutral",
  "btc_change_90d_pct": 18.2,
  "altcoins_beating_btc": 34,
  "altcoins_analyzed": 50,
  "top_5_outperformers": [
    {"symbol": "SUI", "outperformance_pct": 112.5},
    {"symbol": "TAO", "outperformance_pct": 89.3}
  ],
  "bottom_5_underperformers": [
    {"symbol": "XRP", "outperformance_pct": -24.1}
  ]
}
```

***

### Cost estimation

**Flat $0.003 per run** regardless of `topN`.

| Schedule | Monthly cost |
|----------|-------------|
| Daily | $0.09 |
| Twice daily | $0.18 |
| Every 6 hours | $0.36 |
| Hourly | $2.16 |

A full year of daily altcoin season tracking costs under $1.

***

### FAQ

**What is the "Altcoin Season" threshold?**
≥ 75% of the top 50 outperforming BTC = Altcoin Season. ≤ 25% = Bitcoin Season. 26–74% = Neutral. This definition matches the standard used by blockchaincenter.net.

**Is the 90-day window configurable?**
Not currently — the actor uses the standard 90-day window that defines the official Altcoin Season Index. A shorter window (e.g. 30 days) would give different, more volatile signals.

**Does it work with the top 100 or 200 coins?**
Yes — set `topN: 100` or `topN: 200`. Larger sets include more small-caps which can amplify the score in either direction. The standard index uses top 50.

**Can I get the full coin-by-coin breakdown?**
Yes — each coin is a separate dataset row with `beat_btc`, `outperformance_pct`, and market data. Filter by `beat_btc: true` for the full list of outperformers.

***

### Related actors

- [BTC Dominance Tracker](https://apify.com/gochujang/btc-dominance-tracker) — 15 dominance analytics including `alt_season_probability` to complement this index
- [Altcoin BTC-Relative Performance](https://apify.com/gochujang/altcoin-btc-performance) — Deeper per-pair alt season signal (488+ pairs vs BTC) for portfolio construction
- [CoinMarketCap Global Metrics](https://apify.com/gochujang/coinmarketcap-global-metrics) — Total market cap + Fear & Greed for macro context alongside the altcoin season score

### Feedback

If this actor helps your cycle analysis, a review helps others find it: [Leave a review on Apify Store](https://apify.com/gochujang/altcoin-season-index#reviews)

# Actor input Schema

## `topN` (type: `integer`):

Number of top coins to analyze (by market cap). Standard altcoin season uses 50.

## `excludeStablecoins` (type: `boolean`):

Remove USDT, USDC, DAI etc. from the comparison set.

## `excludeBtcWbtc` (type: `boolean`):

Exclude Bitcoin and Wrapped Bitcoin from the altcoin set.

## Actor input object example

```json
{
  "topN": 50,
  "excludeStablecoins": true,
  "excludeBtcWbtc": true
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("gochujang/altcoin-season-index-tracker").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("gochujang/altcoin-season-index-tracker").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call gochujang/altcoin-season-index-tracker --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,gochujang/altcoin-season-index-tracker"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/cvDHG5PVcXDxmAyxj/builds/pMhN5eGgsnXFQVRMS/openapi.json