Modèle de données

Cette page décrit le modèle de données commun partagé par les outils de données de marché du MCP de Cryptohopper. Les trois types de données primaires — ticker, carnet d'ordres et chandelier — ont chacun leur propre page de référence avec le schéma de réponse exact :

• Référence de l'outil Ticker
• Référence de l'outil Carnet d'ordres
• Référence de l'outil Chandelier

Cette page documente les conventions communes aux trois.

Conventions

Format de symbole

Tous les symboles de paire utilisent le format BASE/QUOTE :

Exemple	Base	Quote
BTC/USDT	BTC	USDT
ETH/USD	ETH	USD
SOL/USDC	SOL	USDC

Le format est normalisé côté serveur. Les exchanges en amont utilisent une variété de notations (par exemple BTCUSDT, BTC-USDT, tBTCUSDT) ; le MCP présente un format BASE/QUOTE uniforme quelle que soit la convention en amont.

Consulte les exchanges pris en charge pour la liste des exchanges que le MCP peut interroger.

Identifiants d'exchange

Les noms d'exchange dans les requêtes et les réponses utilisent des identifiants en minuscules :

Identifiant	Exchange
binance	Binance
coinbase	Coinbase
kraken	Kraken
bybit	Bybit
okx	OKX

La liste complète est renvoyée par l'outil list-exchanges et documentée dans les exchanges pris en charge.

Horodatages

Tous les horodatages dans les réponses sont en UTC et formatés ISO-8601 : 2026-04-24T14:03:00Z

Les horodatages numériques, lorsqu'ils sont exposés (par exemple, dans les enregistrements de chandelier), sont des horodatages Unix en millisecondes.

Encodage décimal

Les valeurs de prix et de taille sont renvoyées en tant que nombres JSON (flottants). Exemples de chaque outil :

// Ticker
{
  "last": 80934.19,
  "baseVolume": 11744.6152
}

// Orderbook level
[80934.18, 5.32816]

// Candle record
[1778540400000, 81833.92, 81833.92, 81720.40, 81812.55, 142.8731, 318]

Étant donné que les nombres JSON sont analysés en tant que virgule flottante IEEE-754 dans la plupart des langages, les clients qui nécessitent une précision exacte (par exemple, lors du calcul des tailles d'ordre) doivent convertir ces valeurs en un type décimal immédiatement après l'analyse — par exemple, Decimal de Python, BigNumber.js de JavaScript, ou un équivalent.

Champs optionnels

Certains champs sont optionnels et peuvent être absents des réponses lorsque l'exchange en amont ne les fournit pas. Les clients doivent traiter les champs manquants comme null plutôt que comme une erreur.

Champs communs

Trois champs apparaissent dans la plupart des réponses :

Champ	Type	Description
exchange	string	L'identifiant de l'exchange d'où proviennent les données.
pair	string	La paire au format BASE/QUOTE.
timestamp	string (ISO-8601)	L'heure à laquelle les données ont été capturées.

Les champs restants dépendent de l'outil. Les schémas complets suivent.

Schéma de ticker (résumé)

Une réponse de ticker est un objet unique décrivant l'état actuel d'un marché. Les noms de champs suivent les conventions CCXT.

Les champs incluent :

• last — dernier prix échangé
• bid — meilleur prix bid
• ask — meilleur prix ask
• bidVolume — taille au meilleur bid
• askVolume — taille au meilleur ask
• high — plus haut sur 24 heures
• low — plus bas sur 24 heures
• open — prix d'ouverture pour la fenêtre de 24 heures
• close — prix de clôture pour la fenêtre de 24 heures (généralement égal à last)
• previousClose — prix de clôture de la fenêtre de 24 heures précédente
• average — moyenne de open et close
• vwap — prix moyen pondéré par le volume sur 24 heures
• baseVolume — volume sur 24 heures dans l'actif de base
• quoteVolume — volume sur 24 heures dans l'actif de cotation
• change — changement de prix absolu sur 24 heures
• percentage — changement de pourcentage sur 24 heures

Consulte la référence de l'outil ticker pour le schéma complet et les types de champs.

Schéma de carnet d'ordres (résumé)

Une réponse de carnet d'ordres contient deux tableaux — bids et asks — chaque élément étant un tuple [prix, taille] :

• bids — tableau de paires [prix, taille], triées par prix décroissant (bid le plus élevé en premier)
• asks — tableau de paires [prix, taille], triées par prix croissant (ask le plus bas en premier)

La profondeur de chaque côté dépend de l'exchange en amont. Consulte la référence de l'outil carnet d'ordres pour plus de détails.

Schéma de chandelier (résumé)

Une réponse de chandelier est un tableau d'enregistrements OHLCV, ordonnés chronologiquement (le plus ancien en premier par défaut). Chaque enregistrement est lui-même un tableau avec sept positions :

Index	Champ	Description
0	timestamp	Heure d'ouverture de la barre (horodatage Unix en millisecondes)
1	open	Prix d'ouverture
2	high	Prix le plus élevé dans la barre
3	low	Prix le plus bas dans la barre
4	close	Prix de clôture
5	volume	Volume de l'actif de base échangé dans la barre
6	count	Nombre de transactions dans la barre

Exemple :

[1778540400000, 81833.92, 81833.92, 81720.40, 81812.55, 142.8731, 318]

Consulte la référence de l'outil chandelier pour le schéma complet, les périodes prises en charge et la sémantique de rétrospection.

Réponses d'erreur

Lorsqu'un appel d'outil échoue, la réponse suit l'enveloppe d'erreur MCP :

{
  "code": "QUOTA_EXCEEDED",
  "message": "Weekly call limit reached",
  "details": {
    "reset_at": "2026-04-25T00:00:00Z"
  }
}