BYTETOOLS

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.

No API key requiredCORS enabledHTTPSFree tier

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
curl 'https://api.alternative.me/fng/?limit=2'
JavaScript (fetch)
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);
Python (requests)
import requests

res = requests.get("https://api.alternative.me/fng/?limit=2", timeout=20)
res.raise_for_status()
print(res.json())
Response — HTTP 200
{
  "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

ParameterTypeRequiredDescription
limitqueryOptionalHow many days to return, newest first. `0` returns the entire history back to 2018. 2
formatqueryOptional`json` by default; `csv` returns a flat file instead. json
date_formatqueryOptional`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

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.