DexPaprika

официальный

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

GitHub

120

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

Поиск токена — Узнайте цену токена, его объём торгов и пулы ликвидности в выбранной сети, например: «Проанализируй токен JUP в Solana».
Поиск и фильтрация пулов — Найдите лучшие пулы в сети или отфильтруйте их по объёму торгов за 24 часа, числу транзакций или времени создания.
Сравнение DEX — Сравните объём торгов и доступные пулы на разных DEX в одной сети, например Uniswap V3 и SushiSwap в Ethereum.
Исторические свечи и индикаторы — Получите историю OHLCV пула и вычислите на сервере RSI, EMA, MACD, полосы Боллинджера или VWAP.
Торговая активность — Получите последние транзакции пула, чтобы оценить давление покупателей и продавцов.
Поиск в разных сетях — Ищите токены, пулы и DEX по названию, символу или адресу во всех поддерживаемых сетях.

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

MCP-сервер DexPaprika: данные DEX и криптовалют в реальном времени для ИИ-агентов

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

Кратко

# 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:

Интеграция с 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"
      }
    }
  }
}

Ключ нужно указывать отдельно, как полное значение Authorization. Вставьте его в точности так, как он был выдан, ничего не добавляя перед ним. Почти все остальные API требуют добавлять что-либо перед ключом, поэтому именно эта ошибка чаще всего приводит к тому, что рабочий ключ кажется неисправным.

Полезно знать две вещи:

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

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

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

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

Примечание: это конечные точки протокола MCP. В браузере они ничего не отображают. Главная страница находится по адресу mcp.dexpaprika.com.

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

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

Эта сборка для самостоятельного размещения регистрирует 20 инструментов чтения: 19 инструментов для работы с рыночными данными и 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`	Исторические данные свечей OHLCV	`network`, `pool_address`, `start`
`getPoolIndicator`	RSI, EMA, MACD, полосы Боллинджера или VWAP для пула; расчёт на сервере по его свечам. Ограничения тарифа на историю и интервал такие же, как у `getPoolOHLCV`	`network`, `pool_address`, `indicator`
`getPoolTransactions`	Недавние транзакции/сделки пула	`network`, `pool_address`

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

Инструмент	Описание	Обязательные параметры
`getTokenDetails`	Подробная информация о токене	`network`, `token_address`
`getTokenPools`	Пулы ликвидности с указанным токеном (фильтр по сети, `results` + постраничная навигация с курсором; для перехода дальше первой страницы нужен ключ)	`network`, `token_address`
`getTokenOHLCV`	Исторические свечи OHLCV в USD для токена, взвешенные по объёму во всех пулах, где он торгуется. Требуется тариф Dev или Pro на `api-pro.dexpaprika.com`; без ключа и с бесплатным ключом возвращается ошибка 403	`network`, `token_address`, `start`
`getTokenIndicator`	Те же индикаторы для свечей токена в USD во всех пулах, где он торгуется. Требуется тариф Dev или Pro на `api-pro.dexpaprika.com`; без ключа и с бесплатным ключом возвращается ошибка 403	`network`, `token_address`, `indicator`
`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). 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"
  ]
});

Примеры запросов для 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
Для постраничного просмотра результатов поиска нужен ключ: в getNetworkPools, getDexPools, getNetworkPoolsFilter, getTokenPools, filterNetworkTokens и getTopTokens первая страница доступна без ключа, но для получения следующих страниц с помощью cursor нужен API-ключ. Бесплатный ключ позволяет просматривать страницы без ограничений.
Задержка данных: до 60 секунд на бесплатном тарифе, данные в реальном времени на платных тарифах
Новые пулы и токены в поиске: без тарифа Dev или выше getNetworkPools, getDexPools, getTokenPools, getNetworkPoolsFilter, getTopTokens и filterNetworkTokens не включают пулы и токены, созданные за последний час. Поэтому результаты для периода created_after короче часа или для пулов токена, запущенного за последний час, будут пустыми. getPoolDetails и getTokenDetails возвращают данные независимо от возраста. Ключи Dev, Pro и Enterprise на api-pro.dexpaprika.com позволяют видеть данные сразу после индексации. Подробнее: https://docs.dexpaprika.com/knowledge-base/rate-limits#search-freshness
Время ответа: 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.

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

Документация API DexPaprika
Размещённый MCP-сервер, вариант без настройки
Спецификация Model Context Protocol
DexPaprika — комплексные рыночные данные для аналитики ончейн-активности
CoinPaprika — комплексные рыночные данные о криптовалютах