CryptoStruct

officiel

Serveur MCP distant pour données historiques de crypto et de marchés prédictifs : recherche de ~500 000 instruments, statistiques de marché en direct (OHLC, volume, écarts, profondeur, glissement) et achat de données tick. Sans clé pour le catalogue et les statistiques ; OAuth facultatif pour les outils de compte. Point de terminaison : https://cryptostruct.com/mcp

Que pouvez-vous faire avec CryptoStruct MCP ?

  • Rechercher dans le catalogue d’instruments — Interrogez les instruments sur 35 plateformes, y compris les marchés de prédiction, à l’aide de search_instruments avec des filtres comme class=prediction.
  • Obtenir des instantanés de marché en direct — Demandez les OHLC actuels, le VWAP, les spreads et la profondeur du carnet d’ordres pour tout instrument via get_market_snapshot.
  • Analyser les agrégats historiques — Récupérez des statistiques quotidiennes, horaires ou par minute (par ex., get_daily_stats, get_hourly_stats) pour des études d’événements ou des analyses de tendances.
  • Vérifier la couverture des archives — Confirmez la disponibilité des données au niveau journalier pour un instrument jusqu’en 2021 à l’aide de get_coverage.
  • Prévisualiser et démarrer les achats — Utilisez preview_checkout pour simuler un achat de données, puis create_checkout pour obtenir une URL Stripe ou déclencher une approbation de crédit.
  • Gérer votre compte — Listez les commandes passées, récupérez les téléchargements de fichiers achetés et vérifiez votre abonnement ou votre solde de crédit avec list_my_orders et get_my_subscription.

Documentation

Serveur MCP CryptoStruct

Serveur MCP distant propriétaire pour cryptostruct.com — données historiques de crypto et de marchés prédictifs (fichiers journaliers au niveau des ticks provenant de 35 plateformes, dont Kalshi et Polymarket) ainsi que des statistiques de marché en direct, conçu pour les traders, les quants et les agents IA.

Ce dépôt documente le serveur hébergé. Il n'y a rien à installer ni à exécuter depuis ici — le serveur est exploité par CryptoStruct.

Aucune clé API requise — le catalogue, les statistiques de marché et le flux d'achat invité fonctionnent sans clé. La connexion via OAuth (facultative) lie votre compte CryptoStruct pour l'historique des commandes, les téléchargements de fichiers achetés et le paiement avec vos crédits — toujours avec votre consentement (voir Achat de données).

Démarrage rapide

Claude Code

claude mcp add --transport http cryptostruct https://cryptostruct.com/mcp
# or, to enable account sign-in via OAuth:
claude mcp add --transport http cryptostruct https://cryptostruct.com/mcp/auth

Cursor / configuration JSON générique

{
  "mcpServers": {
    "cryptostruct": {
      "url": "https://cryptostruct.com/mcp"
    }
  }
}

claude.ai — Paramètres → Connecteurs → Ajouter un connecteur personnalisé → https://cryptostruct.com/mcp/auth

Ce que vous pouvez faire

  • Catalogue et découverte : recherchez environ 500 000 instruments sur 35 plateformes (spot, perpétuels, contrats à terme, options, marchés prédictifs), avec une couverture d'archives journalières remontant au 2021-02-08.
  • Marchés prédictifs : les contrats d'événements Kalshi et Polymarket sont des instruments de première classe — recherchables dans le catalogue (class=prediction), avec couverture, instantanés en direct et agrégats minute/quotidiens comme tout instrument crypto. Les contrats sont cotés de 0 à 1 (USD) ; le volume d'échange est normalisé en USD.
  • Statistiques de marché : instantanés en direct et agrégats minute/horaire/quotidiens — OHLC, VWAP, transactions, volume d'échange, spreads, profondeur du carnet d'ordres ; courbes de glissement / impact sur le marché.
  • Achat de données : fichiers de ticks bruts — instruments crypto et marchés prédictifs confondus — coûtent 1 € par instrument-jour. Paiement par carte : le serveur transmet une URL de paiement Stripe — le paiement s'effectue dans le navigateur de l'utilisateur, le serveur ne touche jamais aux données de carte. Des fichiers d'échantillons gratuits d'une journée complète sont disponibles sans aucun achat.
  • Crédits et consentement de l'agent (connexion OAuth) : les crédits du compte ne sont jamais dépensés par un agent sans le consentement de l'utilisateur. Par défaut, create_checkout répond à approval_required avec une page d'approbation où l'utilisateur confirme (paiement par crédits ou par carte) ou rejette la commande ; les commandes non approuvées expirent après 24 h sans aucun débit. Les utilisateurs peuvent opter pour des achats autonomes dans les limites (plafonds par commande et glissants sur 24 heures) à https://cryptostruct.com/account/agents — les commandes entièrement couvertes par les crédits sont alors exécutées immédiatement ; tout ce qui dépasse les plafonds revient pour approbation. L'agent peut également transmettre son propre max_credit_cents. preview_checkout indique à l'agent à l'avance lequel des trois résultats attendre. Ces paramètres ne peuvent être modifiés que sur le site web, jamais via le jeton d'un agent.
  • Outils de compte (connexion OAuth) : lister les commandes, obtenir les URL de téléchargement des fichiers achetés, vérifier l'abonnement, le solde de crédits et les paramètres de dépenses de l'agent.

Outils

OutilDescriptionNiveau
get_data_dictionaryDictionnaire de données et référence produit (format de fichier, unités, tarification)gratuit
search_instrumentsRechercher dans le catalogue d'instrumentsgratuit
list_venuesLister les plateformes couvertesgratuit
get_instrumentDétails d'un instrumentgratuit
get_coverageCouverture d'archives journalières pour un instrumentgratuit
list_sample_filesFichiers d'échantillons gratuits d'une journée complètegratuit
get_price_quoteDevis de prix pour un ensemble de fichiers de donnéesgratuit
get_market_snapshotInstantané de marché en direct (60 min + 24 h)gratuit
get_daily_statsAgrégats quotidiens (30 j–180 j gratuits ; 365 j/max Premium)gratuit
get_hourly_statsAgrégats horaires (7 j–90 j gratuits ; 180 j Premium)gratuit
get_slippageCourbe de glissement / impact sur le marché (1 h gratuite ; 24 h/7 j Premium)gratuit
get_top_instrumentsPrincipaux instruments par volume d'échange sur 24 h en directgratuit
get_moversMouvements sur 24 h (hausses et baisses)gratuit
get_minutes_rangeSérie historique minute pour études d'événementspremium
create_checkoutDémarrer un achat — URL Stripe (carte) ou approval_required / né payé (crédits, selon les paramètres de consentement de l'utilisateur)commerce
get_checkout_statusInterroger un paiement par session_id (carte) ou order_id (connecté ; commandes crédit/approbation)commerce
get_order_filesLister les fichiers d'une commande payée avec URL de téléchargementcommerce
request_file_restoreRestaurer un fichier archivé (stockage à froid)commerce
list_my_ordersMes commandesconnexion
get_my_filesMes fichiers achetésconnexion
get_my_subscriptionMon abonnement, solde de crédits et paramètres de dépenses de l'agentconnexion
preview_checkoutEssai à blanc d'un achat : fichiers possédés/indisponibles, couverture par crédits, et si create_checkout sera exécuté, demandera une approbation, ou sera transmis à Stripeconnexion

Niveaux : free/commerce fonctionnent sans clé. sign-in nécessite une connexion OAuth vérifiée (n'importe quel compte). Les outils/paramètres premium nécessitent CryptoStruct Premium (20 €/mois) — ce qui débloque également des fenêtres de statistiques plus longues (quotidien 365 j/max, horaire 180 j, glissement 24 h/7 j), des limites de recherche plus élevées, un bloc de qualité des données dans get_market_snapshot, et un budget d'appels 5×. Les appels au-delà de votre niveau renvoient des erreurs statiques AUTH_REQUIRED / PREMIUM_REQUIRED avec une URL de mise à niveau — jamais un échec définitif.

Limites de débit

Budget pondéré par appelant : 120 unités/min sans clé (par IP) ou par utilisateur connecté, 600 unités/min pour Premium. Les lectures de catalogue peu coûteuses coûtent 1 unité, les statistiques lourdes en amont 3–5, le paiement 10. En cas d'erreurs RATE_LIMITED, patientez le nombre de secondes indiqué.

Conventions

  • Toutes les tailles de fichiers sont en octets compressés (zstd) ; les valeurs de marché sont en USD ; les prix de vente sont en EUR.
  • Les données à granularité minute sont conservées ~30 jours en amont ; les agrégats horaires/quotidiens remontent plus loin.
  • Les fichiers de ticks sont des captures JSON-lines d'une journée complète (instantanés et mises à jour du carnet d'ordres, transactions, liquidations, financement, mark/index incluant les grecques des options). Référence de format : Market Data Protocol.

Liens connexes

Support

Questions ou problèmes : https://cryptostruct.com/contact