DexPaprika

官方

透過 DexPaprika API 存取 20 多條區塊鏈的即時 DEX 分析資料,追蹤超過 500 萬種代幣、流動性池、交易量及歷史市場數據。由 CoinPaprika 打造。

你可以用 DexPaprika MCP 做什麼?

讓您的助手提取即時DEX數據、比較流動性池,並分析36條區塊鏈上的代幣表現。

  • 探索網絡與統計 — 通過 getNetworksgetStats 列出支持的區塊鏈或生態系統總計。
  • 搜索一切 — 使用 search 按名稱、符號或地址查找代幣、流動性池或DEX。
  • 頂級流動性池與篩選 — 使用 getNetworkPools 獲取網絡上的頂級流動性池,或通過 getNetworkPoolsFilter 按交易量和年齡篩選。
  • 代幣深入分析 — 使用 getTokenDetailsgetTokenPoolsgetTokenMultiPrices 獲取代幣詳細信息、流動性池和批量價格。
  • OHLCV與交易 — 使用 getPoolOHLCV 拉取歷史K線,或使用 getPoolTransactions 獲取近期交易。

文件

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.dexpaprika.com 的託管 MCP 伺服器:無需安裝、無需金鑰即可開始,提供相同的資料工具,另加 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 伺服器:它透過標準輸入與標準輸出進行 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 後,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 下的資料列,游標分頁)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 代幣。取得價格、交易量與頂級流動性池。」
  • 「比較 Ethereum 上 Uniswap V3 與 SushiSwap 的交易量。」
  • 「取得 Raydium 上 SOL/USDC 的 7 天 OHLCV 資料並繪製價格圖表。」
  • 「找出 Fantom 網路上流動性最高的前 5 個流動性池,並分析其費用結構。」
  • 「取得 Uniswap 上 ETH/USDT 流動性池的近期交易,並分析買壓與賣壓。」
  • 「顯示 Ethereum 上 24 小時交易量前 10 名的流動性池。」
  • 「搜尋所有包含 ARB 代幣的流動性池,並依交易量排名。」
  • 「篩選過去一週建立、24 小時交易量超過 $100K 的 Ethereum 流動性池。」
  • 「先取得所有可用網路,然後顯示每個主要網路上的頂級流動性池。」

速率限制與效能

  • 免費方案:免金鑰、免註冊,每分鐘 30 次請求。免費 API 金鑰可提高每月配額並解鎖串流功能。Pro 為每月 $99 美元,每分鐘 300 次請求。一次請求消耗一個點數;批次端點每個項目消耗一個點數。每月配額會變動,請在此處閱讀最新資訊而非本頁:https://dexpaprika.com/api/pricing
  • 資料延遲:免費方案最多 15 秒,Pro 為即時
  • 回應時間:大多數端點為 100-500 毫秒(依網路而定)
  • 錯誤處理:結構化錯誤,附帶錯誤碼、建議與重試指引
  • 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 檔案。

其他資源