Catalogue des endpoints : les routes des outils MCP
Tout ce qui peut être appelé, sur une page. Les paramètres de chaque route sont lus dans le contrat OpenAPI : ils ne peuvent donc pas diverger de ce qui est servi. Le détail (champs de réponse, unités, pièges) vit dans la page de la famille, liée en tête de chaque section, et dans la référence interactive.
Hôte : https://api.bytnode.com. Chaque route exige l’en-tête X-API-KEY (sauf /v1/health) et accepte ?fields= (sauf /v1/health, /v1/status et POST /v1/indicators, qui choisissent leur sortie autrement). La colonne Paramètres liste symbol là où la route le prend ; les routes du marché entier (macro, on-chain, ETF, marché global, sentiment, système) n’en prennent pas et le refusent.
Un agent IA n’a pas besoin de ce catalogue : il découvre les onze outils du serveur MCP, lit leurs descriptions et appelle ces routes à travers eux.
#Système et métadonnées
| Route | Description | Paramètres | Famille de données |
|---|---|---|---|
GET /v1/health no key | Est-ce que l’API répond. | — | — |
GET /v1/status | Fraîcheur de chaque flux de données, flux par flux. | — | price_volume |
GET /v1/symbols | Les symboles activés. | — | price_volume |
GET /v1/capabilities | Ce qui peut être calculé pour ce symbole, et ce qui ne peut pas l’être. | symbol (required) | price_volume |
GET /v1/limits | Ce que votre clé peut faire : familles, fenêtres d’historique, débit et quota restants. | — | — |
POST /v1/ws/token | Un jeton WebSocket éphémère pour une page web : 60 secondes, une connexion, jamais votre clé. | — | — |
#Snapshot
| Route | Description | Paramètres | Famille de données |
|---|---|---|---|
GET /v1/snapshot | Jusqu’à 52 champs en une requête. | one parameter per field (value = depth or true) | snapshot |
#Prix et volume
| Route | Description | Paramètres | Famille de données |
|---|---|---|---|
GET /v1/klines | La dernière bougie OHLCV close, toutes les unités de temps de 1m à 1w. | timeframe (required), live, symbol (required) | price_volume |
GET /v1/klines/history | Bougies OHLCV, toutes les unités de temps de 1m à 1w, de la plus récente à la plus ancienne. | timeframe (required), since_ms, until_ms, limit, symbol (required), before_ms, order | price_volume |
GET /v1/price-change | Variation en % sur les huit unités de temps. | symbol (required) | price_volume |
GET /v1/trades/spot | Transactions spot individuelles. | limit, since_ms, until_ms, before_ms, after_id, order, symbol (required) | trades |
GET /v1/trades/futures | Transactions futures individuelles. | limit, since_ms, until_ms, before_ms, after_id, order, symbol (required) | trades |
GET /v1/trades/large | Gros ordres, filtrés par montant. | min_usd, limit, since_ms, until_ms, before_ms, after_id, order, symbol (required) | trades |
GET /v1/trades-kline/futures/seconds | Transactions futures agrégées à la seconde, toutes places. | limit, since_ms, until_ms, order, symbol (required), before_ms | trades |
GET /v1/trades-kline | Bougie de transactions, spot et futures additionnés. | symbol (required), timeframe (required), live | microstructure |
GET /v1/trades-kline/history | Historique des bougies de transactions. | symbol (required), timeframe (required), since_ms, until_ms, limit, before_ms, order | microstructure |
GET /v1/trades-kline/spot | Bougie de transactions, spot seul. | symbol (required), timeframe (required), live | microstructure |
GET /v1/trades-kline/spot/history | Historique spot. | symbol (required), timeframe (required), since_ms, until_ms, limit, before_ms, order | microstructure |
GET /v1/trades-kline/futures | Bougie de transactions, futures seuls. | symbol (required), timeframe (required), live | microstructure |
GET /v1/trades-kline/futures/history | Historique futures. | symbol (required), timeframe (required), since_ms, until_ms, limit, before_ms, order | microstructure |
#Dérivés
| Route | Description | Paramètres | Famille de données |
|---|---|---|---|
GET /v1/oi | Intérêt ouvert courant, additionné sur les places. | symbol (required) | derivatives |
GET /v1/oi/history | Intérêt ouvert agrégé, par bucket. | since_ms, until_ms, limit, timeframe (required), symbol (required), before_ms, order | derivatives |
GET /v1/oi/change | Variation de l’intérêt ouvert. | symbol (required) | derivatives |
GET /v1/oi/change/history | Historique du delta d’intérêt ouvert. | since_ms, until_ms, limit, timeframe (required), symbol (required), before_ms, order | derivatives |
GET /v1/funding/rate | Dernier taux de funding appliqué. | live, symbol (required) | derivatives |
GET /v1/funding/rate/history | Historique du taux appliqué. | since_ms, until_ms, limit, symbol (required), before_ms, order | derivatives |
GET /v1/funding/next | Prochain funding estimé. | symbol (required) | derivatives |
GET /v1/funding/cumulative | Funding cumulé sur 24 h. | symbol (required) | derivatives |
GET /v1/funding/cumulative/history | Historique du funding cumulé. | since_ms, until_ms, limit, symbol (required), before_ms, order | derivatives |
GET /v1/liquidations/events | Liquidations individuelles. | limit, min_usd, symbol (required) | derivatives |
GET /v1/liquidations/cumulative | Liquidations cumulées, acheteurs contre vendeurs. | symbol (required) | derivatives |
GET /v1/liquidations/cumulative/history | Historique des liquidations cumulées. | since_ms, until_ms, limit, timeframe (required), symbol (required), before_ms, order | derivatives |
GET /v1/liquidations/big-small-ratio | Grosses liquidations contre petites. | timeframe (required), symbol (required) | derivatives |
GET /v1/liquidations/big-small-ratio/history | Historique du ratio. | since_ms, until_ms, limit, timeframe (required), symbol (required), before_ms, order | derivatives |
GET /v1/basis | Écart futures contre spot. | symbol (required) | derivatives |
GET /v1/basis/history | Historique de la base. | since_ms, until_ms, limit, timeframe (required), symbol (required), before_ms, order | derivatives |
GET /v1/spread/interexchange | Prime de chaque place par rapport à la référence. | timeframe (required), live, symbol (required) | microstructure |
GET /v1/spread/interexchange/history | Historique des primes. | timeframe (required), since_ms, until_ms, limit, symbol (required), before_ms, order | microstructure |
#Flux et microstructure
| Route | Description | Paramètres | Famille de données |
|---|---|---|---|
GET /v1/cvd | Delta de volume cumulé, spot et futures. | timeframe (required), live, symbol (required) | microstructure |
GET /v1/cvd/history | Historique du CVD, spot et futures. | timeframe (required), since_ms, until_ms, limit, symbol (required), before_ms, order | microstructure |
GET /v1/cvd/spot | Delta de volume cumulé, spot seul. | timeframe (required), live, symbol (required) | microstructure |
GET /v1/cvd/spot/history | Historique du CVD, spot seul. | timeframe (required), since_ms, until_ms, limit, symbol (required), before_ms, order | microstructure |
GET /v1/cvd/futures | Delta de volume cumulé, futures seuls. | timeframe (required), live, symbol (required) | microstructure |
GET /v1/cvd/futures/history | Historique du CVD, futures seuls. | timeframe (required), since_ms, until_ms, limit, symbol (required), before_ms, order | microstructure |
GET /v1/orderbook | Profondeur du carnet par fourchette de prix, spot et futures. | timeframe (required), symbol (required) | microstructure |
GET /v1/orderbook/history | Historique du carnet d’ordres, spot et futures. | timeframe (required), since_ms, until_ms, limit, symbol (required), before_ms, order | microstructure |
GET /v1/orderbook/spot | Profondeur du carnet par fourchette de prix, spot seul. | timeframe (required), symbol (required) | microstructure |
GET /v1/orderbook/spot/history | Historique du carnet d’ordres, spot seul. | timeframe (required), since_ms, until_ms, limit, symbol (required), before_ms, order | microstructure |
GET /v1/orderbook/futures | Profondeur du carnet par fourchette de prix, futures seuls. | timeframe (required), symbol (required) | microstructure |
GET /v1/orderbook/futures/history | Historique du carnet d’ordres, futures seuls. | timeframe (required), since_ms, until_ms, limit, symbol (required), before_ms, order | microstructure |
GET /v1/buy-sell-ratio | Ratio achat / vente du dernier bucket clos, spot et futures. | timeframe (required), symbol (required) | microstructure |
GET /v1/buy-sell-ratio/history | Historique du ratio achat / vente, spot et futures. | since_ms, until_ms, limit, timeframe (required), symbol (required), before_ms, order | microstructure |
GET /v1/buy-sell-ratio/spot | Ratio achat / vente du dernier bucket clos, spot seul. | timeframe (required), symbol (required) | microstructure |
GET /v1/buy-sell-ratio/spot/history | Historique du ratio achat / vente, spot seul. | since_ms, until_ms, limit, timeframe (required), symbol (required), before_ms, order | microstructure |
GET /v1/buy-sell-ratio/futures | Ratio achat / vente du dernier bucket clos, futures seuls. | timeframe (required), symbol (required) | microstructure |
GET /v1/buy-sell-ratio/futures/history | Historique du ratio achat / vente, futures seuls. | since_ms, until_ms, limit, timeframe (required), symbol (required), before_ms, order | microstructure |
GET /v1/trades/avg-size | Taille moyenne des transactions, spot et futures. | timeframe (required), symbol (required) | microstructure |
GET /v1/trades/avg-size/history | Historique de la taille moyenne, spot et futures. | since_ms, until_ms, limit, timeframe (required), symbol (required), before_ms, order | microstructure |
GET /v1/trades/avg-size/spot | Taille moyenne des transactions, spot seul. | timeframe (required), symbol (required) | microstructure |
GET /v1/trades/avg-size/spot/history | Historique de la taille moyenne, spot seul. | since_ms, until_ms, limit, timeframe (required), symbol (required), before_ms, order | microstructure |
GET /v1/trades/avg-size/futures | Taille moyenne des transactions, futures seuls. | timeframe (required), symbol (required) | microstructure |
GET /v1/trades/avg-size/futures/history | Historique de la taille moyenne, futures seuls. | since_ms, until_ms, limit, timeframe (required), symbol (required), before_ms, order | microstructure |
#Indicateurs techniques
| Route | Description | Paramètres | Famille de données |
|---|---|---|---|
POST /v1/indicators | Dix-neuf types d’indicateurs, jusqu’à 50 instances par appel. | — | indicators |
#Options
| Route | Description | Paramètres | Famille de données |
|---|---|---|---|
GET /v1/options/summary | Vue d’ensemble de l’actif. | asset (required) | options |
GET /v1/options/oi | Intérêt ouvert des options. | asset (required) | options |
GET /v1/options/oi/history | Historique de l’intérêt ouvert. | timeframe (required), since_ms, until_ms, limit, asset (required), before_ms, order | options |
GET /v1/options/oi/change | Variation de l’intérêt ouvert. | timeframe (required), asset (required) | options |
GET /v1/options/oi/change/history | Historique du delta. | timeframe (required), since_ms, until_ms, limit, asset (required), before_ms, order | options |
GET /v1/options/oi/distribution | Répartition de l’OI par strike et par échéance. | expiry, asset (required) | options |
GET /v1/options/volume | Volume des options en USD. | asset (required) | options |
GET /v1/options/volume/history | Historique du volume. | timeframe (required), since_ms, until_ms, limit, asset (required), before_ms, order | options |
GET /v1/options/put-call-ratio | Ratio put / call. | asset (required) | options |
GET /v1/options/put-call-ratio/history | Historique du put / call. | timeframe (required), since_ms, until_ms, limit, asset (required), before_ms, order | options |
GET /v1/options/max-pain | Max pain par échéance. | asset (required) | options |
GET /v1/options/max-pain/history | Historique du max pain. | expiry (required), since_ms, until_ms, limit, asset (required), before_ms, order | options |
GET /v1/options/iv | Volatilité implicite pondérée. | asset (required) | options |
GET /v1/options/iv/klines | La dernière bougie OHLC close de la volatilité implicite. | timeframe (required), asset (required) | options |
GET /v1/options/iv/klines/history | Bougies OHLC de la volatilité implicite, de la plus récente à la plus ancienne. | timeframe (required), since_ms, until_ms, limit, asset (required), before_ms, order | options |
GET /v1/options/greeks | Grecques agrégées. | asset (required) | options |
GET /v1/options/expiry | Synthèse par échéance. | asset (required) | options |
#Réseau Bitcoin
| Route | Description | Paramètres | Famille de données |
|---|---|---|---|
GET /v1/btc/network | Hauteur, difficulté, prochain ajustement. | — | onchain |
GET /v1/btc/network/history | Historique du réseau. | since_ms, until_ms, limit, before_ms, order | onchain |
GET /v1/btc/mempool | Transactions en attente, poids, frais. | — | onchain |
GET /v1/btc/mempool/history | Historique du mempool. | since_ms, until_ms, limit, before_ms, order | onchain |
GET /v1/btc/fees | Frais recommandés par priorité. | — | onchain |
GET /v1/btc/fees/history | Historique des frais. | since_ms, until_ms, limit, timeframe, before_ms, order | onchain |
GET /v1/btc/mining | Concentration des pools, récompenses. | — | onchain |
GET /v1/btc/mining/history | Historique du minage. | dataset, since_ms, until_ms, limit, before_ms, order | onchain |
#Valorisation on-chain de Bitcoin
| Route | Description | Paramètres | Famille de données |
|---|---|---|---|
GET /v1/btc/mvrv | MVRV et zone de valorisation. | — | onchain |
GET /v1/btc/mvrv/history | Historique du MVRV. | since_ms, until_ms, limit, before_ms, order | onchain |
GET /v1/btc/nvt | NVT et son signal lissé. | — | onchain |
GET /v1/btc/nvt/history | Historique du NVT. | since_ms, until_ms, limit, before_ms, order | onchain |
GET /v1/btc/active-addresses | Adresses actives et momentum. | — | onchain |
GET /v1/btc/active-addresses/history | Historique des adresses actives. | since_ms, until_ms, limit, before_ms, order | onchain |
GET /v1/btc/revenue-per-difficulty | Stress des mineurs. | — | onchain |
GET /v1/btc/revenue-per-difficulty/history | Historique du stress des mineurs. | since_ms, until_ms, limit, before_ms, order | onchain |
#On-chain Ethereum
| Route | Description | Paramètres | Famille de données |
|---|---|---|---|
GET /v1/eth/supply | Offre, staking, brûlé, émission nette. | — | onchain |
GET /v1/eth/supply/history | Historique de l’offre. | since_ms, until_ms, limit, before_ms, order | onchain |
GET /v1/eth/gas | Prix du gas et congestion. | — | onchain |
GET /v1/eth/gas/history | Historique du gas. | since_ms, until_ms, limit, before_ms, order | onchain |
GET /v1/eth/gas-momentum | Momentum du gas et régime. | — | onchain |
GET /v1/eth/gas-momentum/history | Historique du momentum. | since_ms, until_ms, limit, before_ms, order | onchain |
GET /v1/eth/staking | Taux et rendement du staking. | — | onchain |
GET /v1/eth/staking/history | Historique du staking. | since_ms, until_ms, limit, before_ms, order | onchain |
GET /v1/eth/deflation | Brûlage contre émission. | — | onchain |
GET /v1/eth/deflation/history | Historique de la déflation. | since_ms, until_ms, limit, before_ms, order | onchain |
GET /v1/eth/defi | TVL d’Ethereum et volume des DEX. | — | onchain |
GET /v1/eth/defi/history | Historique DeFi. | since_ms, until_ms, limit, before_ms, order | onchain |
GET /v1/eth/squeeze | Indice de squeeze. | — | onchain |
GET /v1/eth/squeeze/history | Historique du squeeze. | since_ms, until_ms, limit, before_ms, order | onchain |
GET /v1/eth/price-btc | Ratio ETH/BTC et momentum. | — | onchain |
GET /v1/eth/price-btc/history | Historique du ratio. | since_ms, until_ms, limit, before_ms, order | onchain |
#Macro
| Route | Description | Paramètres | Famille de données |
|---|---|---|---|
GET /v1/macro | Dernière valeur d’une série (series obligatoire). | series (required) | macro |
GET /v1/macro/series | Catalogue des séries disponibles. | category | macro |
GET /v1/macro/history | Historique d’une série. | since_ms, until_ms, limit, series (required), before_ms, order | macro |
GET /v1/macro/correlations | Corrélations BTC contre macro. | — | macro |
GET /v1/macro/net-liquidity | Liquidité nette. | — | macro |
GET /v1/macro/net-liquidity/history | Historique de la liquidité nette. | since_ms, until_ms, limit, before_ms, order | macro |
GET /v1/macro/momentum | Score de momentum macro. | — | macro |
GET /v1/macro/risk | Régime risk-on / risk-off. | — | macro |
GET /v1/macro/intraday/series | Catalogue des instruments intrajournaliers. | — | macro |
GET /v1/macro/intraday/history | Bougies OHLC d’un instrument macro. | since_ms, until_ms, limit, series (required), timeframe (required), before_ms, order | macro |
#ETF, tokenomics et sentiment
| Route | Description | Paramètres | Famille de données |
|---|---|---|---|
GET /v1/etf/fundamentals | Ancrage trimestriel par émetteur. | asset (required) | etf |
GET /v1/etf/fundamentals/history | Historique des fondamentaux. | ticker, since_ms, until_ms, limit, asset (required), before_ms, order | etf |
GET /v1/tokenomics | Offre, capitalisation et FDV du symbole. | symbol (required) | tokenomics |
GET /v1/tokenomics/history | Historique tokenomics. | since_ms, until_ms, limit, symbol (required), before_ms, order | tokenomics |
GET /v1/global | Capitalisation totale et dominance. | — | price_volume |
GET /v1/global/history | Historique du marché global. | since_ms, until_ms, limit, timeframe, before_ms, order | price_volume |
GET /v1/fear-greed | Fear & Greed du jour. | — | sentiment |
GET /v1/fear-greed/history | Historique depuis 2018. | since_ms, until_ms, limit, before_ms, order | sentiment |
GET /v1/fear-greed/cmc | Fear & Greed de CoinMarketCap, rafraîchi dans la journée. | — | sentiment |
GET /v1/fear-greed/cmc/history | Un point par jour depuis 2023. | since_ms, until_ms, limit, before_ms, order | sentiment |
GET /v1/altcoin-season | Altcoin Season Index, capitalisation des altcoins, extrêmes sur un an. | — | sentiment |
GET /v1/altcoin-season/history | Un point par jour, depuis 90 jours puis au fil de l’eau. | since_ms, until_ms, limit, before_ms, order | sentiment |
GET /v1/indices/cmc20 | Indice CMC20, variation sur 24 h et ses 20 composants. | — | sentiment |
GET /v1/indices/cmc20/history | Une valeur par jour depuis 2024. | since_ms, until_ms, limit, before_ms, order | sentiment |
GET /v1/indices/cmc100 | Indice CMC100, variation sur 24 h et ses 100 composants. | — | sentiment |
GET /v1/indices/cmc100/history | Une valeur par jour depuis 2024. | since_ms, until_ms, limit, before_ms, order | sentiment |