# Crypto Narrative Tracker (`gochujang/crypto-narrative-tracker`) Actor

Track trending crypto narratives and sector performance using CoinGecko data. Identifies hot/warming/cooling/cold sectors with momentum signals.

- **URL**: https://apify.com/gochujang/crypto-narrative-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

from $2.00 / 1,000 narrative analyzeds

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?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Crypto Narrative Tracker — Sector Rotation & Momentum Analytics

Track **trending crypto narratives** and sector rotations in real time — no API key or proxy required. Monitor RWA, DePIN, AI tokens, GameFi, LSDfi, and 100+ categories with computed momentum scores, rotation signals, and opportunity ratings. Powered by CoinGecko's free public API.

### What does Crypto Narrative Tracker do?

Crypto Narrative Tracker fetches live category data from CoinGecko and aggregates it into actionable **crypto sector rotation analytics**. Each run returns a ranked list of narratives scored by momentum, trend direction, and capital rotation signals — helping you spot which sectors are heating up and which are cooling before the crowd notices.

Run it on a schedule via Apify to build a time-series database of narrative momentum — perfect for **DePIN sector analysis**, **RWA token performance tracking**, **AI crypto momentum monitoring**, and **GameFi cycle detection**.

### Why use this Actor?

- **No API key needed** — uses CoinGecko's free public endpoint
- **8 computed analytics fields** per narrative beyond raw price data
- **Momentum score 0-100** weighted across 1h, 24h, 7d, and 30d timeframes
- **Rotation signals** — `buy_rotation`, `sell_rotation`, `hold` per category
- **Sector grouping** — automatically maps 100+ CoinGecko categories to 8 sectors: `defi`, `ai_crypto`, `rwa`, `gaming`, `infrastructure`, `layer1`, `layer2`, `meme`
- **KVS summary** — top 5 winners and losers saved to `NARRATIVE_SUMMARY` key per run
- **Schedulable** — run every 4-6 hours and track momentum trends over time

### How to use Crypto Narrative Tracker

1. Open the Actor on [Apify Store](https://apify.com) and click **Try for free**
2. Set your preferred inputs (or use defaults):
   - `minMarketCapM`: filter out micro-cap narratives (default: $100M)
   - `topN`: how many narratives to return (default: 30)
   - `sortBy`: rank by `momentum_score`, `market_cap`, or `24h_change`
3. Click **Start** and wait ~15 seconds for results
4. Download the dataset in JSON, CSV, or Excel format from the Output tab
5. For recurring monitoring, click **Schedule** and set a cron interval

### Input

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `minMarketCapM` | integer | `100` | Minimum category market cap in millions USD. Filters out micro-narratives. |
| `topN` | integer | `30` | Top N narratives to return after filtering and sorting. |
| `sortBy` | string | `"momentum_score"` | Sort order: `momentum_score`, `market_cap`, or `24h_change`. |

### Output

Each dataset item represents one crypto narrative/sector with the following fields:

| Field | Type | Description |
|-------|------|-------------|
| `narrative_id` | string | CoinGecko category ID |
| `narrative_name` | string | Human-readable category name |
| `market_cap_usd` | float | Total market cap of all tokens in category |
| `market_cap_change_24h` | float | 24h market cap change % |
| `volume_24h` | float | 24h trading volume (USD) |
| `top_3_coins` | array | Top 3 coin IDs by market cap in this category |
| `price_change_1h` | float | 1h price change % |
| `price_change_24h` | float | 24h price change % |
| `price_change_7d` | float | 7d price change % |
| `price_change_30d` | float | 30d price change % |
| `momentum_score` | float | Weighted composite score 0-100 (1h×0.1 + 24h×0.4 + 7d×0.35 + 30d×0.15) |
| `momentum_label` | string | `surging / hot / rising / cooling / falling / crashing` |
| `narrative_tier` | string | `mega (>$10B) / large (>$1B) / mid (>$100M) / small` |
| `trend_direction` | string | `strong_bull / bull / mixed / bear` |
| `rotation_signal` | string | `buy_rotation / sell_rotation / hold` |
| `volatility_tier` | string | `extreme / high / moderate / low` |
| `sector_group` | string | `defi / ai_crypto / rwa / gaming / infrastructure / layer1 / layer2 / meme / other` |
| `opportunity_score` | string | `high / medium / low` composite rating |

#### Example output (2 records)

```json
[
  {
    "narrative_id": "artificial-intelligence",
    "narrative_name": "Artificial Intelligence",
    "market_cap_usd": 45800000000,
    "market_cap_change_24h": 5.2,
    "volume_24h": 3200000000,
    "top_3_coins": ["worldcoin", "fetch-ai", "render-token"],
    "price_change_24h": 5.2,
    "price_change_7d": 18.4,
    "momentum_score": 72.4,
    "momentum_label": "hot",
    "narrative_tier": "large",
    "trend_direction": "bull",
    "rotation_signal": "buy_rotation",
    "volatility_tier": "moderate",
    "sector_group": "ai_crypto",
    "opportunity_score": "high"
  },
  {
    "narrative_id": "real-world-assets",
    "narrative_name": "Real World Assets (RWA)",
    "market_cap_usd": 8200000000,
    "market_cap_change_24h": -1.1,
    "volume_24h": 420000000,
    "top_3_coins": ["ondo-finance", "chainlink", "polymesh-network"],
    "price_change_24h": -1.1,
    "price_change_7d": 3.2,
    "momentum_score": 49.8,
    "momentum_label": "rising",
    "narrative_tier": "large",
    "trend_direction": "mixed",
    "rotation_signal": "hold",
    "volatility_tier": "low",
    "sector_group": "rwa",
    "opportunity_score": "medium"
  }
]
```

#### KVS Summary record

A `NARRATIVE_SUMMARY` key is saved to the Key-Value Store after each run containing:

- `top_5_by_momentum` — the 5 hottest narratives by momentum score
- `top_5_losers` — the 5 coldest narratives
- `sector_distribution` — count of narratives per sector group

### Pricing

This Actor uses **Pay-Per-Event** billing — you only pay for what you get:

| Event | Price |
|-------|-------|
| Actor start (once per run) | $0.001 |
| Per narrative analyzed | $0.002 |

**Example costs:**

- Default run (30 narratives): **$0.061**
- Large run (100 narratives): **$0.201**

Compare to paying for premium data API subscriptions — this delivers sector rotation analytics at a fraction of the cost.

### Use Cases

- **Crypto sector rotation analytics** — track capital flows between DeFi, AI tokens, RWA, and GameFi
- **DePIN narrative tracking** — monitor infrastructure token momentum
- **AI crypto momentum signals** — catch AI token surges before they go mainstream
- **Portfolio rebalancing triggers** — use `rotation_signal` to time sector rotations
- **Market research** — understand which narratives drive each bull run cycle
- **Quantitative trading** — feed momentum scores into systematic allocation models

### Tips

- Schedule every 4-6 hours for intraday momentum tracking
- Set `sortBy: "24h_change"` to surface the fastest movers right now
- Filter `rotation_signal == "buy_rotation"` for sectors showing strong breakouts
- Combine `opportunity_score == "high"` with `narrative_tier == "large"` for highest-conviction setups
- Export to Google Sheets via Apify integrations for dashboard visualization

### FAQ

**Is an API key required?** No. The Actor uses CoinGecko's free public API endpoint with no authentication.

**Does it use proxies?** No. No proxy configuration is needed or used.

**How accurate are the momentum scores?** Scores reflect the CoinGecko category data at fetch time. Free tier data may lag 5-10 minutes. For higher frequency, consider upgrading to CoinGecko Pro and extending this Actor.

**Can I filter to specific sectors?** Not directly via input — filter the output dataset on `sector_group` after the run.

**Something broken?** Please open an issue in the Issues tab or contact us for custom solutions.

***

### Related actors

- [Crypto Sector Rotation](https://apify.com/gochujang/crypto-sector-rotation) — Capital flow data to validate narrative momentum signals tracked here
- [AI Token Sector Tracker](https://apify.com/gochujang/ai-token-sector-tracker) — Deep-dive on the AI narrative sector highlighted in broader narrative scans
- [Token Social Metrics](https://apify.com/gochujang/token-social-metrics) — Social volume and sentiment to confirm narrative momentum scores

### Feedback

If this actor powers your narrative trading research, a review helps others find it: [Leave a review on Apify Store](https://apify.com/gochujang/crypto-narrative-tracker#reviews)

***

**Keywords:** crypto narrative tracker, sector rotation crypto, DeFi narrative momentum, AI crypto sector, RWA narrative, meme coin sector, L1 L2 narrative, crypto market phase, fear greed narrative, CoinGecko category tracker, crypto sector signal, narrative trading, trending crypto sector

# Actor input Schema

## `minMarketCapM` (type: `integer`):

Only include categories with total market cap above this value (in millions USD). E.g. 100 = $100M minimum.

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

Return the top N narrative categories after filtering and sorting.

## `sortBy` (type: `string`):

How to rank and sort the returned narratives.

## Actor input object example

```json
{
  "minMarketCapM": 100,
  "topN": 30,
  "sortBy": "momentum_score"
}
```

# 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/crypto-narrative-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/crypto-narrative-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/crypto-narrative-tracker --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,gochujang/crypto-narrative-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/2X6LV9c9TTHzg2WlN/builds/vptl6gAeasXEVXaqV/openapi.json