Free Fear & Greed Index API

Quick start

Ask for one coin's reading with its last two days. Leave out coin for the whole market.

curl "https://cryptokeyhole.com/api/v1/fear-and-greed?coin=btc&limit=2"

An answer captured on 24 October 2026, 19:00 UTC. With scripts on, the live answer replaces it here.

{
  "index": "Bitcoin Fear & Greed Index",
  "coin": "BTC",
  "name": "Bitcoin",
  "value": 67,
  "exact": 66.74211248285322,
  "band": "greed",
  "label": "Greed",
  "date": "2026-10-24",
  "timestamp": 1792868400,
  "asOf": "2026-10-24T19:00:00Z",
  "status": "open",
  "delayed": false,
  "components": [
    {
      "key": "momentum",
      "name": "Price momentum",
      "weight": 25,
      "score": 51.02880658436214
    },
    {
      "key": "volatility",
      "name": "Volatility",
      "weight": 15,
      "score": 97.25651577503429
    },
    {
      "key": "funding",
      "name": "Funding rates",
      "weight": 15,
      "score": 81.20713305898491
    },
    {
      "key": "oi",
      "name": "Open interest",
      "weight": 10,
      "score": 86.41975308641975
    },
    {
      "key": "taker",
      "name": "Taker flow",
      "weight": 10,
      "score": 59.67078189300412
    },
    {
      "key": "lsr",
      "name": "Long/short ratio",
      "weight": 5,
      "score": 56.79012345679013
    },
    {
      "key": "profit",
      "name": "Holder profit",
      "weight": 10,
      "score": 63.648834019204386
    },
    {
      "key": "netflow",
      "name": "Exchange flows",
      "weight": 5,
      "score": 39.64334705075446
    },
    {
      "key": "attention",
      "name": "Attention",
      "weight": 5,
      "score": 28.395061728395063
    }
  ],
  "previous": {
    "yesterday": {
      "date": "2026-10-23",
      "value": 68,
      "band": "greed",
      "label": "Greed"
    },
    "lastWeek": {
      "date": "2026-10-17",
      "value": 60,
      "band": "greed",
      "label": "Greed"
    },
    "lastMonth": {
      "date": "2026-09-24",
      "value": 71,
      "band": "greed",
      "label": "Greed"
    },
    "lastYear": {
      "date": "2025-10-24",
      "value": 32,
      "band": "fear",
      "label": "Fear"
    }
  },
  "history": [
    {
      "date": "2026-10-24",
      "timestamp": 1792800000,
      "value": 67,
      "exact": 66.74211248285322,
      "band": "greed",
      "label": "Greed",
      "status": "open"
    },
    {
      "date": "2026-10-23",
      "timestamp": 1792713600,
      "value": 68,
      "exact": 67.57887517146776,
      "band": "greed",
      "label": "Greed",
      "status": "closed"
    }
  ],
  "links": {
    "page": "https://cryptokeyhole.com/fear-and-greed-index/btc/",
    "chart": "https://cryptokeyhole.com/charts/btc/?metric=ckh.KeyholeFearGreedIndex",
    "api": "https://cryptokeyhole.com/api/v1/fear-and-greed?coin=btc",
    "image": "https://cryptokeyhole.com/fear-and-greed-index/btc.png",
    "imageDark": "https://cryptokeyhole.com/fear-and-greed-index/btc-dark.png",
    "badge": "https://cryptokeyhole.com/fear-and-greed-index/btc-badge.png",
    "badgeDark": "https://cryptokeyhole.com/fear-and-greed-index/btc-badge-dark.png",
    "docs": "https://cryptokeyhole.com/fear-and-greed-index/api/"
  },
  "updatedAt": "2026-10-24T19:14:52Z",
  "source": "CryptoKeyhole",
  "credit": "Fear & Greed Index by CryptoKeyhole: https://cryptokeyhole.com/fear-and-greed-index/btc/",
  "docs": "https://cryptokeyhole.com/fear-and-greed-index/api/"
}

Endpoints

Parameters

All addresses start with https://cryptokeyhole.com. Errors come back as JSON, {"error": "…"}: 400 for a parameter we cannot read, 404 for a coin without an index, 503 for the minute the index takes to recalculate (ask again shortly).

What comes back

/coins gives each index's value, exact, band, label, date, timestamp, asOf, status and delayed as above, with change1d (points since yesterday), componentCount and its page, api, image and badge addresses.

Examples

Copy, paste and run. Every example is filled in for the coin you choose.

curl

A week of Bitcoin readings, then today's value and label alone with jq.

curl "https://cryptokeyhole.com/api/v1/fear-and-greed?coin=btc&limit=7"

# today's value and label only (jq)
curl -s "https://cryptokeyhole.com/api/v1/fear-and-greed?coin=btc&limit=1" | jq -r '"\(.value) \(.label)"'

Python

Standard library only. Name your app in the User-Agent header.

import json
import urllib.request

URL = "https://cryptokeyhole.com/api/v1/fear-and-greed?coin=btc&limit=30"
# Name your app: some library defaults, urllib's among them, are turned away.
request = urllib.request.Request(URL, headers={"User-Agent": "my-app/1.0"})
with urllib.request.urlopen(request, timeout=30) as response:
    data = json.load(response)

print(f"{data['index']}: {data['value']}/100, {data['label']} (as of {data['asOf']})")
for day in data["history"][:7]:
    print(day["date"], day["value"], day["label"])

JavaScript

In a browser or Node 18 and later. Cross-origin requests are allowed, so this works from any web page.

const response = await fetch("https://cryptokeyhole.com/api/v1/fear-and-greed?coin=btc&limit=7");
const data = await response.json();

console.log(`${data.index}: ${data.value}/100, ${data.label}`);
for (const day of data.history) console.log(day.date, day.value, day.label);

Google Sheets

IMPORTDATA reads the CSV format straight into cells. In the CSV, column 3 is the value and column 6 its label; row 1 is the header and row 2 the latest reading. Paste any of these into a cell:

=INDEX(IMPORTDATA("https://cryptokeyhole.com/api/v1/fear-and-greed?coin=btc&limit=1&format=csv"), 2, 3)

=INDEX(IMPORTDATA("https://cryptokeyhole.com/api/v1/fear-and-greed?coin=btc&limit=1&format=csv"), 2, 6)

=IMPORTDATA("https://cryptokeyhole.com/api/v1/fear-and-greed?coin=btc&limit=30&format=csv")

=IMPORTDATA("https://cryptokeyhole.com/api/v1/fear-and-greed/coins?format=csv")

For a function of your own, the IMPORTJSON way, paste this into Extensions → Apps Script, save, then type =FEARGREED("btc") in any cell.

/**
 * The Fear & Greed Index from CryptoKeyhole: =FEARGREED("btc"), or =FEARGREED() for the whole market.
 * Returns the value, its label and the time it is as of, in one row.
 * @customfunction
 */
function FEARGREED(coin) {
  const url = "https://cryptokeyhole.com/api/v1/fear-and-greed?limit=1&coin=" + encodeURIComponent(coin || "");
  const data = JSON.parse(UrlFetchApp.fetch(url).getContentText());
  return [[data.value, data.label, data.asOf]];
}

Discord bot

A /feargreed command that answers with the reading and its gauge image, for any coin or the whole market. Give it your bot's token and invite it with the applications.commands scope.

# A /feargreed slash command (discord.py 2 and aiohttp): pip install discord.py aiohttp
import aiohttp
import discord
from discord import app_commands

API = "https://cryptokeyhole.com/api/v1/fear-and-greed"
client = discord.Client(intents=discord.Intents.default())
tree = app_commands.CommandTree(client)

@tree.command(name="feargreed", description="Crypto Fear & Greed Index from CryptoKeyhole")
@app_commands.describe(coin="A coin such as btc or eth; leave it empty for the whole market")
async def feargreed(interaction: discord.Interaction, coin: str = ""):
    async with aiohttp.ClientSession(headers={"User-Agent": "my-discord-bot/1.0"}) as session:
        async with session.get(API, params={"coin": coin, "limit": "1"}) as response:
            data = await response.json()
    if "error" in data:
        await interaction.response.send_message(data["error"], ephemeral=True)
        return
    embed = discord.Embed(title=data["index"], url=data["links"]["page"],
                          description=f"**{data['value']}/100: {data['label']}**")
    # A new address for each reading, so Discord shows the current image rather than one it kept
    embed.set_image(url=f"{data['links']['image']}?t={data['timestamp']}")
    embed.set_footer(text="Fear & Greed Index by CryptoKeyhole · cryptokeyhole.com")
    await interaction.response.send_message(embed=embed)

@client.event
async def on_ready():
    await tree.sync()

client.run("YOUR_BOT_TOKEN")

Website widget

A line of text for any page that shows the current reading and links to it. For a picture instead, use an image embed.

<a id="ckh-fear-greed" href="https://cryptokeyhole.com/fear-and-greed-index/btc/" target="_blank" rel="noopener"
   style="display:inline-flex;gap:8px;align-items:baseline;font:15px/1.4 system-ui,sans-serif;color:inherit;text-decoration:none">
  Bitcoin Fear &amp; Greed Index: <strong>…</strong> <small style="opacity:.7">by CryptoKeyhole</small>
</a>
<script>
  fetch("https://cryptokeyhole.com/api/v1/fear-and-greed?coin=btc&limit=1")
    .then((response) => response.json())
    .then((data) => {
      document.querySelector("#ckh-fear-greed strong").textContent = data.value + "/100 · " + data.label;
    });
</script>

Live images and embeds

Every index has a gauge card and a compact badge, light and dark, at fixed addresses. Each image is redrawn as soon as its reading changes and prints the time of the reading it shows, so an embed stays current without any code.

<a href="https://cryptokeyhole.com/fear-and-greed-index/btc/"><img src="https://cryptokeyhole.com/fear-and-greed-index/btc.png" width="600" height="315" alt="Bitcoin Fear &amp; Greed Index by CryptoKeyhole" loading="lazy"></a>

[![Bitcoin Fear & Greed Index by CryptoKeyhole](https://cryptokeyhole.com/fear-and-greed-index/btc.png)](https://cryptokeyhole.com/fear-and-greed-index/btc/)

[url=https://cryptokeyhole.com/fear-and-greed-index/btc/][img]https://cryptokeyhole.com/fear-and-greed-index/btc.png[/img][/url]

The image is shown at half its size in the HTML code, so it stays sharp on high-resolution screens. Link it to the reading's page, as above, so readers can see what is behind the number.

What the index measures

The CryptoKeyhole Fear & Greed Index reads the mood of the market from 0 (extreme fear) to 100 (extreme greed). We calculate it ourselves, for the market as a whole and for each coin, from market, derivatives and on-chain data we collect, and from Wikimedia's public page views.

Each coin's reading combines up to nine components: price momentum, volatility, funding rates, open interest, taker flow, the long/short ratio, holder profit, exchange flows and attention. Each is ranked against the coin's own past two years, so a calm day for a volatile coin reads as calm. The market's reading weighs Bitcoin's index (45%), Ether's (20%), the other coins' average (15%), market breadth (10%) and stablecoin flows (10%). No social media, search trends or paid data go into it.

How it is calculated gives every component, weight and window; the API's components show today's scores.

Coins

Use any of these codes as coin, in lower or upper case; each links to the coin's own Fear & Greed page. /api/v1/fear-and-greed/coins always has the current list.

• btcBitcoin
• ethEthereum
• solSolana
• xrpXRP
• trxTRON
• bnbBNB
• dogeDogecoin
• tonToncoin
• linkChainlink
• hypeHyperliquid
• adaCardano
• nearNear
• xlmStellar
• bchBitcoin Cash
• ltcLitecoin
• uniUniswap
• avaxAvalanche
• suiSui
• hbarHedera Hashgraph
• wldWorldcoin
• mntMantle
• shibShiba Inu
• qntQuant
• enaEthena
• morphoMorpho
• aaveAave
• ondoOndo
• dotPolkadot
• zroLayerZero
• pepePepe
• skySKY Governance Token
• arbArbitrum
• polPOL (ex-MATIC)
• aptAptos
• crvCurve DAO
• ethfiether.fi
• pendlePendle
• ensEthereum Name Service
• fetFetch.ai
• ldoLido DAO
• eigenEigenCloud
• spxSPX6900
• imxImmutable
• axsAxie Infinity
• batBasic Attention Token
• grtThe Graph
• syrupMaple Finance
• flokiFloki
• compCompound
• sandThe Sandbox
• apeApeCoin
• promProm
• altAltLayer
• galaGala
• nilNillion
• eraCaldera

Fair use

• Free for personal and commercial use: apps, bots, dashboards, spreadsheets, research, websites and newsletters.
• Credit with a link is appreciated: "Fear & Greed Index by CryptoKeyhole", linked to https://cryptokeyhole.com/fear-and-greed-index/ or the coin's own page.
• Please show the values as they are, and don't present the index as your own.
• No key and no limits of ours. Answers change at most every hour, so keep a copy for a few minutes rather than asking on every page view.
• We keep it running and say when a reading is late (the delayed field), but it comes as it is, without a guarantee.

Built something with it? Tell us on X, @Crypto_Keyhole.