API REST

Prix et volume

De la bougie au tick : ce que le marché a imprimé, avant toute interprétation. Les bougies OHLCV viennent d’une référence de prix unique ; tout le reste est agrégé sur l’ensemble des places.

#Bougies OHLCV

GET/v1/raw/klinesdata_type · raw_klines

GET/v1/raw/klines/{interval}data_type · raw_klines_<interval>

Bougies à la minute pour la première route, multi-timeframe pour la seconde — 1m, 5m, 15m, 30m, 1h, 4h, 1d, 1w. Un intervalle hors liste rend 422.

Paramètre	Type	Défaut	Description
`symbol`	string	requis	L’actif.
`limit`	integer	60 · 100	Nombre de bougies, de 1 à 1000. Le défaut est 60 sur la route à la minute, 100 sur la route multi-timeframe.

curl

curl -H "X-API-KEY: $BYTNODE_KEY" \
  "https://api.bytnode.com/v1/raw/klines/1h?symbol=BTCUSDT&limit=100"

Champ	Type	Description
`timestamp`	string	Début de la bougie, ISO 8601.
`open, high, low, close`	float	Les quatre prix.
`volume`	float	Volume total, en unités de l’actif de base.
`taker_buy`	float	Volume exécuté à l’achat au marché.
`taker_sell`	float	Volume exécuté à la vente au marché.

#Variation de prix

GET/v1/price-changedata_type · price_change

La variation en pourcentage sur les huit pas de temps, calculée à la demande contre le prix d’il y a une minute, cinq minutes, une heure, une semaine. Un pas dont l’historique manque vaut null, jamais une erreur.

Réponse

{
  "status": "ok",
  "data_type": "price_change",
  "data": {
    "symbol": "BTCUSDT",
    "price": 71420.83,
    "timestamp": "2026-08-29T11:38:00+00:00",
    "changes": {
      "1m": 0.02, "5m": -0.11, "15m": -0.31, "30m": -0.44,
      "1h": 0.15, "4h": 1.02, "1d": -2.31, "1w": 5.60
    }
  }
}

C’est l’une des rares routes servies pour les stablecoins : elle bascule alors sur les ticks spot.

#Trades agrégés

GET/v1/raw/tradesdata_type · raw_trades

Une ligne par seconde, sommée sur toutes les places. Le paramètre limit compte donc des secondes, pas des trades.

Champ	Type	Description
`timestamp`	string	La seconde concernée.
`total_volume`	float	Volume total, somme des places.
`trade_count`	integer	Nombre de trades, somme des places.
`taker_buy_vol`	float	Volume acheteur au marché.
`taker_sell_vol`	float	Volume vendeur au marché.

GET/v1/raw/taker-combineddata_type · raw_taker_combined

Le même partage acheteur/vendeur, mais par minute : c’est la mesure de pression directionnelle à l’échelle macro. limit compte des minutes, de 1 à 1000.

#Ticks et gros ordres

GET/v1/raw/spot-ticksdata_type · raw_spot_ticks

GET/v1/raw/futures-ticksdata_type · raw_futures_ticks

Les trades individuels, un par ligne, toutes places confondues et sans étiquette de source. limit va de 1 à 10 000.

Champ	Type	Description
`timestamp`	string	Horodatage du trade.
`side`	string	buy ou sell — le côté du preneur de liquidité.
`price`	float	Prix d’exécution.
`quantity`	float	Taille, en unités de l’actif de base.
`usd_value`	float	Valeur en dollars.

GET/v1/raw/trades/largedata_type · raw_trades_large

Le même flux à terme, filtré par montant : la lecture de bande, pour repérer les ordres qui comptent.

Paramètre	Type	Défaut	Description
`symbol`	string	requis	L’actif.
`min_usd`	float	100000	Montant minimum en dollars. Plancher à 1000.
`limit`	integer	50	Nombre d’événements, de 1 à 1000.

curl

# Les cinquante derniers ordres de plus de 250 000 $
curl -H "X-API-KEY: $BYTNODE_KEY" \
  "https://api.bytnode.com/v1/raw/trades/large?symbol=BTCUSDT&min_usd=250000&limit=50"

#Bougies de trades

GET/v1/tradesdata_type · trades_candle_<tf>

GET/v1/trades/spotdata_type · trades_candle_spot_<tf>

GET/v1/trades/futuredata_type · trades_candle_future_<tf>

Des bougies construites sur les trades plutôt que sur le prix : elles disent combien d’ordres sont passés, dans quel sens et pour quel montant. Toujours agrégées sur l’ensemble des places — le champ exchange vaut donc toujours combined.

Chaque route a son historique : /v1/trades/history, /v1/trades/spot/history, /v1/trades/future/history.

Paramètre	Type	Défaut	Description
`symbol`	string	requis	L’actif.
`timeframe`	string	requis	1m, 5m, 15m, 30m, 1h, 4h, 1d. Absent ou invalide : 422.
`live`	boolean	false	Sur les routes de dernière valeur uniquement : expose la bougie en formation.
`limit`	integer	100	Sur les routes /history, de 1 à 1000. Ces historiques n’acceptent pas de fenêtre datée.

curl

# La bougie de trades 5 minutes en cours
curl -H "X-API-KEY: $BYTNODE_KEY" \
  "https://api.bytnode.com/v1/trades?symbol=BTCUSDT&timeframe=5m&live=1"

Champ	Type	Description
`bucket`	string	Début de la bougie, ISO 8601.
`exchange`	string	Toujours combined.
`trades_count`	integer	Nombre de trades sur la fenêtre.
`trades_count_buy / trades_count_sell`	integer	Décomposition directionnelle du nombre de trades.
`trade_count_dom`	integer	Achats moins ventes, en nombre de trades.
`trades_avg`	float \| null	Montant moyen en dollars par trade.
`trade_avg_buy / trade_avg_sell`	float \| null	Montant moyen à l’achat et à la vente.
`trade_volume`	float	Volume total en dollars.
`trade_volume_buy / trade_volume_sell`	float	Volume acheteur et vendeur en dollars.
`volume_delta`	float	Volume acheteur moins vendeur, en dollars.
`trade_rate`	float	Trades par seconde : le nombre divisé par la durée du pas de temps — y compris sur une bougie en formation, pour que la définition reste la même.
`is_closed`	boolean	Faux uniquement sur une bougie en formation.

Sur un stablecoin

/v1/trades et /v1/trades/spot restent alimentées, puisqu’un stablecoin a un marché au comptant. /v1/trades/future rend une liste vide.