DexPaprika
官方通过DexPaprika API实时访问20多个区块链上的DEX分析数据,追踪500万+代币、池、交易量及历史市场数据。由CoinPaprika构建。
你可以用 DexPaprika MCP 做什么?
让您的助手拉取实时DEX数据,比较流动性池,并分析36条区块链上的代币表现。
- 发现网络与统计 — 通过
getNetworks和getStats列出支持的区块链或生态系统总量。 - 搜索一切 — 使用
search按名称、符号或地址查找代币、流动性池或DEX。 - 顶级流动性池与筛选 — 通过
getNetworkPools获取某网络上的顶级流动性池,或通过getNetworkPoolsFilter按交易量和创建时间筛选。 - 代币深入分析 — 使用
getTokenDetails、getTokenPools和getTokenMultiPrices获取代币详情、流动性池和批量价格。 - OHLCV与交易 — 通过
getPoolOHLCV拉取历史K线,或通过getPoolTransactions获取近期交易。
文档
DexPaprika MCP Server
一个模型上下文协议(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 通信,不绑定任何端口。启动时它会向 stderr 写入 DexPaprika MCP server v<version> (tool contract v<contract>) is running...,然后等待客户端连接。请从 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 后,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 实际看到的套餐 并在密钥未生效时指出可能的原因。 - Pro 客户还需设置
DEXPAPRIKA_API_BASE_URL为https://api-pro.dexpaprika.com。主机不会自动更改, 因为将免费密钥发送到该主机会返回 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"
}
}
}
可用工具(17 个)
此自托管构建注册了 17 个只读工具:16 个市场数据工具外加 getKeyStatus。mcp.dexpaprika.com 上的托管服务器注册了自己的工具集,包括 submitFeedback。可通过实时的 tools/list 验证任一服务器。
发现
| 工具 | 描述 |
|---|---|
getCapabilities | 服务器能力、工作流模式、网络同义词和最佳实践。从这里开始。 |
getNetworks | 列出所有受支持的区块链网络(36 个) |
getStats | 高层生态系统统计(网络、DEX、池、代币总数) |
search | 按名称、符号或地址在 ALL 网络上搜索代币、池和 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 |
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: 1710806400,
sort_by: "volume_usd_24h",
limit: 20
});
// Get historical price data:
const ohlcvData = await getPoolOHLCV({
network: "ethereum",
pool_address: "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
start: "2023-01-01",
interval: "24h",
limit: 30
});
// Batch prices for multiple tokens (max 10):
const prices = await getTokenMultiPrices({
network: "ethereum",
tokens: [
"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"0xdac17f958d2ee523a2206206994597c13d831ec7"
]
});
可供 Claude 使用的示例提示
- "分析 Solana 上的 JUP 代币。获取价格、交易量和顶级流动性池。"
- "比较 Uniswap V3 和 SushiSwap 在以太坊上的交易量。"
- "获取 Raydium 上 SOL/USDC 的 7 天 OHLCV 数据并绘制价格图表。"
- "查找 Fantom 网络上按流动性排名前 5 的池并分析其费用结构。"
- "获取 Uniswap 上 ETH/USDT 池的近期交易并分析买入与卖出的压力。"
- "向我展示以太坊上按 24 小时交易量排名前 10 的池。"
- "搜索所有包含 ARB 代币的池并按交易量排序。"
- "筛选过去一周内创建且 24 小时交易量超过 10 万美元的以太坊池。"
- "首先获取所有可用网络,然后展示每个主要网络上排名靠前的池。"
速率限制与性能
- 免费套餐:无需密钥、无需注册,每分钟 30 次请求。免费 API 密钥可提高月度配额并解锁流式传输。Pro 套餐每月 $99,每分钟 300 次请求。一次请求消耗一个积分;批量端点每项消耗一个积分。月度配额会变化,请从这里而非本页面读取最新值:https://dexpaprika.com/api/pricing
- 数据延迟:免费套餐最长 15 秒,Pro 套餐实时
- 响应时间:大多数端点为 100-500ms(取决于网络)
- 错误处理:结构化错误,包含代码、建议和重试指导
- OHLCV 数据可用性:历史数据通常从代币/池创建日期开始可用
故障排查
常见问题:
- 速率限制:如果收到
DP429_RATE_LIMIT错误,请实施指数退避 - 数据缺失:一些较新的代币/池可能没有完整的历史数据
- 超时错误:大数据请求可能耗时较长,请考虑使用分页
- 网络错误:检查网络连接,该服务需要互联网访问
- OHLCV 限制:开始和结束日期之间的最大范围为 1 年;更长时间范围请使用分页
- 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 文件。
其他资源
- DexPaprika API 文档
- 托管 MCP 服务器,零配置选项
- 模型上下文协议规范
- DexPaprika — 全面的链上分析市场数据
- CoinPaprika — 全面的加密货币市场数据
