DexPaprika

官方

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

你可以用 DexPaprika MCP 做什么?

  • 发现支持的网络 — 通过 getNetworks 查询 DexPaprika 支持的全部 36 个区块链网络。
  • 分析顶级流动性池 — 使用 getNetworkPools 按交易量或流动性排名请求某网络上的顶级池。
  • 批量跟踪代币价格 — 通过 getTokenMultiPrices 一次获取某网络上最多 10 个代币的当前价格。
  • 获取历史 OHLCV 数据 — 使用 getPoolOHLCV 拉取池的每小时或每日蜡烛图数据以分析价格趋势。
  • 按条件筛选池 — 使用 getNetworkPoolsFilter 查找满足交易量、交易次数或创建时间阈值的池。
  • 跨所有网络搜索 — 通过 search 按名称、符号或地址定位代币、池或 DEX。

文档

DexPaprika MCP 服务器

smithery badge

一个模型上下文协议(MCP)服务器,提供对 DexPaprika 加密货币和 DEX 数据 API 的按需访问。专为 Claude 等 AI 助手构建,可零配置以编程方式获取当前代币、池和 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 安装

要自动通过 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 服务器的分步教程:

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 实际看到的计划,并在密钥未生效时指出可能的原因。
  • Pro 客户还需将 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列出特定网络上的 DEXnetwork

池操作

工具描述必需参数
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: "-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 示例提示

  • "分析 Solana 上的 JUP 代币。获取价格、成交量和顶级流动性池。"
  • "比较 Uniswap V3 和 SushiSwap 在以太坊上的交易量。"
  • "获取 Raydium 上 SOL/USDC 最近一天的小时级 OHLCV 并绘制价格图表。"
  • "查找 Fantom 网络上按流动性排名前 5 的池并分析其费用结构。"
  • "获取 Uniswap 上 ETH/USDT 池的近期交易并分析买入与卖出压力。"
  • "显示以太坊上按 24 小时成交量排名前 10 的池。"
  • "搜索所有包含 ARB 代币的池并按成交量排名。"
  • "筛选过去一周创建的 24 小时成交量超过 10 万美元的以太坊池。"
  • "首先获取所有可用网络,然后显示每个主要网络上的顶级池。"

速率限制与性能

  • 免费层级:无需密钥,无需注册,每分钟 15 次请求。免费 API 密钥可将此提高到每分钟 30 次请求,提高每月配额,并解锁流式传输:请在 https://console.dexpaprika.com. 注册。Pro 为每月 99 美元,每分钟 500 次请求,另有 30 美元的 Dev 计划,每分钟 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 文件。

其他资源