Référence de l'outil ticker
Cette page est la référence de l'outil pour récupérer des instantanés de ticks depuis le Cryptohopper Market Data MCP.
Nom de l'outil
get_ticker
Objectif
Renvoie un résumé instantané de l'état actuel d'un marché pour une paire spécifiée sur un exchange spécifié. Inclut le dernier prix négocié, la meilleure offre et demande, la fourchette sur 24 heures, le volume sur 24 heures et la variation sur 24 heures.
Arguments
| Argument | Type | Requis | Description |
|---|---|---|---|
| exchange | string | Oui | Identifiant de l'exchange (en minuscules). |
| pair | string | Oui | Paire au format BASE/QUOTE (par ex. BTC/USDT). |
Schéma de réponse
{
"exchange": "binance",
"pair": "BTC/USDT",
"timestamp": "2026-04-24T14:03:00Z",
"last": 80934.19,
"bid": 80932.50,
"ask": 80936.22,
"bidVolume": 1.10500,
"askVolume": 1.32000,
"high": 81920.00,
"low": 80120.00,
"open": 80214.00,
"close": 80934.19,
"previousClose": 80214.00,
"average": 80574.10,
"vwap": 80651.42,
"baseVolume": 11744.6152,
"quoteVolume": 946812440.18,
"change": 720.19,
"percentage": 0.90
}
Champs
| 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) | Heure de capture de l'instantané. |
| last | number | Dernier prix négocié. |
| bid | number | Meilleur prix d'offre. |
| ask | number | Meilleur prix de demande. |
| bidVolume | number | Taille disponible au meilleur prix d'offre. Peut être absent sur certains exchanges. |
| askVolume | number | Taille disponible au meilleur prix de demande. Peut être absent sur certains exchanges. |
| high | number | Prix de transaction le plus élevé des dernières 24 heures. |
| low | number | Prix de transaction le plus bas des dernières 24 heures. |
| open | number | Prix d'ouverture de la fenêtre actuelle de 24 heures. |
| close | number | Prix de clôture de la fenêtre actuelle de 24 heures. Généralement égal au dernier prix. |
| previousClose | number | Prix de clôture de la fenêtre précédente de 24 heures. Peut être absent sur certains exchanges. |
| average | number | Moyenne des prix d'ouverture et de clôture. Peut être absent sur certains exchanges. |
| vwap | number | Prix moyen pondéré par le volume sur 24 heures. Peut être absent sur certains exchanges. |
| baseVolume | number | Volume sur 24 heures dans l'actif de base. |
| quoteVolume | number | Volume sur 24 heures dans l'actif de cotation. Peut être absent sur certains exchanges. |
| change | number | Changement de prix absolu sur les dernières 24 heures (dernier - ouverture). |
| percentage | number | Changement en pourcentage sur les dernières 24 heures. |
Les prix et les tailles sont renvoyés sous forme de nombres JSON. Les clients qui nécessitent une précision exacte pour les calculs liés à l'exécution doivent les convertir en type décimal immédiatement après l'analyse. Voir le modèle de données pour les conventions.
Métriques dérivées
Le schéma du tick est intentionnellement compact. Les métriques dérivées sont calculées côté client :
| Métrique | Calcul |
|---|---|
| Écart (absolu) | ask - bid |
| Écart (points de base) | (ask - bid) / point médian × 10_000 |
| Point médian | (bid + ask) / 2 |
Le modèle ou ton code effectue ces calculs après le renvoi du tick. Aucun appel d'outil supplémentaire n'est nécessaire.
Fraîcheur
Les réponses des ticks reflètent l'état actuel de l'exchange en amont au moment de la requête. Le champ timestamp enregistre quand l'instantané a été capturé.
Les données de l'exchange sous-jacent se mettent à jour plusieurs fois par seconde. Le MCP n'expose pas de mode tick en streaming ; chaque invocation est une récupération instantanée fraîche. Pour la plupart des flux de travail d'agents IA, actualiser les ticks toutes les quelques secondes à quelques minutes est approprié. Pour des données tick par tick, un websocket d'exchange est l'outil approprié — ce n'est pas ce pour quoi le MCP est conçu.
Coût
| Aspect | Coût |
|---|---|
| Par invocation | 1 unité d'appel sur tous les niveaux |
| Variante historique | Non prise en charge — l'historique des ticks n'est pas disponible via le MCP. Pour une analyse de séries temporelles, utilise get_candles. |
Caractéristiques de mise à l'échelle
Les appels de ticks sont le type de données le moins cher et le plus rapide dans le MCP. Modèles d'utilisation typiques :
- Analyses larges. Récupérer les ticks sur les 200 premières paires d'un exchange consomme 200 unités d'appel — bien dans le quota hebdomadaire de chaque niveau.
- Comparaison multi-exchange. Récupérer la même paire sur 5 exchanges coûte 5 unités d'appel.
- Balayages de listes de surveillance. Une liste de surveillance de 20 paires actualisée toutes les heures représente 480 appels par jour, 3 360 par semaine — s'inscrit confortablement dans le niveau gratuit Pioneer.
Pour le modèle de conception qui exploite le faible coût des ticks, voir les modèles de prompts et un guide pratique des données de ticks.
Exemples d'invocations
Instantané de base
Demandé dans un client MCP :
Quel est le tick actuel de BTC/USDT sur Binance ?
L'agent invoque get_ticker(exchange="binance", pair="BTC/USDT") et renvoie l'instantané.
Comparaison inter-exchanges
Compare les ticks BTC/USDT sur Binance, Coinbase, Kraken et OKX. Lequel a l'écart le plus serré en ce moment ?
L'agent invoque get_ticker quatre fois, une fois par exchange, calcule les écarts localement et renvoie un classement.
Balayage de liste de surveillance
Pour chacun de BTC, ETH, SOL, ARB, OP, récupère le tick actuel depuis Binance et résume dans un tableau.
L'agent invoque get_ticker cinq fois et présente les résultats sous forme de tableau.
Erreurs
| Code d'erreur | Cause |
|---|---|
| UNAUTHORIZED | Clé API invalide ou révoquée. |
| EXCHANGE_NOT_SUPPORTED | Exchange non disponible sur le niveau actif. |
| PAIR_NOT_FOUND | La paire n'existe pas sur l'exchange spécifié. |
| INVALID_PARAMETER | L'argument a échoué à la validation (par ex. symbole de paire mal formé). |
| EXCHANGE_UNAVAILABLE | L'exchange en amont ne répond pas. |
| RATE_LIMIT_EXCEEDED | Limite de débit à court intervalle atteinte. |
| QUOTA_EXCEEDED | Quota hebdomadaire atteint. |
Accès par niveau
Les requêtes de ticks sont disponibles sur tous les niveaux (Pioneer, Explorer, Adventurer, Hero).
La restriction de couverture d'exchange s'applique : sur Pioneer, les requêtes de ticks sont limitées à Binance, Coinbase et Kraken. Sur Explorer et au-dessus, plus d'exchanges sont disponibles. Voir les exchanges pris en charge.