DexPaprika

官方

通过DexPaprika API实时访问20多个区块链上的DEX分析数据,追踪500万+代币、池、交易量及历史市场数据。由CoinPaprika构建。

你可以用 DexPaprika MCP 做什么?

  • 代币查询 — 查询指定网络上代币的价格、交易量和流动性池,例如“分析 Solana 上的 JUP 代币。”
  • 流动性池发现与筛选 — 查找某个网络上的热门流动性池,或按 24 小时交易量、交易笔数或创建时间筛选。
  • DEX 对比 — 比较同一网络上不同 DEX 的交易量和可用流动性池,例如比较 Ethereum 上的 Uniswap V3 和 SushiSwap。
  • 历史 K 线与指标 — 获取流动性池的 OHLCV 历史数据,并在服务器端计算 RSI、EMA、MACD、布林带或 VWAP。
  • 交易活动 — 获取流动性池的近期交易,以查看买卖压力。
  • 跨网络搜索 — 在所有受支持的网络中,按名称、代号或地址搜索代币、流动性池和 DEX。

文档

DexPaprika MCP 服务器:为 AI 智能体提供实时 DEX 和加密货币数据

Model Context Protocol (MCP) 服务器,可按需访问 DexPaprika 的加密货币和 DEX 数据 API。专为 Claude 等 AI 助手打造,可通过编程方式获取最新的代币、流动性池和 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 安装

通过 Smithery 自动为 Claude Desktop 安装 DexPaprika:

npx -y smithery mcp add coinpaprika/dexpaprika

手动安装

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

# Start the server
dexpaprika-mcp

这是一个 stdio 服务器:它通过 stdin 和 stdout 使用 MCP 通信,不会绑定任何端口。启动时,它会将 DexPaprika MCP server v<version> (tool contract v<contract>) is running... 写入 stderr,然后等待客户端连接。请从 MCP 客户端(Claude Desktop、Cursor、Claude Code)运行它,不要期待在浏览器中打开一个 URL。

视频教程

观看我们的分步教程,了解如何设置和使用 DexPaprika MCP 服务器:

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 后,Claude 即可自动使用 DexPaprika 工具。

可选:使用 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 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"
    }
  }
}

可用工具(20 个)

此自托管版本注册了 20 个只读工具:19 个市场数据工具,以及 getKeyStatus。托管服务器 mcp.dexpaprika.com 注册了自己的一组工具,其中包括 submitFeedback。可通过实时的 tools/list 验证任一服务器。

发现

工具描述
getCapabilities服务器功能、工作流模式、网络别名和最佳实践。从这里开始。
getNetworks列出所有受支持的区块链网络(36 个)
getStats生态系统概览统计数据(网络、DEX、流动性池和代币总数)
search按名称、符号或地址搜索所有网络中的代币、流动性池和 DEX
getKeyStatus检查是否正在发送密钥,以及 API 识别到的套餐。不会读取市场数据。

DEX 操作

工具描述必需参数
getNetworkDexes列出指定网络上的 DEXnetwork

流动性池操作

工具描述必需参数
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代币的历史 USD OHLCV 蜡烛图数据,按交易量对其参与交易的所有流动性池进行加权。需要在 api-pro.dexpaprika.com 上使用 Dev 或 Pro 套餐;无密钥和免费密钥会收到 403network、token_address、start
getTokenIndicator代币在其参与交易的所有流动性池中的 USD 蜡烛图指标。需要在 api-pro.dexpaprika.com 上使用 Dev 或 Pro 套餐;无密钥和免费密钥会收到 403network、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 提示词示例

  • “分析 Solana 上的 JUP 代币。获取价格、交易量和流动性最高的流动性池。”
  • “比较 Ethereum 上 Uniswap V3 和 SushiSwap 的交易量。”
  • “获取 Raydium 上 SOL/USDC 过去一天的小时级 OHLCV 数据,并绘制价格图表。”
  • “找出 Fantom 网络上流动性最高的 5 个流动性池,并分析其费用结构。”
  • “获取 Uniswap 上 ETH/USDT 流动性池的近期交易记录,并分析买卖压力。”
  • “显示 Ethereum 上 24 小时交易量最高的 10 个流动性池。”
  • “搜索所有包含 ARB 代币的流动性池,并按交易量排序。”
  • “筛选 Ethereum 上过去一周创建且 24 小时交易量超过 10 万美元的流动性池。”
  • “先获取所有可用网络,再显示每个主要网络上流动性最高的流动性池。”

速率限制与性能

  • 免费套餐:无需密钥、无需注册,每分钟 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 不受数据年龄限制。使用 api-pro.dexpaprika.com 的 Dev、Pro 和 Enterprise 密钥可在这些数据完成索引后立即查看。详情:https://docs.dexpaprika.com/knowledge-base/rate-limits#search-freshness
  • 响应时间:大多数端点为 100–500 毫秒(取决于网络)
  • 错误处理:提供结构化错误信息,包括错误代码、建议和重试指导
  • OHLCV 数据可用性:历史数据通常从代币或流动性池创建之日起提供

故障排除

常见问题:

  • 速率限制:如果收到 DP429_RATE_LIMIT 错误,请实施指数退避
  • 数据缺失:某些较新的代币或流动性池可能缺少部分历史数据
  • 超时错误:大型数据请求可能需要更长时间,请考虑使用分页
  • 网络错误:检查网络连接;此服务需要互联网访问
  • OHLCV 限制:单个请求最多返回 1000 根蜡烛图(limit);如需更长时间范围,请向前移动 start 后再次请求。无密钥时,OHLCV 数据在 1h 下覆盖最近 24 小时,在更长的 start: "-24h" 下也可用;免费密钥可在 10m 下获取最近 7 天的数据,也可使用更长的时间范围。请参阅各套餐的 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 授权,详情请参阅 LICENSE 文件。

其他资源