前言¶
在开发 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 密钥一旦设置，会自动保存在本地，无需重复输入。
