API gratuita del índice de miedo y codicia

Inicio rápido

Pide la lectura de una moneda con sus dos últimos días. Omite coin para obtener todo el mercado.

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

Respuesta capturada el 24 de octubre de 2026, 19:00 UTC. Con los scripts activados, aquí aparece en su lugar la respuesta en tiempo real.

{
  "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

Parámetros

Todas las direcciones empiezan por https://cryptokeyhole.com. Los errores se devuelven en JSON, {"error": "…"}: 400 para un parámetro que no podemos leer, 404 para una moneda sin índice y 503 durante el minuto que tarda el índice en recalcularse (vuelve a intentarlo en breve).

Qué devuelve

/coins devuelve, para cada índice, value, exact, band, label, date, timestamp, asOf, status y delayed como arriba, con change1d (puntos desde ayer), componentCount y sus direcciones page, api, image y badge.

Ejemplos

Copia, pega y ejecuta. Cada ejemplo se completa con la moneda que elijas.

curl

Una semana de lecturas de Bitcoin y, después, solo el valor y la etiqueta de hoy con 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

Solo la biblioteca estándar. Indica el nombre de tu aplicación en la cabecera User-Agent.

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

En un navegador o en Node 18 y posteriores. Se permiten las solicitudes de origen cruzado, así que funciona desde cualquier página web.

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 lee el formato CSV directamente en las celdas. En el CSV, la columna 3 es el valor y la columna 6, su etiqueta; la fila 1 es la cabecera y la fila 2, la lectura más reciente. Pega cualquiera de estas fórmulas en una celda:

=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")

Para tener tu propia función, al estilo de IMPORTJSON, pega esto en Extensiones → Apps Script, guarda y escribe =FEARGREED("btc") en cualquier celda.

/**
 * 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]];
}

Bot de Discord

Un comando /feargreed que responde con la lectura y su imagen de medidor, para cualquier moneda o para todo el mercado. Dale el token de tu bot e invítalo con el ámbito applications.commands.

# 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")

Widget para sitios web

Una línea de texto para cualquier página, que muestra la lectura actual y enlaza a ella. Si prefieres una imagen, usa una inserción de imagen.

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

Imágenes en tiempo real para insertar

Cada índice tiene una tarjeta de medidor y una insignia compacta, en versión clara y oscura, en direcciones fijas. Cada imagen se redibuja en cuanto cambia su lectura e indica la hora de la lectura que muestra, de modo que una inserción se mantiene al día sin ningún código.

<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]

En el código HTML, la imagen se muestra a la mitad de su tamaño para que se vea nítida en pantallas de alta resolución. Enlázala a la página de la lectura, como arriba, para que los lectores puedan ver qué hay detrás de la cifra.

Qué mide el índice

El índice de miedo y codicia de CryptoKeyhole mide el estado de ánimo del mercado de 0 (miedo extremo) a 100 (codicia extrema). Lo calculamos nosotros mismos, para el mercado en su conjunto y para cada moneda, con datos de mercado, de derivados y on-chain que recopilamos, y con las visitas públicas de Wikimedia.

La lectura de cada moneda combina hasta nueve componentes: impulso del precio, volatilidad, tasas de financiación, interés abierto, flujo de takers, ratio long/short, beneficio de los holders, flujos de exchanges y atención. Cada uno se compara con el historial de los últimos dos años de la propia moneda, de modo que un día tranquilo para una moneda volátil se lee como tranquilo. La lectura del mercado pondera el índice de Bitcoin (45 %), el de Ether (20 %), la media de las demás monedas (15 %), la amplitud del mercado (10 %) y los flujos de stablecoins (10 %). No incluye redes sociales, tendencias de búsqueda ni datos de pago.

La sección Cómo se calcula detalla cada componente, peso y ventana; el campo components de la API muestra las puntuaciones de hoy.

Monedas

Usa cualquiera de estos códigos como valor de coin, en minúsculas o mayúsculas; cada uno enlaza a la página de miedo y codicia de su moneda. /api/v1/fear-and-greed/coins siempre tiene la lista actualizada.

• 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

Uso razonable

• Gratuita para uso personal y comercial: aplicaciones, bots, paneles, hojas de cálculo, investigación, sitios web y boletines.
• Se agradece que se cite la fuente con un enlace: “Índice de miedo y codicia de CryptoKeyhole”, con enlace a https://cryptokeyhole.com/fear-and-greed-index/ o a la página de la moneda.
• Te pedimos que muestres los valores tal cual y que no presentes el índice como propio.
• Sin clave y sin límites por nuestra parte. Las respuestas cambian como mucho cada hora, así que guarda una copia durante unos minutos en lugar de consultar en cada visita a la página.
• La mantenemos en funcionamiento e indicamos cuándo una lectura llega con retraso (el campo delayed), pero se ofrece tal cual, sin garantía.

¿Has creado algo con ella? Cuéntanoslo en X: @Crypto_Keyhole.