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 Server:為 AI Agent 提供即時 DEX 與加密貨幣資料

Model Context Protocol (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,不會綁定任何連接埠。啟動時會將 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 後,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 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"
    }
  }
}

可用工具(20 個)

此自架版本會註冊 20 個唯讀工具:19 個市場資料工具,另加 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 K 線資料network、pool_address、start
getPoolIndicator針對流動性池計算 RSI、EMA、MACD、布林通道或 VWAP,使用該池的 K 線資料在伺服器端計算。歷史資料與時間間隔的方案限制與 getPoolOHLCV 相同network、pool_address、indicator
getPoolTransactions流動性池的近期交易/成交紀錄network、pool_address

代幣操作

工具說明必要參數
getTokenDetails代幣詳細資訊network、token_address
getTokenPools包含指定代幣的流動性池(依網路篩選,results + 游標分頁;取得第一頁之後的頁面需要金鑰)network、token_address
getTokenOHLCV代幣的歷史 USD OHLCV K 線,依該代幣在所有交易池中的交易量加權。需在 api-pro.dexpaprika.com 使用 Dev 或 Pro 方案;無金鑰與免費金鑰會收到 403network、token_address、start
getTokenIndicator針對代幣在所有交易池中的 USD K 線計算相同指標。需在 api-pro.dexpaprika.com 使用 Dev 或 Pro 方案;無金鑰與免費金鑰會收到 403network、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 小時交易量超過 $100K,且在過去一週建立的流動性池。」
  • 「先取得所有可用網路,再顯示每個主要網路上流動性最高的流動性池。」

速率限制與效能

  • 免費方案:無需金鑰或註冊,每分鐘 15 個請求。免費 API 金鑰可將上限提高至每分鐘 30 個請求、提高每月額度並解鎖串流功能:請至 https://console.dexpaprika.com. 註冊。Pro 方案每月 $99,可每分鐘發出 500 個請求;另有每月 $30 的 Dev 方案,可每分鐘發出 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 根 K 線(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 檔案。

其他資源