前言¶
在開發 DSH 智能體時，獲取外部數據通常需要手動處理接口調用和認證。下面介紹 xby-cryptocurrency-data-api-service 插件，它直接對接 DexPaprika，爲 AI 助手提供實時加密貨幣和 DEX 數據訪問能力。
插件定位¶
這是一個由 xby-skill 維護的聯網工具類插件。它將 DexPaprika MCP Server 封裝進 DSH，解決了智能體無法直接查詢區塊鏈流動池、代幣信息和 DEX 統計數據的痛點。
核心能力¶
該插件提供以下數據訪問能力：
- API 密鑰管理：支持在聊天中通過
set_xby_apikey設置密鑰，系統會自動持久化，重啓後依然有效。 - 網絡查詢：獲取所有支持的區塊鏈網絡 ID。
- DEX 查詢：獲取特定網絡的 DEX 列表，或獲取特定 DEX 下的池子。
- 池子查詢：獲取特定網絡的頂級流動性池，或獲取特定池子的詳細信息。
- 代幣查詢：獲取特定代幣的詳細信息，或查找包含該代幣的流動性池。
- 歷史與交易數據：獲取池子的歷史價格數據（OHLCV）和最近交易記錄。
- 跨網絡搜索：支持跨所有網絡搜索代幣、池子和 DEX。
- 生態統計：獲取 DexPaprika 生態系統的統計數據。
- 批量價格：獲取特定網絡上多個代幣的批量價格。
安裝與啓用¶
使用官方安裝命令將插件添加到 DSH：
dsh plugin --profile web add github:xby_skill/xby-cryptocurrency-data-api-service
典型用法¶
使用該插件前，需先完成 API 密鑰的配置：
- 在聊天中調用
set_xby_apikey，輸入從小笨羊官網獲取的密鑰。 - 調用
getNetworks獲取支持的區塊鏈網絡列表（這是使用網絡特定功能的前提）。 - 使用
getNetworkPools獲取特定網絡下的頂級流動性池。 - 使用
getPoolDetails獲取池子的詳細參數。 - 使用
getPoolOHLCV獲取池子的歷史價格數據用於分析。
注意事項¶
- 密鑰要求：必須從小笨羊官網註冊並獲取 API 密鑰才能使用。
- 調用順序：部分功能（如
getPoolDetails）需要先調用getNetworks獲取有效的網絡 ID。 - 持久化：API 密鑰一旦設置，會自動保存在本地，無需重複輸入。
