DexPaprika

Serveur MCP DexPaprika : données DEX et crypto en temps réel pour les agents IA

Un serveur Model Context Protocol (MCP) qui fournit un accès à la demande à l’API de données sur les cryptomonnaies et les DEX de DexPaprika. Conçu spécialement pour les assistants IA comme Claude, il permet de récupérer par programmation des données à jour sur les tokens, les pools et les DEX, sans aucune configuration.

En bref

# Install globally
npm install -g dexpaprika-mcp

# Start the server
dexpaprika-mcp

# Or run directly without installation
npx dexpaprika-mcp@latest

DexPaprika MCP connecte Claude aux données DEX en direct sur plusieurs blockchains. L’offre gratuite ne nécessite aucune clé API pour démarrer. Installation | Configuration | Référence de l’API

Vous préférez une configuration sans effort ? Utilisez le serveur MCP hébergé sur mcp.dexpaprika.com : aucune installation ni clé nécessaire pour démarrer, les mêmes outils de données, plus submitFeedback. Consultez Serveur hébergé pour connaître les points de terminaison de transport.

Dernière version

Consultez CHANGELOG.md pour les notes de version et les guides de migration.

Que pouvez-vous créer ?

• Outils d’analyse des tokens : suivre les mouvements de prix, les variations de profondeur de liquidité et les tendances de volume
• Comparaisons de DEX : analyser les structures de frais, les volumes et les pools disponibles sur différents DEX
• Analyses des pools de liquidité : surveiller les variations de TVL, calculer les pertes impermanentes et évaluer l’impact sur les prix
• Analyse de marché : comparer des tokens entre chaînes, suivre les tendances de volume et mesurer l’activité de trading
• Suivi de portefeuille : suivre la valeur actuelle, analyser les performances historiques et repérer les opportunités de rendement
• Analyse technique : effectuer des analyses techniques avancées à partir de données OHLCV historiques, notamment l’identification des tendances, la reconnaissance de figures et le calcul d’indicateurs

Installation

Installation via Smithery

Pour installer automatiquement DexPaprika pour Claude Desktop via Smithery :

npx -y smithery mcp add coinpaprika/dexpaprika

Installation manuelle

# Install globally (recommended for regular use)
npm install -g dexpaprika-mcp

# Start the server
dexpaprika-mcp

Il s’agit d’un serveur stdio : il communique avec MCP via stdin et stdout et n’ouvre aucun port. Au démarrage, il écrit DexPaprika MCP server v<version> (tool contract v<contract>) is running... sur stderr, puis attend un client. Lancez-le depuis un client MCP (Claude Desktop, Cursor, Claude Code) plutôt que de vous attendre à obtenir une URL dans un navigateur.

Tutoriel vidéo

Regardez notre tutoriel pas à pas pour configurer et utiliser le serveur MCP DexPaprika :

Intégration à Claude Desktop

Ajoutez ce qui suit au fichier de configuration de Claude Desktop :

macOS : ~/Library/Application\ Support/Claude/claude_desktop_config.json Windows : %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "dexpaprika": {
      "command": "npx",
      "args": ["dexpaprika-mcp@latest"]
    }
  }
}

Après le redémarrage de Claude Desktop, les outils DexPaprika seront automatiquement disponibles dans Claude.

Facultatif : utiliser une clé API

Le service fonctionne sans clé et continuera toujours de fonctionner ainsi. Aucune inscription, aucune carte, rien à configurer. Tout ce qui précède est la méthode prise en charge pour l’utiliser.

Une clé gratuite augmente le quota mensuel et permet le streaming sur n’importe quel token, au lieu de se limiter à l’ensemble public de démonstration. Elle n’augmente pas la limite de requêtes par minute, qui est identique pour les deux offres. Obtenez-en une sur console.dexpaprika.com ; les limites actuelles sont indiquées sur la page des limites de débit.

{
  "mcpServers": {
    "dexpaprika": {
      "command": "npx",
      "args": ["dexpaprika-mcp@latest"],
      "env": {
        "DEXPAPRIKA_API_KEY": "your_key_here"
      }
    }
  }
}

La clé doit être saisie seule, comme valeur complète de Authorization. Collez-la exactement telle qu’elle a été fournie, sans rien ajouter devant. Presque toutes les autres API exigent un préfixe devant la clé ; c’est donc la raison la plus fréquente pour laquelle une clé valide semble ne pas fonctionner.

Deux points à connaître :

• Une clé que nous ne pouvons pas lire ne génère pas d’erreur. Les points de terminaison de données ignorent une clé illisible et vous servent comme utilisateur anonyme, avec un 200 normal et des données réelles ; une faute de frappe ressemble donc à une réussite. Après en avoir configuré une, demandez à l’assistant d’exécuter getKeyStatus : cet outil indique l’offre réellement détectée par l’API et précise la cause probable si la clé n’est pas prise en compte.
• Les clients Dev et Pro doivent également définir DEXPAPRIKA_API_BASE_URL sur https://api-pro.dexpaprika.com, valeur également requise par getTokenOHLCV. L’hôte ne change pas automatiquement, car l’envoi d’une clé gratuite à cet hôte renvoie une erreur 403.

Serveur hébergé (sans installation)

Si vous préférez une configuration sans effort, connectez directement n’importe quel client compatible avec MCP au serveur hébergé sur mcp.dexpaprika.com. La page d’accueil fournit les instructions de configuration et la documentation. Les points de terminaison de transport suivants sont disponibles :

Transport	Point de terminaison	Cas d’utilisation
HTTP avec flux	https://mcp.dexpaprika.com/streamable-http	Recommandé pour la plupart des clients
SSE	https://mcp.dexpaprika.com/sse	Transport SSE historique
JSON-RPC	https://mcp.dexpaprika.com/json-rpc	JSON-RPC direct

Remarque : il s’agit de points de terminaison du protocole MCP. Ils n’afficheront rien dans un navigateur. Consultez mcp.dexpaprika.com pour accéder à la page d’accueil.

{
  "mcpServers": {
    "dexpaprika": {
      "type": "streamable-http",
      "url": "https://mcp.dexpaprika.com/streamable-http"
    }
  }
}

Outils disponibles (20)

Cette version auto-hébergée enregistre 20 outils de lecture : 19 outils de données de marché, plus getKeyStatus. Le serveur hébergé sur mcp.dexpaprika.com enregistre son propre ensemble, qui comprend submitFeedback. Vérifiez l’un ou l’autre à l’aide d’un tools/list en direct.

Découverte

Outil	Description
getCapabilities	Capacités du serveur, modèles de flux de travail, synonymes de réseaux et bonnes pratiques. Commencez ici.
getNetworks	Liste de toutes les blockchains prises en charge (36)
getStats	Statistiques générales de l’écosystème (nombre total de réseaux, de DEX, de pools et de tokens)
search	Rechercher des tokens, des pools et des DEX sur TOUS les réseaux par nom, symbole ou adresse
getKeyStatus	Indique si une clé est envoyée et quelle offre l’API détecte. Ne lit aucune donnée de marché.

Opérations sur les DEX

Outil	Description	Paramètres requis
getNetworkDexes	Lister les DEX d’un réseau donné	network

Opérations sur les pools

Outil	Description	Paramètres requis
getNetworkPools	PRINCIPAL. Obtenir les pools les plus liquides d’un réseau	network
getDexPools	Obtenir les pools d’un DEX donné (lignes sous results, pagination par curseur ; une clé est nécessaire pour dépasser la première page)	network, dex
getNetworkPoolsFilter	Filtrer les pools par volume, transactions et date de création	network
getPoolDetails	Informations détaillées sur un pool (prix, volume, TVL, tokens)	network, pool_address
getPoolOHLCV	Données historiques de chandeliers OHLCV	network, pool_address, start
getPoolIndicator	RSI, EMA, MACD, bandes de Bollinger ou VWAP pour un pool, calculés côté serveur à partir de ses chandeliers. Mêmes limites d’offre concernant l’historique et l’intervalle que pour getPoolOHLCV	network, pool_address, indicator
getPoolTransactions	Transactions/échanges récents d’un pool	network, pool_address

Opérations sur les tokens

Outil	Description	Paramètres requis
getTokenDetails	Informations détaillées sur un token	network, token_address
getTokenPools	Pools de liquidité contenant un token (filtre limité au réseau, results + pagination par curseur ; une clé est nécessaire pour dépasser la première page)	network, token_address
getTokenOHLCV	Chandeliers OHLCV historiques en USD pour un token, pondérés par le volume sur tous les pools où il est échangé. Nécessite une offre Dev ou Pro sur api-pro.dexpaprika.com ; les requêtes sans clé et les clés gratuites renvoient une erreur 403	network, token_address, start
getTokenIndicator	Mêmes indicateurs sur les chandeliers en USD d’un token, tous pools où il est échangé confondus. Nécessite une offre Dev ou Pro sur api-pro.dexpaprika.com ; les requêtes sans clé et les clés gratuites renvoient une erreur 403	network, token_address, indicator
getTokenMultiPrices	Prix groupés pour un maximum de 10 tokens	network, tokens[]
getTopTokens	Principaux tokens d’un réseau, classés par volume, liquidité, FDV ou variation de prix sur 24 h	network
filterNetworkTokens	Filtrer les tokens par volume, liquidité, FDV, transactions et date de création	network

Exemple d’utilisation

// Start by getting capabilities for workflow guidance:
const caps = await getCapabilities();

// Get details about a specific token:
const solanaJupToken = await getTokenDetails({
  network: "solana",
  token_address: "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN"
});

// Find pools containing a token (returns `results` with cursor pagination;
// the token filter only works network-scoped). This first page works without
// a key; passing the response's next_cursor back as cursor to fetch a later
// page needs an API key (a free key pages without limit):
const jupiterPools = await getTokenPools({
  network: "solana",
  token_address: "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN",
  order_by: "volume_usd_24h",
  limit: 5
});

// Get top pools on Ethereum (first page, returns `results` with cursor pagination):
const ethereumPools = await getNetworkPools({
  network: "ethereum",
  order_by: "volume_usd_24h",
  limit: 10
});

// Filter pools by volume and creation time:
const filteredPools = await getNetworkPoolsFilter({
  network: "ethereum",
  volume_24h_min: 100000,
  created_after: "-7d", // also Unix seconds, RFC3339 or YYYY-MM-DD
  sort_by: "volume_usd_24h",
  limit: 20
});

// Get historical price data for a pool:
const ohlcvData = await getPoolOHLCV({
  network: "ethereum",
  pool_address: "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
  start: "-24h",     // last 24 hours; works without a key
  interval: "1h",
  limit: 24
});

// Get historical USD price data for a token, volume-weighted across every
// pool it trades in. Requires a Dev or Pro key in DEXPAPRIKA_API_KEY and
// DEXPAPRIKA_API_BASE_URL=https://api-pro.dexpaprika.com;
// on a keyless or free key this returns 403, so fall back to getPoolOHLCV
// on the token's main pool (found with getTokenPools) instead.
const tokenOhlcvData = await getTokenOHLCV({
  network: "ethereum",
  token_address: "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
  start: "-24h",
  interval: "1h",
  limit: 24
});

// RSI for a pool, computed server-side (no need to fetch candles first).
// Send only the parameters of the indicator you ask for: period for rsi, ema,
// bbands and vwap; fast_period, slow_period and signal_period for macd;
// std_dev for bbands. Any other parameter is refused with 400.
const rsi = await getPoolIndicator({
  network: "ethereum",
  pool_address: "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
  indicator: "rsi",
  interval: "1h",
  start: "-24h"
});

// Batch prices for multiple tokens (max 10):
const prices = await getTokenMultiPrices({
  network: "ethereum",
  tokens: [
    "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
    "0xdac17f958d2ee523a2206206994597c13d831ec7"
  ]
});

Exemples de requêtes pour Claude

• « Analyse le token JUP sur Solana. Récupère son prix, son volume et ses principaux pools de liquidité. »
• « Compare le volume de trading entre Uniswap V3 et SushiSwap sur Ethereum. »
• « Récupère les données OHLCV horaires du dernier jour pour SOL/USDC sur Raydium et trace un graphique des prix. »
• « Trouve les 5 pools les plus liquides sur le réseau Fantom et analyse leurs structures de frais. »
• « Récupère les transactions récentes du pool ETH/USDT sur Uniswap et analyse la pression acheteuse par rapport à la pression vendeuse. »
• « Affiche les 10 principaux pools sur Ethereum par volume sur 24 h. »
• « Recherche tous les pools contenant le token ARB et classe-les par volume. »
• « Filtre les pools Ethereum dont le volume sur 24 h dépasse 100 000 $ et qui ont été créés au cours de la dernière semaine. »
• « Commence par récupérer tous les réseaux disponibles, puis affiche les principaux pools de chaque grand réseau. »

Limites de débit et performances

• Offre gratuite : sans clé ni inscription, à 15 requêtes par minute. Une clé API gratuite porte cette limite à 30 requêtes par minute, augmente le quota mensuel et débloque le streaming : inscrivez-vous sur https://console.dexpaprika.com. L’offre Pro coûte 99 $/mois pour 500 requêtes par minute, et l’offre Dev coûte 30 $ pour 120 requêtes par minute. Une requête coûte un crédit ; les points de terminaison groupés coûtent un crédit par élément. Documentation complète sur https://docs.dexpaprika.com. Les quotas mensuels évoluent ; consultez-les ici plutôt que de vous fier à cette page : https://dexpaprika.com/api/pricing
• La pagination des résultats de recherche nécessite une clé : sur getNetworkPools, getDexPools, getNetworkPoolsFilter, getTokenPools, filterNetworkTokens et getTopTokens, la première page est accessible sans clé, mais l’utilisation de cursor pour récupérer une page suivante nécessite une clé API. Une clé gratuite permet de paginer sans limite.
• Délai des données : jusqu’à 60 secondes avec l’offre gratuite, en temps réel avec les offres payantes
• Nouveaux pools et tokens dans les résultats de recherche : sans offre Dev ou supérieure, getNetworkPools, getDexPools, getTokenPools, getNetworkPoolsFilter, getTopTokens et filterNetworkTokens excluent les pools et les tokens créés au cours de la dernière heure. Ainsi, une période created_after inférieure à une heure, ou les pools d’un token lancé au cours de la dernière heure, ne renverra aucun résultat. getPoolDetails et getTokenDetails renvoient des résultats quel que soit leur âge. Les clés Dev, Pro et Enterprise sur api-pro.dexpaprika.com les voient dès leur indexation. Détails : https://docs.dexpaprika.com/knowledge-base/rate-limits#search-freshness
• Temps de réponse : 100 à 500 ms pour la plupart des points de terminaison (selon le réseau)
• Gestion des erreurs : erreurs structurées avec codes, suggestions et conseils pour réessayer
• Disponibilité des données OHLCV : les données historiques sont généralement disponibles à partir de la date de création du token ou du pool

Dépannage

Problèmes courants :

• Limitation du débit : en cas d’erreurs DP429_RATE_LIMIT, mettez en place un délai exponentiel
• Données manquantes : l’historique de certains tokens ou pools récents peut être incomplet
• Erreurs de délai d’attente : les demandes de grandes quantités de données peuvent prendre plus de temps ; envisagez la pagination
• Erreurs réseau : vérifiez la connectivité réseau ; le service nécessite un accès à Internet
• Limites OHLCV : une requête renvoie jusqu’à 1 000 chandeliers (limit) ; pour couvrir une période plus longue, avancez start et relancez la requête. Sans clé, les données OHLCV couvrent les dernières 24 heures à 1h et au-delà (start: "-24h") ; une clé gratuite permet d’accéder à 7 jours à 10m et au-delà. Consultez Limites OHLCV selon l’offre
• Données OHLCV vides : le pool est peut-être trop récent. Utilisez plutôt getPoolTransactions

Développement

# Clone the repository
git clone https://github.com/coinpaprika/dexpaprika-mcp.git
cd dexpaprika-mcp

# Install dependencies
npm install

# Run with auto-restart on code changes
npm run watch

# Build for production
npm run build

# Run tests
npm test

Journal des modifications

Consultez CHANGELOG.md pour les notes de version détaillées et les guides de migration.

Licence

Ce projet est distribué sous licence MIT. Consultez le fichier LICENSE pour plus de détails.

Ressources supplémentaires

• Documentation de l’API DexPaprika
• Serveur MCP hébergé, option sans configuration
• Spécification du Model Context Protocol
• DexPaprika - Données complètes de marché pour l’analyse on-chain
• CoinPaprika - Données complètes sur le marché des cryptomonnaies