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 伺服器:
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 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"
}
}
}
可用工具(20 個)
此自架版本會註冊 20 個唯讀工具:19 個市場資料工具,另加 getKeyStatus。位於 mcp.dexpaprika.com 的託管伺服器會註冊自己的工具組合,其中包含 submitFeedback。請使用即時的 tools/list 驗證任一伺服器。
探索
| 工具 | 說明 |
|---|---|
getCapabilities | 伺服器功能、工作流程模式、網路別名與最佳實務。請從這裡開始。 |
getNetworks | 列出所有支援的區塊鏈網路(36 個) |
getStats | 生態系統概況統計(網路、DEX、流動性池與代幣總數) |
search | 依名稱、代號或地址搜尋所有網路上的代幣、流動性池與 DEX |
getKeyStatus | 是否正在傳送金鑰,以及 API 辨識到的方案。不會讀取市場資料。 |
DEX 操作
| 工具 | 說明 | 必要參數 |
|---|---|---|
getNetworkDexes | 列出指定網路上的 DEX | network |
流動性池操作
| 工具 | 說明 | 必要參數 |
|---|---|---|
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 方案;無金鑰與免費金鑰會收到 403 | network、token_address、start |
getTokenIndicator | 針對代幣在所有交易池中的 USD K 線計算相同指標。需在 api-pro.dexpaprika.com 使用 Dev 或 Pro 方案;無金鑰與免費金鑰會收到 403 | network、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 檔案。
其他資源
- DexPaprika API 文件
- 託管 MCP 伺服器:免設定選項
- Model Context Protocol 規格
- DexPaprika:全面的鏈上分析市場資料
- CoinPaprika:全面的加密貨幣市場資料
