DexPaprika
官方透過 DexPaprika API 存取 20 多條區塊鏈的即時 DEX 分析資料,追蹤超過 500 萬種代幣、流動性池、交易量及歷史市場數據。由 CoinPaprika 打造。
你可以用 DexPaprika MCP 做什麼?
讓您的助手提取即時DEX數據、比較流動性池,並分析36條區塊鏈上的代幣表現。
- 探索網絡與統計 — 通過
getNetworks和getStats列出支持的區塊鏈或生態系統總計。 - 搜索一切 — 使用
search按名稱、符號或地址查找代幣、流動性池或DEX。 - 頂級流動性池與篩選 — 使用
getNetworkPools獲取網絡上的頂級流動性池,或通過getNetworkPoolsFilter按交易量和年齡篩選。 - 代幣深入分析 — 使用
getTokenDetails、getTokenPools和getTokenMultiPrices獲取代幣詳細信息、流動性池和批量價格。 - OHLCV與交易 — 使用
getPoolOHLCV拉取歷史K線,或使用getPoolTransactions獲取近期交易。
文件
DexPaprika MCP 伺服器
一個模型上下文協定(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 伺服器的逐步教學影片:
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 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"
}
}
}
可用工具(17 個)
此自架版本註冊了 17 個唯讀工具:16 個市場資料工具加 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 蠟燭圖資料 | 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: 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 檔案。
其他資源
- DexPaprika API 文件
- 託管 MCP 伺服器,零設定選項
- 模型上下文協定規格
- DexPaprika - 全面的鏈上分析市場資料
- CoinPaprika - 全面的加密貨幣市場資料
