DexPaprika

官方

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

你可以用 DexPaprika MCP 做什么?

让您的助手拉取实时DEX数据,比较流动性池,并分析36条区块链上的代币表现。

  • 发现网络与统计 — 通过getNetworksgetStats列出支持的区块链或生态系统总量。
  • 搜索一切 — 使用search按名称、符号或地址查找代币、流动性池或DEX。
  • 顶级流动性池与筛选 — 通过getNetworkPools获取某网络上的顶级流动性池,或通过getNetworkPoolsFilter按交易量和创建时间筛选。
  • 代币深入分析 — 使用getTokenDetailsgetTokenPoolsgetTokenMultiPrices获取代币详情、流动性池和批量价格。
  • OHLCV与交易 — 通过getPoolOHLCV拉取历史K线,或通过getPoolTransactions获取近期交易。

文档

DexPaprika MCP Server

smithery badge

一个模型上下文协议(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 服务器的分步教程:

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_URLhttps://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 个市场数据工具外加 getKeyStatusmcp.dexpaprika.com 上的托管服务器注册了自己的工具集,包括 submitFeedback。可通过实时的 tools/list 验证任一服务器。

发现

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

DEX 操作

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

池操作

工具描述必需参数
getNetworkPools主要。获取网络上的顶级流动性池network
getDexPools从特定 DEX 获取池(results 下的行,游标分页)networkdex
getNetworkPoolsFilter按交易量、交易数、创建时间筛选池network
getPoolDetails详细池信息(价格、交易量、TVL、代币)networkpool_address
getPoolOHLCV历史 OHLCV 蜡烛数据networkpool_addressstart
getPoolTransactions池的近期交易/买卖记录networkpool_address

代币操作

工具描述必需参数
getTokenDetails详细代币信息networktoken_address
getTokenPools包含某个代币的流动性池(网络范围筛选,results + 游标分页)networktoken_address
getTokenMultiPrices最多 10 个代币的批量价格networktokens[]
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 文件。

其他资源