API REST

On-chain et réseau

Ce que la chaîne dit, 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 sont marché entier — elles n’acceptent pas de ?symbol=.

#Cadence et portée

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

  • Réseau Bitcoin — le mempool et les frais bougent à la minute, l’état du réseau toutes les cinq minutes, le mining toutes les dix.
  • Valorisation on-chain Bitcoin — un point par jour. Les séries sont datées par date, pas par horodatage.
  • Ethereum — quelques minutes pour la supply, le gas et la DeFi ; une heure pour le staking. L’historique est quotidien.

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

#Réseau Bitcoin

GET/v1/btc/networkdata_type · btc_network
ChampTypeDescription
tip_heightintegerHauteur du dernier bloc.
difficultyfloatDifficulté courante.
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 offerts, par palier.
trendobjectUn signal de remplissage : filling, draining ou stable.
GET/v1/btc/feesdata_type · btc_fees
ChampTypeDescription
recommendedobjectFrais conseillé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 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 de marché à la valeur à laquelle les pièces ont bougé pour la dernière fois. Au-dessus de 3,5, l’historique parle d’euphorie ; en dessous de 1, le marché cote sous son coût d’acquisition moyen.

GET/v1/onchain/nvtdata_type · onchain_nvt

Le NVT rapporte la capitalisation au volume de transactions on-chain — un rapport 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 d’usage la plus directe.

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 — une pression vendeuse qui ne se voit pas dans le carnet.

#On-chain Ethereum

Huit familles, toutes marché entier, toutes avec un historique quotidien.

GET/v1/eth/supplydata_type · eth_supply
ChampTypeDescription
eth_supplyfloatSupply 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 burn. Négatif, la supply 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 courante comparée à ses moyennes à sept et trente jours, avec le régime qui en découle. Le gas est la mesure de demande de blocs la plus réactive d’Ethereum.

GET/v1/eth/stakingdata_type · eth_staking
ChampTypeDescription
staking_ratiofloatPart de la supply immobilisée.
aprfloat | nullRendement du staking. Disponible sur la valeur courante seulement : 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 burn face à l’émission, annualisé, 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 d’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 la supply : plus il monte, plus l’offre disponible se raréfie.

GET/v1/eth/ratiodata_type · eth_ratio

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

Une dépendance à connaître

Les familles supply, gas, staking, deflation et squeeze proviennent d’une même source amont. Si celle-ci 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.