DexPaprika

официальный

Получайте доступ к аналитике DEX в реальном времени на 20+ блокчейнах через API DexPaprika, отслеживая 5M+ токенов, пулов, объемов и исторических рыночных данных. Создано CoinPaprika.

Что можно делать с DexPaprika MCP?

  • Discover supported networks — Запросите список всех 36 блокчейн-сетей, поддерживаемых DexPaprika, через getNetworks.
  • Analyze top liquidity pools — Запросите топ-пулы в сети, отсортированные по объему или ликвидности, с помощью getNetworkPools.
  • Track token prices in batch — Получите текущие цены до 10 токенов одновременно в сети с помощью getTokenMultiPrices.
  • Fetch historical OHLCV data — Получите данные свечей за час или день для пула, чтобы проанализировать ценовые тренды, через getPoolOHLCV.
  • Filter pools by criteria — Найдите пулы, соответствующие порогам объема, транзакций или времени создания, с помощью getNetworkPoolsFilter.
  • Search across all networks — Найдите токены, пулы или DEX по имени, символу или адресу с помощью search.

Документация

Сервер MCP DexPaprika

smithery badge

Сервер Model Context Protocol (MCP), который обеспечивает доступ по запросу к API данных о криптовалютах и DEX от DexPaprika. Создан специально для ИИ-ассистентов, таких как Claude, для программного получения актуальных данных о токенах, пулах и DEX без какой-либо настройки.

TL;DR

# Install globally
npm install -g dexpaprika-mcp

# Start the server
dexpaprika-mcp

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

DexPaprika MCP подключает Claude к живым данным DEX в нескольких блокчейнах. Для начала работы на бесплатном тарифе не требуется API-ключ. Установка | Конфигурация | Справочник API

Предпочитаете нулевую настройку? Используйте размещенный MCP-сервер на mcp.dexpaprika.com: без установки, без ключа для начала работы, те же инструменты данных плюс submitFeedback. См. Размещенный сервер для транспортных конечных точек.

Последний релиз

См. CHANGELOG.md для примечаний к выпуску и руководств по миграции.

Что можно создать?

  • Инструменты анализа токенов: Отслеживание движения цен, изменений глубины ликвидности и моделей объема
  • Сравнение DEX: Анализ структур комиссий, объема и доступных пулов на разных DEX
  • Аналитика пулов ликвидности: Мониторинг изменений TVL, расчеты непостоянных потерь и оценка ценового воздействия
  • Анализ рынка: Сравнение токенов между сетями, тенденции объема и метрики торговой активности
  • Отслеживание портфеля: Отслеживание текущей стоимости, анализ исторической производительности, возможности доходности
  • Технический анализ: Выполнение расширенного технического анализа с использованием исторических данных OHLCV, включая определение тенденций, распознавание паттернов и расчет индикаторов

Установка

Установка через Smithery

Чтобы автоматически установить DexPaprika для Claude Desktop через Smithery:

npx -y smithery mcp add coinpaprika/dexpaprika

Ручная установка

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

# Start the server
dexpaprika-mcp

Это stdio-сервер: он общается через MCP по stdin и stdout и не привязывает порт. При запуске он записывает DexPaprika MCP server v<version> (tool contract v<contract>) is running... в stderr, а затем ожидает клиента. Запускайте его из MCP-клиента (Claude Desktop, Cursor, Claude Code), а не ожидайте URL в браузере.

Видеоурок

Посмотрите наш пошаговый урок по настройке и использованию сервера MCP DexPaprika:

DexPaprika MCP Tutorial

Интеграция с Claude Desktop

Добавьте следующее в файл конфигурации 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"]
    }
  }
}

После перезапуска Claude Desktop инструменты DexPaprika будут автоматически доступны Claude.

Необязательно: использование API-ключа

Это работает без ключа и будет работать всегда. Никакой регистрации, никакой карты, ничего настраивать не нужно. Все вышеперечисленное — поддерживаемый способ запуска.

Бесплатный ключ повышает месячный лимит и открывает стриминг для любого токена, а не только для публичного демонстрационного набора. Он не повышает лимит запросов в минуту, который одинаков на обоих тарифах. Получите ключ на console.dexpaprika.com; текущие лимиты указаны на странице лимитов.

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

Ключ вставляется сам по себе. Никакого префикса Bearer нет, как и других служебных слов. Вставьте ключ точно так, как он выдан. Почти все остальные API требуют противоположного, поэтому это самая распространенная причина, по которой рабочий ключ выглядит сломанным.

Две вещи, которые стоит знать:

  • Ключ, который мы не можем прочитать, не вызывает ошибку. Конечные точки данных игнорируют нечитаемый ключ и обслуживают вас как анонимного пользователя, с обычным 200 и реальными данными, поэтому опечатка выглядит точно так же, как успех. Попросите ассистента выполнить getKeyStatus после установки ключа: он сообщит, какой план видит API, и назовет вероятную причину, если ключ не применяется.
  • Корпоративные клиенты дополнительно устанавливают DEXPAPRIKA_API_BASE_URL на https://api-pro.dexpaprika.com. Хост не меняется автоматически, потому что отправка бесплатного ключа на этот хост возвращает 403.

Размещенный сервер (без установки)

Если вы предпочитаете нулевую настройку, укажите любой MCP-совместимый клиент напрямую на размещенный сервер по адресу mcp.dexpaprika.com. Целевая страница содержит инструкции по настройке и документацию. Доступны следующие транспортные конечные точки:

ТранспортКонечная точкаВариант использования
Streamable HTTPhttps://mcp.dexpaprika.com/streamable-httpРекомендуется для большинства клиентов
SSEhttps://mcp.dexpaprika.com/sseУстаревший транспорт SSE
JSON-RPChttps://mcp.dexpaprika.com/json-rpcПрямой JSON-RPC

Примечание: Это конечные точки протокола MCP. Они не будут отображаться в браузере. Посетите mcp.dexpaprika.com для целевой страницы.

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

Доступные инструменты (17)

Эта сборка для самостоятельного размещения регистрирует 17 инструментов чтения: 16 инструментов рыночных данных плюс getKeyStatus. Размещенный сервер на mcp.dexpaprika.com регистрирует свой собственный набор, включая submitFeedback. Проверьте любой из них с помощью живого tools/list.

Обнаружение

ИнструментОписание
getCapabilitiesВозможности сервера, шаблоны рабочих процессов, синонимы сетей и лучшие практики. Начните здесь.
getNetworksСписок всех поддерживаемых блокчейн-сетей (36)
getStatsВысокоуровневая статистика экосистемы (всего сетей, DEX, пулов, токенов)
searchПоиск токенов, пулов и DEX по ВСЕМ сетям по имени, символу или адресу
getKeyStatusОтправляется ли ключ и какой план видит API. Не читает рыночные данные.

Операции с DEX

ИнструментОписаниеОбязательные параметры
getNetworkDexesСписок DEX в конкретной сетиnetwork

Операции с пулами

ИнструментОписаниеОбязательные параметры
getNetworkPoolsОСНОВНОЙ. Получить пулы с наибольшей ликвидностью в сетиnetwork
getDexPoolsПолучить пулы конкретного DEX (строки под results, курсорная пагинация)network, dex
getNetworkPoolsFilterФильтрация пулов по объему, транзакциям, времени созданияnetwork
getPoolDetailsПодробная информация о пуле (цена, объем, TVL, токены)network, pool_address
getPoolOHLCVИсторические данные свечей OHLCVnetwork, pool_address, start
getPoolTransactionsНедавние транзакции/сделки для пулаnetwork, pool_address

Операции с токенами

ИнструментОписаниеОбязательные параметры
getTokenDetailsПодробная информация о токенеnetwork, token_address
getTokenPoolsПулы ликвидности, содержащие токен (фильтр по сети, results + курсорная пагинация)network, token_address
getTokenMultiPricesПакетные цены до 10 токеновnetwork, tokens[]
getTopTokensЛучшие токены в сети по объему, ликвидности, FDV или изменению цены за 24 часаnetwork
filterNetworkTokensФильтрация токенов по объему, ликвидности, FDV, транзакциям и времени созданияnetwork

Пример использования

// 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):
const jupiterPools = await getTokenPools({
  network: "solana",
  token_address: "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN",
  order_by: "volume_usd_24h",
  limit: 5
});

// Get top pools on Ethereum (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:
const ohlcvData = await getPoolOHLCV({
  network: "ethereum",
  pool_address: "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
  start: "-24h",     // last 24 hours; works without a key
  interval: "1h",
  limit: 24
});

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

Примеры запросов для Claude

  • «Проанализируй токен JUP в Solana. Получи цену, объем и лучшие пулы ликвидности.»
  • «Сравни торговый объем между Uniswap V3 и SushiSwap в Ethereum.»
  • «Получи часовые OHLCV за последний день для SOL/USDC на Raydium и построй график цен.»
  • «Найди топ-5 пулов по ликвидности в сети Fantom и проанализируй их структуры комиссий.»
  • «Получи недавние транзакции для пула ETH/USDT на Uniswap и проанализируй давление покупок и продаж.»
  • «Покажи топ-10 пулов в Ethereum по объему за 24 часа.»
  • «Найди все пулы, содержащие токен ARB, и ранжируй их по объему.»
  • «Отфильтруй пулы Ethereum с объемом за 24 часа >$100K, созданные за последнюю неделю.»
  • «Сначала получи все доступные сети, затем покажи лучшие пулы в каждой крупной сети.»

Лимиты и производительность

  • Бесплатный тариф: без ключа, без регистрации, 15 запросов в минуту. Бесплатный API-ключ повышает это до 30 запросов в минуту, повышает месячную квоту и открывает стриминг: зарегистрируйтесь на https://console.dexpaprika.com. Pro стоит $99/месяц при 500 запросах в минуту, также есть план Dev за $30 при 120. Один запрос стоит один кредит; пакетные конечные точки стоят один кредит за элемент. Полная документация на https://docs.dexpaprika.com. Месячные квоты меняются, поэтому читайте их здесь, а не с этой страницы: https://dexpaprika.com/api/pricing
  • Задержка данных: до 60 секунд на бесплатном тарифе, в реальном времени на платных планах
  • Время ответа: 100-500 мс для большинства конечных точек (зависит от сети)
  • Обработка ошибок: Структурированные ошибки с кодами, предложениями и рекомендациями по повторным попыткам
  • Доступность данных OHLCV: Исторические данные обычно доступны с даты создания токена/пула

Устранение неполадок

Распространенные проблемы:

  • Ограничение скорости: При получении ошибок DP429_RATE_LIMIT используйте экспоненциальную задержку
  • Отсутствующие данные: Некоторые новые токены/пулы могут иметь неполные исторические данные
  • Ошибки тайм-аута: Большие запросы данных могут занять больше времени, рассмотрите пагинацию
  • Сетевые ошибки: Проверьте сетевое подключение, сервису требуется доступ в интернет
  • Ограничения OHLCV: Один запрос возвращает до 1000 свечей (limit); для более длинного периода переместите start вперед и запросите снова. Без ключа OHLCV покрывает последние 24 часа на 1h и дольше (start: "-24h"); бесплатный ключ открывает 7 дней на 10m и дольше. См. Лимиты OHLCV по планам
  • Пустой OHLCV: Пул может быть слишком новым. Используйте getPoolTransactions вместо этого

Разработка

# 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

Журнал изменений

См. CHANGELOG.md для подробных примечаний к выпуску и руководств по миграции.

Лицензия

Этот проект лицензирован по лицензии MIT — см. файл LICENSE для подробностей.

Дополнительные ресурсы