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 服务器:
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 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 | 代币的历史 USD OHLCV 蜡烛图数据,按交易量对其参与交易的所有流动性池进行加权。需要在 api-pro.dexpaprika.com 上使用 Dev 或 Pro 套餐;无密钥和免费密钥会收到 403 | network、token_address、start |
getTokenIndicator | 代币在其参与交易的所有流动性池中的 USD 蜡烛图指标。需要在 api-pro.dexpaprika.com 上使用 Dev 或 Pro 套餐;无密钥和免费密钥会收到 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 提示词示例
- “分析 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 文件。
其他资源
- DexPaprika API 文档
- 托管 MCP 服务器,零配置选项
- Model Context Protocol 规范
- DexPaprika - 全面的链上分析市场数据
- CoinPaprika - 全面的加密货币市场数据
