API REST

On-chain y red

Lo que dice la cadena, con independencia del libro de órdenes: el estado de la red de Bitcoin, su valoración frente al uso y las ocho familias de Ethereum. Todas estas rutas son de todo el mercado: no aceptan ?symbol=.

#Cadencia y alcance

Estas familias no se actualizan al ritmo del mercado, y consultarlas cada minuto no sirve de nada.

  • La red de Bitcoin: el mempool y las comisiones cambian cada minuto, el estado de la red cada cinco minutos, la minería cada diez.
  • La valoración on-chain de Bitcoin: un punto al día. Las series se fechan con date, no con marca de tiempo.
  • Ethereum: unos minutos para la oferta, el gas y la DeFi; una hora para el staking. El historial es diario.

Cada ruta tiene su historial en /history, con un limit. Ninguna acepta símbolo: pasar ?symbol=BTCUSDT se rechaza en lugar de ignorarse, para evitar que una cifra de todo el mercado se atribuya a un solo activo.

#La red de Bitcoin

GET/v1/btc/networkdata_type · btc_network
CampoTipoDescripción
tip_heightintegerAltura del último bloque.
difficultyfloatDificultad actual.
progress_percentfloatAvance en el periodo de ajuste en curso.
difficulty_changefloatVariación proyectada en el próximo ajuste, en porcentaje.
block_timeobjectEl tiempo medio entre bloques y su diferencia respecto al objetivo de diez minutos.
GET/v1/btc/mempooldata_type · btc_mempool
CampoTipoDescripción
tx_countintegerTransacciones pendientes.
vsizeintegerPeso total pendiente.
total_feefloatComisiones acumuladas de las transacciones pendientes.
fee_histogramarrayEl reparto de las comisiones ofrecidas, por tramo.
trendobjectUna señal de llenado: filling, draining o stable.
GET/v1/btc/feesdata_type · btc_fees
CampoTipoDescripción
recommendedobjectComisiones recomendadas por nivel de prioridad, en satoshis por byte virtual, redondeadas al entero.
preciseobjectLas mismas, en valores fraccionarios: útil para un servicio que construye transacciones.
fee_pressurestringUna lectura cualitativa de la congestión.
GET/v1/btc/miningdata_type · btc_mining

Concentración de los pools, recompensas de bloque y ajustes de dificultad. El historial acepta un parámetro dataset para elegir entre concentración, recompensas, ajustes y tasas de comisión.

CampoTipoDescripción
concentrationobjecttop1_share y top3_share: la parte de los bloques minados por el primer pool y por los tres primeros.
latest_rewardobjectLa última recompensa de bloque observada.

#Valoración on-chain de Bitcoin

Cuatro métricas que ponen el precio frente al uso real de la cadena. Cada una expone una zone: una referencia de lectura, nunca una señal de ejecución.

GET/v1/onchain/mvrvdata_type · onchain_mvrv
curl -H "X-API-KEY: $BYTNODE_KEY" \
  "https://api.bytnode.com/v1/onchain/mvrv"

El MVRV compara la capitalización con el valor al que las monedas se movieron por última vez. Por encima de 3,5, la historia habla de euforia; por debajo de 1, el mercado cotiza por debajo de su coste medio de adquisición.

GET/v1/onchain/nvtdata_type · onchain_nvt

El NVT pone la capitalización frente al volumen de transacciones on-chain: un ratio precio/ingresos aplicado a una red. Se deriva bajo demanda y se sirve con nvt_signal, su versión suavizada a noventa días, con menos ruido.

GET/v1/onchain/active-addressesdata_type · onchain_active_addresses

El número de direcciones activas, con sus medias a siete y treinta días y el momentum que las compara. Es la medida más directa del uso.

GET/v1/onchain/miner-stressdata_type · onchain_miner_stress

La relación entre los ingresos de los mineros y la dificultad. Cuando se desploma, los mineros menos eficientes venden sus reservas, generando una presión vendedora que no aparece en el libro de órdenes.

#On-chain de Ethereum

Ocho familias, todas de todo el mercado, todas con historial diario.

GET/v1/eth/supplydata_type · eth_supply
CampoTipoDescripción
eth_supplyfloatOferta en circulación.
eth2_stakingfloatCantidad bloqueada en staking.
burnt_feesfloatTotal quemado desde el origen.
burn_24hfloatQuemado en las últimas 24 h.
net_issuance_24hfloatEmisión menos quema. Negativa, la oferta se contrae.
signalstringUna lectura cualitativa de la emisión neta.
GET/v1/eth/gasdata_type · eth_gas
GET/v1/eth/gas-momentumdata_type · eth_gas_momentum

El precio del gas, su congestión y después su momentum: el valor actual comparado con sus medias a siete y treinta días, con el régimen que se deriva. El gas es la medida más reactiva de la demanda de bloques en Ethereum.

GET/v1/eth/stakingdata_type · eth_staking
CampoTipoDescripción
staking_ratiofloatParte de la oferta bloqueada.
aprfloat | nullRendimiento del staking. Solo disponible en el valor actual: null en el historial.
yield_spreadfloat | nullDiferencia frente a un tipo de referencia. Misma observación.
GET/v1/eth/deflationdata_type · eth_deflation

La quema frente a la emisión, anualizadas, con la zona resultante. Es la lectura monetaria de Ethereum: con mucha actividad, la red destruye más de lo que emite.

GET/v1/eth/defidata_type · eth_defi
CampoTipoDescripción
tvl_usdfloatValor total bloqueado en la DeFi de Ethereum.
dex_volume_24h_usd / dex_volume_7d_usdfloatVolumen negociado en mercados descentralizados.
eth_market_cap_usdfloatCapitalización de ETH.
defi_health_ratiofloatLa relación entre la actividad DeFi y la capitalización.
trend_30dfloatLa tendencia a treinta días.
GET/v1/eth/squeezedata_type · eth_squeeze

Un índice compuesto que cruza la tasa de bloqueo con la contracción de la oferta: cuanto más sube, más escasa es la oferta disponible.

GET/v1/eth/ratiodata_type · eth_ratio

El ratio ETH/BTC, su capitalización relativa y su momentum a siete días: la medida de la rotación entre los dos activos de referencia.

Una dependencia que conviene conocer

Las familias supply, gas, staking, deflation y squeeze provienen de una sola fuente de origen. Si no está conectada en tu instalación, responden vacías con el motivo no_api_key en el snapshot. defi y ratio no dependen de ella y siguen disponibles.