Dexscan Skill

DexScan 技能说明

目录结构

dexscan-skill/
├── SKILL.md              # 主技能文件（当前文件）
├── .env                  # API 密钥配置文件
├── scripts/
│   └── dexscan.js        # API 调用脚本（get/post封装+签名认证）
├── references/
│   ├── coin.md           # 代币接口文档
│   ├── address.md        # 地址接口文档
│   └── market.md         # 行情接口文档
└── assets/               # 资源文件目录

API 调用方式

所有 API 调用通过 scripts/dexscan.js 导出的方法实现：

const dexscan = require('./scripts/dexscan.js');
await dexscan.queryCoinRankPage({ chainName: 'SOL', bar: '1h', page: 1, pageSize: 20 });

认证机制

API 请求头包含签名认证：

• ACCESS-KEY：
  • .env 文件配置（最高优先级）：DS_ACCESS_KEY，未配置时使用环境变量
• ACCESS-TIMESTAMP：当前毫秒时间戳
• ACCESS-SIGN：HMAC-SHA256(ACCESS-KEY + ":" + ACCESS-TIMESTAMP) 的 Base64 编码

SECRET-KEY：

• .env 文件配置（最高优先级）：DS_SECRET_KEY，未配置时使用环境变量

.env 文件位于 skill 工作目录下，格式示例：

DS_ACCESS_KEY = "your_access_key_here"
DS_SECRET_KEY = "your_secret_key_here"

支持的链名称

必须使用以下链名称之一：SOL, BSC, Base, ETH, Polygon, Arbitrum, Optimism, Avalanche, Monad, SUI

通用行为规则

1. 语言：始终以用户提问的语言回复
2. 链名称：用户未指定链时默认使用 SOL；用户给出别称（如"以太坊"）时映射为对应链名（ETH）
3. 错误处理：API 返回 code !== 200 时，展示 msg 字段内容，不展示空数据
4. 时间字段格式化：响应数据中字段名含 time 或 date（不区分大小写）的字段，按客户端默认时区转换为 yyyy-MM-dd HH:mm:ss 展示；cursor 对象内的字段除外，保持原始值
5. 数值格式化：
   • 价格：小数位超过16位时保留16位小数，截断多余位数
   • 金额/市值：≥1B 显示为 xB，≥1M 显示为 xM，≥1K 显示为 xK
   • 涨跌幅/收益率：转为百分比，保留2位小数，正值加 + 前缀（如 +12.34%）
   • 胜率/比例：转为百分比，保留1位小数
6. 分页提示：响应包含 cursor 字段时提示"还有更多数据，如需继续请告知"；无 cursor 时提示"已显示全部数据"
7. 默认输出：data 不为空时，必须按各模块文档定义的默认字段输出，不可省略；用户要求详细信息时输出完整字段

接口选择指引

代币接口

行情接口

地址接口

模块接口文档

• 代币接口：详见 references/coin.md
  • 代币排行（rank-page）
  • 代币详情（info）
  • 代币信号列表（signal-scroll）
  • 代币信号排行榜（signal-rank）
  • 开发者代币列表（developer-scroll）
  • 搜索（search）
  • 社媒热度榜单（heat-page）
  • Meme代币排行（meme-rank）
  • Meme支持DEX列表（meme-dexs）
  • 推文热度数据（twitter-tweets-heat）
• 地址接口：详见 references/address.md
  • 地址盈亏分析（pnl-page）
  • 地址资产组合（asset-top）
  • 地址交易历史（trade-scroll）
  • 地址开发者代币（developer-page）
  • 牛人榜（rank-page）
• 行情接口：详见 references/market.md
  • 交易活动列表（trade-scroll）
  • 流动性变化列表（liquid-scroll）
  • 代币盈利列表（pnl-coin-list）
  • 代币近期统计（coin-summary）
  • K线历史数据（kline-historical）
  • 代币流动性池子列表（pool-top）