Crypto Fear & Greed Index API
Free Crypto Fear and Greed Index API with no key: a daily 0-100 sentiment score with its classification and history back to 2018. Tested curl example and live response.
Endpoint tested and returned HTTP 200 on 2026-08-21
What is the Crypto Fear & Greed Index API?
The Crypto Fear and Greed Index is published as a free JSON API with no key. It returns a daily score from 0 to 100 with a text classification from Extreme Fear to Extreme Greed, plus the full historical series.
The index compresses several market inputs — volatility, momentum, volume, social signals and dominance — into one number per day, which is why it turns up in so many dashboards. It is a sentiment indicator, not a price and not a forecast: it describes what the market has been doing rather than what it will do. Present it as context, clearly labelled, and never as a signal.
Three response details matter. `value` is a **string** despite being numeric, `timestamp` is Unix **seconds** and also quoted as a string, and the index updates once per day at 00:00 UTC. `time_until_update` counts down to the next refresh in seconds and appears only on the most recent entry — historical entries omit it entirely, which makes its presence a reliable way to identify the current reading.
Quick facts
- Base URL
https://api.alternative.me/fng- Authentication
- No key or registration. Attribution to alternative.me is requested when you display the index.
- Rate limit
- No published limit. The index changes once a day, so caching costs nothing.
- Pricing
- Free.
- CORS
- Enabled — callable directly from browser JavaScript
- Official docs
- Read the docs
How to use the Crypto Fear & Greed Index API
Every request below was executed against the live API on 2026-08-21, and the response shown is the real body it returned — not an illustration.
1. Current and previous Fear & Greed Index values
GET https://api.alternative.me/fng/?limit=2
curl 'https://api.alternative.me/fng/?limit=2'const res = await fetch("https://api.alternative.me/fng/?limit=2");
if (!res.ok) throw new Error(`Request failed: ${res.status}`);
const data = await res.json();
console.log(data);import requests
res = requests.get("https://api.alternative.me/fng/?limit=2", timeout=20)
res.raise_for_status()
print(res.json()){
"name": "Fear and Greed Index",
"data": [
{
"value": "72",
"value_classification": "Greed",
"timestamp": "1787270400",
"time_until_update": "58448"
},
{
"value": "62",
"value_classification": "Greed",
"timestamp": "1787184000"
}
],
"metadata": {
"error": null
}
}Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | query | Optional | How many days to return, newest first. `0` returns the entire history back to 2018. 2 |
format | query | Optional | `json` by default; `csv` returns a flat file instead. json |
date_format | query | Optional | `us`, `cn` or `kr` to receive formatted dates instead of Unix timestamps. us |
Response fields
namestring- `Fear and Greed Index`.
data[].valuestring- The score from 0 to 100, as a string. 0 is extreme fear, 100 extreme greed.
data[].value_classificationstring- Text band — Extreme Fear, Fear, Neutral, Greed or Extreme Greed.
data[].timestampstring- Unix seconds for the day the reading belongs to, quoted as a string.
data[].time_until_updatestring- Seconds until the next update. Present only on the newest entry, which makes it a reliable current-reading marker.
metadata.errorstring|null- Null on success; carries an error message otherwise.
What you can build with the Crypto Fear & Greed Index API
- Display a crypto sentiment gauge on a dashboard
- Chart sentiment against price over a historical period
- Log the daily reading into your own time series
- Identify the current reading by the presence of `time_until_update`
Common errors and how to fix them
`metadata.error` populated with HTTP 200
The request was malformed.
Fix: Check `metadata.error` rather than relying on the status code alone.
Arithmetic fails on value
`value` is a string.
Fix: Parse to an integer before comparing or charting.
Reading looks stale
The index updates once daily at 00:00 UTC.
Fix: Compare `timestamp` against the current UTC day. A reading unchanged within a day is expected, not broken.
Crypto Fear & Greed Index API — frequently asked questions
Is the Crypto Fear and Greed Index API free?
Yes. It requires no key or registration, and returns the full history back to 2018 when you pass `limit=0`. Attribution to alternative.me is requested when displaying it.
How is the index calculated?
It combines volatility, market momentum and volume, social media signals, and market dominance into a single 0 to 100 score. The methodology is published on the index's own page.
How often does it update?
Once per day at 00:00 UTC. The `time_until_update` field on the newest entry counts down in seconds to the next refresh.
Is the index a trading signal?
No. It is a descriptive sentiment measure summarising recent market behaviour, not a prediction. Treat it as context alongside other information and label it clearly wherever you display it.
Tools that pair with this API
JSON Formatter
Format, beautify and minify JSON online with 2-space, 4-space or tab indentation. Sort keys alphabetically and catch syntax errors instantly — free and private.
Percentage Change Calculator
Work out the percentage increase or decrease between an old and a new value. See the absolute change and whether it went up or down, instantly and privately.
Timestamp Converter
Convert timestamps to human-readable dates and dates back to timestamps. Auto-detects seconds vs milliseconds, shows local, UTC and ISO 8601 formats.
Crypto Fear & Greed Index is an independent third-party service and is not affiliated with ByteTools or ByteVancer. Details on this page were verified on 2026-08-21; always check the official documentation before relying on this API in production, as terms and limits can change.