API REST

Macro, ETF et sentiment

Le contexte dans lequel évolue le marché crypto : taux, dollar, liquidité, indices, or et pétrole, plus les fondamentaux des ETF, l’offre des actifs et l’indice de sentiment. Toutes ces routes portent sur tout le marché, à l’exception de 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 renvoie 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 des pays é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, reverse repos 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
# 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"
ChampTypeDescription
series_idstringL’identifiant à passer dans ?series=.
categorystringL’une 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 : n’additionnez 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 aux 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 reverse repos au jour le jour. La réponse porte la formule et ses composantes, et l’unité est explicite, les trois séries sources n’étant 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, sur trente et quatre-vingt-dix jours. Une masse monétaire en hausse et un 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 de la courbe 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 intrajournalière

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 unités de temps : EUR/USD, USD/JPY, pétrole WTI, l’indice dollar et l’or tokenisé. Cinq ne sont servis qu’en quotidien : les taux à 10 et 30 ans, le VIX, le S&P et le Nasdaq.

ParamètreTypeDéfautDescription
seriesstringobligatoireL’identifiant de l’instrument, tel que le catalogue le renvoie.
timeframestringobligatoire1m, 5m, 15m, 1h, 4h, 1d. L’unité de temps 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 une unité de temps qu’une série ne sert pas renvoie 400 avec la liste de celles qu’elle sert, plutôt qu’une liste vide, qui laisserait croire à un trou dans les données.

#Fondamentaux des 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 actif net, 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

L’offre de l’actif et ce qui en découle. C’est la seule famille de cette page qui prend un ?symbol=.

ChampTypeDescription
circulating_supplyfloatOffre en circulation.
total_supplyfloatOffre 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 (offre multipliée par le prix), jamais reprise telle quelle d’une source tierce.
fdvfloat | nullValorisation entièrement diluée. Calculée sur l’offre 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 tout le 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 listé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, de Extreme Fear à Extreme Greed. Tout le marché : 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, plus de trois mille points. L’interroger plus d’une fois par jour consomme du quota sans rien apprendre.