API REST

On-chain et réseau

Ce que dit la chaîne, indépendamment du carnet d’ordres : l’état du réseau Bitcoin, sa valorisation rapportée à l’usage, et les huit familles Ethereum. Toutes ces routes portent sur tout le marché : elles n’acceptent pas de ?symbol=.

#Cadence et portée

Ces familles ne se rafraîchissent pas au rythme du marché, et les interroger chaque minute ne sert à rien.

  • Le réseau Bitcoin : le mempool et les frais bougent chaque minute, l’état du réseau toutes les cinq minutes, le minage toutes les dix.
  • La valorisation on-chain de Bitcoin : un point par jour. Les séries sont datées par date, pas par horodatage.
  • Ethereum : quelques minutes pour l’offre, le gas et la DeFi ; une heure pour le staking. L’historique est quotidien.

Chaque route a son historique sous /history, avec une limit. Aucune n’accepte de symbole : passer ?symbol=BTCUSDT est refusé plutôt qu’ignoré, pour éviter qu’un chiffre de tout le marché soit attribué à un seul actif.

#Le réseau Bitcoin

GET/v1/btc/networkdata_type · btc_network
ChampTypeDescription
tip_heightintegerHauteur du dernier bloc.
difficultyfloatDifficulté actuelle.
progress_percentfloatAvancement dans la période d’ajustement en cours.
difficulty_changefloatVariation projetée au prochain ajustement, en pourcentage.
block_timeobjectLe temps moyen entre blocs et son écart à la cible de dix minutes.
GET/v1/btc/mempooldata_type · btc_mempool
ChampTypeDescription
tx_countintegerTransactions en attente.
vsizeintegerPoids total en attente.
total_feefloatFrais cumulés des transactions en attente.
fee_histogramarrayLa répartition des frais proposés, par palier.
trendobjectUn signal de remplissage : filling, draining ou stable.
GET/v1/btc/feesdata_type · btc_fees
ChampTypeDescription
recommendedobjectFrais recommandés par niveau de priorité, en satoshis par octet virtuel, arrondis à l’entier.
preciseobjectLes mêmes, en valeurs fractionnaires : utile pour un service qui construit des transactions.
fee_pressurestringUne lecture qualitative de la congestion.
GET/v1/btc/miningdata_type · btc_mining

Concentration des pools, récompenses de bloc et ajustements de difficulté. L’historique accepte un paramètre dataset pour choisir entre concentration, récompenses, ajustements et taux de frais.

ChampTypeDescription
concentrationobjecttop1_share et top3_share : la part des blocs minés par le premier pool et par les trois premiers.
latest_rewardobjectLa dernière récompense de bloc observée.

#Valorisation on-chain de Bitcoin

Quatre métriques qui rapportent le prix à l’usage réel de la chaîne. Chacune expose une zone : un repère de lecture, jamais un signal d’exécution.

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

Le MVRV compare la capitalisation à la valeur à laquelle les pièces ont bougé pour la dernière fois. Au-dessus de 3,5, l’histoire parle d’euphorie ; en dessous de 1, le marché se traite sous son coût d’acquisition moyen.

GET/v1/onchain/nvtdata_type · onchain_nvt

Le NVT rapporte la capitalisation au volume des transactions on-chain : un ratio cours/chiffre d’affaires appliqué à un réseau. Il est dérivé à la demande, et servi avec nvt_signal, sa version lissée sur quatre-vingt-dix jours, moins bruitée.

GET/v1/onchain/active-addressesdata_type · onchain_active_addresses

Le nombre d’adresses actives, avec ses moyennes à sept et trente jours et le momentum qui les compare. C’est la mesure la plus directe de l’usage.

GET/v1/onchain/miner-stressdata_type · onchain_miner_stress

Le rapport entre les revenus des mineurs et la difficulté. Quand il s’effondre, les mineurs les moins efficaces vendent leurs réserves, créant une pression vendeuse qui n’apparaît pas dans le carnet d’ordres.

#On-chain Ethereum

Huit familles, toutes sur tout le marché, toutes avec un historique quotidien.

GET/v1/eth/supplydata_type · eth_supply
ChampTypeDescription
eth_supplyfloatOffre en circulation.
eth2_stakingfloatQuantité immobilisée en staking.
burnt_feesfloatTotal brûlé depuis l’origine.
burn_24hfloatBrûlé sur les dernières 24 h.
net_issuance_24hfloatÉmission moins brûlage. Négative, l’offre se contracte.
signalstringUne lecture qualitative de l’émission nette.
GET/v1/eth/gasdata_type · eth_gas
GET/v1/eth/gas-momentumdata_type · eth_gas_momentum

Le prix du gas, sa congestion, puis son momentum : la valeur actuelle comparée à ses moyennes à sept et trente jours, avec le régime qui en découle. Le gas est la mesure la plus réactive de la demande de blocs sur Ethereum.

GET/v1/eth/stakingdata_type · eth_staking
ChampTypeDescription
staking_ratiofloatPart de l’offre immobilisée.
aprfloat | nullRendement du staking. Disponible sur la valeur courante uniquement : null dans l’historique.
yield_spreadfloat | nullÉcart à un taux de référence. Même remarque.
GET/v1/eth/deflationdata_type · eth_deflation

Le brûlage face à l’émission, annualisés, avec la zone qui en résulte. C’est la lecture monétaire d’Ethereum : à forte activité, le réseau détruit plus qu’il n’émet.

GET/v1/eth/defidata_type · eth_defi
ChampTypeDescription
tvl_usdfloatValeur totale immobilisée dans la DeFi Ethereum.
dex_volume_24h_usd / dex_volume_7d_usdfloatVolume échangé sur les places décentralisées.
eth_market_cap_usdfloatCapitalisation de l’ETH.
defi_health_ratiofloatLe rapport entre l’activité DeFi et la capitalisation.
trend_30dfloatLa tendance sur trente jours.
GET/v1/eth/squeezedata_type · eth_squeeze

Un indice composite qui croise le taux d’immobilisation et la contraction de l’offre : plus il monte, plus l’offre disponible se raréfie.

GET/v1/eth/ratiodata_type · eth_ratio

Le ratio ETH/BTC, sa capitalisation relative et son momentum sur sept jours : la mesure de la rotation entre les deux actifs de référence.

Une dépendance à connaître

Les familles supply, gas, staking, deflation et squeeze viennent d’une seule source amont. Si elle n’est pas branchée sur votre installation, elles répondent vide avec la raison no_api_key dans le snapshot. defi et ratio n’en dépendent pas et restent servies.