API REST

Macro, ETF et sentiment

Le contexte dans lequel le marché crypto évolue : taux, dollar, liquidité, indices, or et pétrole, plus les fondamentaux ETF, la supply des actifs et l’indice de sentiment. Toutes ces routes sont marché entier, à l’exception de la tokenomics, qui prend un symbole.

#Séries macro quotidiennes

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

Une vingtaine de séries officielles américaines, plus l’or, réparties en huit catégories. La première route rend la dernière valeur de chacune ; la deuxième donne le catalogue ; la troisième l’historique d’une série, désignée par ?series=.

CatégorieSéries
ChangeDollar large, dollar émergents, EUR/USD, USD/JPY
TauxFed funds, 2 ans, 10 ans, 30 ans, et les pentes 10 ans − 2 ans et 10 ans − 3 mois
InflationCPI, PCE, points morts d’inflation à 5 et 10 ans
LiquiditéM2, base monétaire, bilan de la Fed, compte général du Trésor, prises en pension au jour le jour
VolatilitéVIX
ActionsS&P 500, Nasdaq composite
EmploiTaux de chômage, emplois non agricoles
Matières premièresOr, pétrole WTI
curl
# Le catalogue des series servies
curl -H "X-API-KEY: $BYTNODE_KEY" "https://api.bytnode.com/v1/macro/series"

# L historique d une serie
curl -H "X-API-KEY: $BYTNODE_KEY" \
  "https://api.bytnode.com/v1/macro/history?series=DGS10&limit=90"
ChampTypeDescription
series_idstringL’identifiant à passer en ?series=.
categorystringUne des huit catégories.
labelstringLe libellé lisible de la série.
unitsstringL’unité de la valeur. Elle diffère d’une série à l’autre : ne sommez jamais deux séries sans la lire.
datestringLa date de l’observation.
valuefloatLa valeur observée.

#Indicateurs dérivés

Quatre lectures composites, calculées à la demande à partir des séries brutes et du prix de Bitcoin.

GET/v1/macro/correlationsdata_type · macro_correlations

La corrélation glissante de Bitcoin avec le dollar, le S&P 500, l’or et le VIX, sur trente et quatre-vingt-dix jours, calculée sur les rendements quotidiens à dates communes. Une corrélation reste null tant que l’historique aligné est insuffisant.

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

La liquidité nette : le bilan de la Fed, moins le compte général du Trésor, moins les prises en pension au jour le jour. La réponse porte la formule et ses composants, et l’unité est explicite — les trois séries d’origine ne sont pas dans la même.

GET/v1/macro/momentumdata_type · macro_momentum

Un score de −100 à +100, construit sur la dynamique de M2, du bilan de la Fed et du dollar, à trente et quatre-vingt-dix jours. Masse monétaire en hausse et dollar en baisse tirent le score vers le haut.

GET/v1/macro/riskdata_type · macro_risk

Un score de 0 à 100 sur cinq signaux : VIX bas, dollar en repli, pente des taux positive, S&P au-dessus de sa moyenne à cinquante jours, or en repli. Un signal sans donnée est exclu du calcul plutôt que compté comme défavorable.

#Macro intraday

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

Dix instruments macro en bougies OHLC, pour comparer la crypto à l’heure plutôt qu’au jour. Cinq sont servis sur six pas de temps — EUR/USD, USD/JPY, pétrole WTI, indice dollar et l’or tokenisé. Cinq ne le sont qu’en journalier : taux 10 et 30 ans, VIX, S&P et Nasdaq.

ParamètreTypeDéfautDescription
seriesstringrequisL’identifiant de l’instrument, tel que le rend le catalogue.
timeframestringrequis1m, 5m, 15m, 1h, 4h, 1d. Le pas 30m n’existe pas dans cette famille.
limitinteger100Nombre de bougies.
curl
curl -H "X-API-KEY: $BYTNODE_KEY" \
  "https://api.bytnode.com/v1/macro/intraday/history?series=EURUSD&timeframe=1h&limit=200"

Demander un pas de temps qu’une série ne sert pas rend 400 avec la liste de ceux qu’elle sert — plutôt qu’une liste vide, qui ferait croire à un trou de données.

#Fondamentaux ETF

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

L’ancrage officiel déposé par les émetteurs : nombre de parts, valeur liquidative, bitcoins détenus et actifs nets, par émetteur. Dix émetteurs Bitcoin et neuf émetteurs Ethereum sont suivis.

#Tokenomics et marché global

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

La supply de l’actif et ce qui s’en déduit. C’est la seule famille de cette page qui prend un ?symbol=.

ChampTypeDescription
circulating_supplyfloatSupply en circulation.
total_supplyfloatSupply totale émise.
max_supplyfloat | nullPlafond, quand l’actif en a un.
pricefloatLe prix de référence utilisé pour le calcul.
market_capfloatCapitalisation, dérivée à la demande — supply multipliée par le prix, jamais reprise telle quelle d’une source tierce.
fdvfloat | nullValorisation pleinement diluée. Calculée sur la supply totale quand il n’y a pas de plafond ; null sur un stablecoin.
GET/v1/globaldata_type · global_market
GET/v1/global/historydata_type · global_market_history
ChampTypeDescription
total_market_cap_usdfloatCapitalisation de l’ensemble du marché.
total_volume_usdfloatVolume échangé sur 24 h.
btc_dominance / eth_dominancefloatPart des deux actifs majeurs.
others_dominancefloat | nullLe reste, dérivé : 100 moins les deux. null si l’un des deux manque.
active_cryptocurrenciesintegerNombre d’actifs recensés.

#Fear & Greed

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

L’indice de peur et d’avidité du marché crypto : une valeur de 0 à 100 et sa classification, d’Extreme Fear à Extreme Greed. Marché entier — il n’accepte pas de symbole.

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

Un point par jour

L’indice est publié une fois par jour, aligné sur minuit UTC. L’historique remonte à 2018, soit plus de trois mille points. L’interroger plus souvent qu’une fois par jour consomme du quota sans rien apprendre.