API REST

Macro, ETF y sentimiento

El contexto en el que se mueve el mercado cripto: tipos, dólar, liquidez, índices, oro y petróleo, además de los fundamentales de los ETF, la oferta de los activos y el índice de sentimiento. Todas estas rutas son de todo el mercado, salvo tokenomics, que recibe un símbolo.

#Series macro diarias

GET/v1/macrodata_type · macro
GET/v1/macro/seriesdata_type · macro_series
GET/v1/macro/historydata_type · macro_history

Unas veinte series oficiales de EE. UU., más el oro, repartidas en ocho categorías. La primera ruta devuelve el último valor de cada una; la segunda da el catálogo; la tercera el historial de una serie, indicada con ?series=.

CategoríaSeries
DivisasDólar amplio, dólar de mercados emergentes, EUR/USD, USD/JPY
TiposFed funds, 2 años, 10 años, 30 años, y las pendientes 10 años − 2 años y 10 años − 3 meses
InflaciónCPI, PCE, inflación implícita a 5 y 10 años
LiquidezM2, base monetaria, balance de la Fed, cuenta general del Tesoro, repos inversos a un día
VolatilidadVIX
Renta variableS&P 500, Nasdaq composite
EmpleoTasa de desempleo, nóminas no agrícolas
Materias primasOro, petróleo WTI
curl
# The catalogue of the series served
curl -H "X-API-KEY: $BYTNODE_KEY" "https://api.bytnode.com/v1/macro/series"

# The history of one series
curl -H "X-API-KEY: $BYTNODE_KEY" \
  "https://api.bytnode.com/v1/macro/history?series=DGS10&limit=90"
CampoTipoDescripción
series_idstringEl identificador que pasar en ?series=.
categorystringUna de las ocho categorías.
labelstringLa etiqueta legible de la serie.
unitsstringLa unidad del valor. Varía de una serie a otra: nunca sumes dos series sin leerla.
datestringLa fecha de la observación.
valuefloatEl valor observado.

#Indicadores derivados

Cuatro lecturas compuestas, calculadas bajo demanda a partir de las series brutas y del precio de Bitcoin.

GET/v1/macro/correlationsdata_type · macro_correlations

La correlación móvil de Bitcoin con el dólar, el S&P 500, el oro y el VIX, a treinta y noventa días, calculada sobre los rendimientos diarios en fechas comunes. Una correlación sigue siendo null mientras el historial alineado sea insuficiente.

GET/v1/macro/net-liquiditydata_type · macro_net_liquidity
GET/v1/macro/net-liquidity/historydata_type · macro_net_liquidity_history

La liquidez neta: el balance de la Fed, menos la cuenta general del Tesoro, menos los repos inversos a un día. La respuesta incluye la fórmula y sus componentes, y la unidad es explícita, ya que las tres series de origen no usan la misma.

GET/v1/macro/momentumdata_type · macro_momentum

Una puntuación de −100 a +100, construida sobre la dinámica de M2, del balance de la Fed y del dólar, a treinta y noventa días. Una masa monetaria al alza y un dólar a la baja empujan la puntuación hacia arriba.

GET/v1/macro/riskdata_type · macro_risk

Una puntuación de 0 a 100 sobre cinco señales: VIX bajo, dólar en retroceso, pendiente de la curva de tipos positiva, S&P por encima de su media de cincuenta días, oro en retroceso. Una señal sin datos se excluye del cálculo en lugar de contarse como desfavorable.

#Macro intradía

GET/v1/macro/intraday/seriesdata_type · macro_intraday_series
GET/v1/macro/intraday/historydata_type · macro_intraday_history

Diez instrumentos macro en velas OHLC, para comparar las cripto por horas en lugar de por días. Cinco se sirven en seis temporalidades: EUR/USD, USD/JPY, petróleo WTI, el índice del dólar y el oro tokenizado. Cinco solo se sirven a diario: los tipos a 10 y 30 años, el VIX, el S&P y el Nasdaq.

ParámetroTipoPor defectoDescripción
seriesstringobligatorioEl identificador del instrumento, tal como lo devuelve el catálogo.
timeframestringobligatorio1m, 5m, 15m, 1h, 4h, 1d. La temporalidad 30m no existe en esta familia.
limitinteger100Número de velas.
curl
curl -H "X-API-KEY: $BYTNODE_KEY" \
  "https://api.bytnode.com/v1/macro/intraday/history?series=EURUSD&timeframe=1h&limit=200"

Pedir una temporalidad que una serie no sirve devuelve 400 con la lista de las que sí sirve, en lugar de una lista vacía, que haría pensar en un hueco en los datos.

#Fundamentales de los ETF

GET/v1/etf/fundamentalsdata_type · etf_fundamentals
GET/v1/etf/fundamentals/historydata_type · etf_fundamentals_history

El ancla oficial presentada por los emisores: número de participaciones, valor liquidativo, bitcoins mantenidos y patrimonio neto, por emisor. Se siguen diez emisores de Bitcoin y nueve de Ethereum.

#Tokenomics y mercado global

GET/v1/tokenomicsdata_type · tokenomics
GET/v1/tokenomics/historydata_type · tokenomics_history

La oferta del activo y lo que se deriva de ella. Es la única familia de esta página que recibe un ?symbol=.

CampoTipoDescripción
circulating_supplyfloatOferta en circulación.
total_supplyfloatOferta total emitida.
max_supplyfloat | nullLímite máximo, cuando el activo lo tiene.
pricefloatEl precio de referencia usado para el cálculo.
market_capfloatCapitalización, derivada bajo demanda (oferta multiplicada por el precio), nunca tomada tal cual de una fuente externa.
fdvfloat | nullValoración totalmente diluida. Se calcula sobre la oferta total cuando no hay límite; null en una stablecoin.
GET/v1/globaldata_type · global_market
GET/v1/global/historydata_type · global_market_history
CampoTipoDescripción
total_market_cap_usdfloatCapitalización de todo el mercado.
total_volume_usdfloatVolumen negociado en 24 h.
btc_dominance / eth_dominancefloatProporción de los dos activos principales.
others_dominancefloat | nullEl resto, derivado: 100 menos los dos. null si falta uno de ellos.
active_cryptocurrenciesintegerNúmero de activos listados.

#Fear & Greed

GET/v1/fear-greeddata_type · fear_greed
GET/v1/fear-greed/historydata_type · fear_greed_history

El índice de miedo y codicia del mercado cripto: un valor de 0 a 100 y su clasificación, de Extreme Fear a Extreme Greed. Todo el mercado: no acepta símbolo.

Respuesta
{
  "status": "ok",
  "data_type": "fear_greed",
  "data": {
    "timestamp": "2026-08-29T00:00:00+00:00",
    "value": 61,
    "value_classification": "Greed"
  }
}

Un punto al día

El índice se publica una vez al día, alineado en la medianoche UTC. El historial se remonta a 2018, más de tres mil puntos. Consultarlo más de una vez al día consume cuota sin aprender nada.