# Crypto Fear and Greed Index Scraper (`maximedupre/crypto-fear-and-greed-index-scraper`) Actor

Fetch current and historical crypto fear and greed index records from Alternative.me. Get daily 0-100 values, classifications, timestamps, source fields, and optional raw records.

- **URL**: https://apify.com/maximedupre/crypto-fear-and-greed-index-scraper.md
- **Developed by:** [Maxime Dupré](https://apify.com/maximedupre) (community)
- **Categories:** Marketing, Automation, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.45 / 1,000 index records

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use 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

### 📊 Crypto fear and greed index scraper for daily sentiment data

Crypto Fear and Greed Index Scraper fetches current and historical Alternative.me Crypto Fear & Greed Index records for analysts, builders, traders, and dashboard teams. It returns normalized daily index rows with the 0-100 value, classification, timestamps, source evidence, and optional raw source data so you can track crypto market sentiment without building your own API glue.

- Monitor the [latest fear and greed index crypto](https://apify.com/maximedupre/crypto-fear-and-greed-index-scraper/examples/latest-fear-and-greed-index-crypto) reading for daily market sentiment checks.
- Build a [fear and greed index chart](https://apify.com/maximedupre/crypto-fear-and-greed-index-scraper/examples/fear-and-greed-index-chart) from historical structured rows.
- Schedule [fear and greed index today](https://apify.com/maximedupre/crypto-fear-and-greed-index-scraper/examples/fear-and-greed-index-today) snapshots for alerts, reports, or newsletters.
- Export [fear and greed index historical data](https://apify.com/maximedupre/crypto-fear-and-greed-index-scraper/examples/fear-and-greed-index-historical-data) for backtests and BI dashboards.
- Keep an auditable [Alternative.me index trail](https://apify.com/maximedupre/crypto-fear-and-greed-index-scraper/examples/alternative-me-index-trail) with source URL, fetch time, and optional raw records.

#### 📦 Returned data

Each dataset row represents one successful daily Crypto Fear & Greed Index record. The actor preserves the official source value and classification, then adds normalized time and audit fields that are easier to use in spreadsheets, databases, and code.

Returned fields include the normalized date, ISO timestamp, Unix timestamp, 0-100 value, human-readable classification, machine-friendly classification slug, source name, source URL, index name, and latest-record marker. When the source provides update timing, the row can include seconds until the next update and an estimated next update timestamp. If that information is unavailable, those fields are returned as `null` instead of being invented.

You can also enable raw output when you need to inspect or store the original source record beside the normalized fields.

#### ▶️ How to run

Open the actor, choose the history range, and click **Start**. Use **Latest value** for the newest daily reading, **Newest N records** for a rolling window, or **Full history** when you need the available source archive.

For recurring workflows, schedule the actor to run daily after the source updates. The Crypto Fear & Greed Index is a daily index, so repeated runs within the same day can return the same latest value.

#### ⚙️ Input

| Field | What it does |
| --- | --- |
| `historyMode` | Select latest value, newest N records, or full history. |
| `limit` | Number of newest records to fetch when using newest N records mode. |
| `dateFormat` | Requests a source date format for workflow compatibility: world/default, US, China, or Korea. Output still includes normalized dates. |
| `includeRawRecord` | Adds the original source record to each row when enabled. |

No user account, login, cookies, or user API token is required for the public source workflow.

#### 🧾 Output example

```json
{
  "id": "2026-07-02",
  "date": "2026-07-02",
  "sourceDate": "02-07-2026",
  "timestamp": "2026-07-02T00:00:00.000Z",
  "timestampUnix": 1782950400,
  "value": 64,
  "classification": "Greed",
  "classificationSlug": "greed",
  "timeUntilUpdateSeconds": 43200,
  "nextUpdateAt": "2026-07-03T00:00:00.000Z",
  "source": "Alternative.me",
  "sourceUrl": "https://alternative.me/crypto/fear-and-greed-index/",
  "indexName": "Crypto Fear & Greed Index",
  "isLatest": true,
  "rawRecord": {
    "value": "64",
    "value_classification": "Greed",
    "timestamp": "1782950400",
    "time_until_update": "43200"
  }
}
````

#### 💳 Pricing

This actor uses pay-per-event pricing. You are charged only when the actor saves an accepted index record to the dataset. Empty runs and setup checks should not be described as charged unless the pricing handoff says otherwise.

#### 🔌 Integrations

https://www.youtube.com/watch?v=bNACk1\_S\_6w\&list=PLObrtcm1Kw6MUrlLNDbK9QRg8VDJg0gOW\&index=4

Use this actor with Apify integrations, API clients, webhooks, scheduled runs, and dataset exports. Send results to spreadsheets, BI tools, databases, or your own app after each run.

#### ❓ FAQ

**Is this a crypto price scraper?**\
No. It returns the published Crypto Fear & Greed Index time series, not coin prices, exchange order books, or trading signals.

**Does it provide financial advice or market predictions?**\
No. The actor only retrieves and normalizes index records. It does not generate recommendations, AI analysis, or investment advice.

**Can I get the fear and greed index today?**\
Yes. Select **Latest value** to fetch the newest daily record available from the source.

**Can I get fear and greed index historical data?**\
Yes. Use **Newest N records** for a fixed recent window or **Full history** for the available source archive. Historical availability is controlled by the source.

**Can I use it for a fear and greed index chart?**\
Yes. Export the dataset to JSON, CSV, Excel, or another Apify-supported format and chart the `date`, `value`, and `classification` fields in your BI or spreadsheet tool.

**Is this the CMC crypto fear and greed index?**\
No. This actor is focused on Alternative.me Crypto Fear & Greed Index records, as shown in the source fields.

**What happens when update countdown data is missing?**\
The update fields are returned as `null` when the source does not provide enough data. The actor does not invent countdowns.

**Should I enable raw records?**\
Enable `includeRawRecord` when you need audit evidence, compatibility checks, or to compare normalized fields with the upstream source payload. Leave it off for simpler tables.

### 📝 Changelog

- 0.0.1: Initial release.

### 🆘 Support

For issues, questions, or feature requests, [file a ticket](https://console.apify.com/actors/maximedupre~crypto-fear-and-greed-index-scraper/issues) and I'll fix or implement it in less than 24h 🫡

### 🔗 Other actors

- [Bitget Tickers Scraper ↗](https://apify.com/maximedupre/bitget-tickers-scraper) - Use it for related crypto workflows.
- [GMGN CopyTrade Wallet Scraper ↗](https://apify.com/maximedupre/gmgn-copytrade-wallet-scraper) - Use it for related crypto workflows.
- [GMGN Wallet Activity Scraper ↗](https://apify.com/maximedupre/gmgn-wallet-activity-scraper) - Use it for related crypto workflows.
- [Stocktwits Scraper ↗](https://apify.com/maximedupre/stocktwits-scraper) - Use it for related crypto workflows.
- [Telegram Channels Scraper ↗](https://apify.com/maximedupre/telegram-channels-scraper) - Use it for related crypto workflows.
  **Made with ❤️ by Maxime Dupré**

# Actor input Schema

## `historyMode` (type: `string`):

Select whether to fetch only the latest daily index value, a fixed number of newest daily records, or the full available archive.

## `limit` (type: `integer`):

Used only when History range is set to Newest N records. Use 0 only through Full history mode instead.

## `dateFormat` (type: `string`):

Choose the source date format to request for compatibility with your existing workflow. The output still includes normalized date fields.

## `includeRawRecord` (type: `boolean`):

Turn this on when you need the original source fields beside the normalized output for audit or compatibility checks.

## Actor input object example

```json
{
  "historyMode": "latest",
  "limit": 30,
  "dateFormat": "world",
  "includeRawRecord": false
}
```

# Actor output Schema

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

View normalized index records with value, classification, timestamps, source fields, and optional raw source data.

# 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("maximedupre/crypto-fear-and-greed-index-scraper").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("maximedupre/crypto-fear-and-greed-index-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).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 maximedupre/crypto-fear-and-greed-index-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=maximedupre/crypto-fear-and-greed-index-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Crypto Fear and Greed Index Scraper",
        "description": "Fetch current and historical crypto fear and greed index records from Alternative.me. Get daily 0-100 values, classifications, timestamps, source fields, and optional raw records.",
        "version": "0.1",
        "x-build-id": "slYyu7Fq9KOIqY5mp"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/maximedupre~crypto-fear-and-greed-index-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-maximedupre-crypto-fear-and-greed-index-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/maximedupre~crypto-fear-and-greed-index-scraper/runs": {
            "post": {
                "operationId": "runs-sync-maximedupre-crypto-fear-and-greed-index-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/maximedupre~crypto-fear-and-greed-index-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-maximedupre-crypto-fear-and-greed-index-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "historyMode": {
                        "title": "History range",
                        "enum": [
                            "latest",
                            "recent",
                            "fullHistory"
                        ],
                        "type": "string",
                        "description": "Select whether to fetch only the latest daily index value, a fixed number of newest daily records, or the full available archive.",
                        "default": "latest"
                    },
                    "limit": {
                        "title": "Number of newest records",
                        "minimum": 1,
                        "maximum": 10000,
                        "type": "integer",
                        "description": "Used only when History range is set to Newest N records. Use 0 only through Full history mode instead.",
                        "default": 30
                    },
                    "dateFormat": {
                        "title": "Source date format",
                        "enum": [
                            "world",
                            "us",
                            "cn",
                            "kr"
                        ],
                        "type": "string",
                        "description": "Choose the source date format to request for compatibility with your existing workflow. The output still includes normalized date fields.",
                        "default": "world"
                    },
                    "includeRawRecord": {
                        "title": "Include raw source record",
                        "type": "boolean",
                        "description": "Turn this on when you need the original source fields beside the normalized output for audit or compatibility checks.",
                        "default": false
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```