DexScan 技能说明#

目录结构#

text

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 导出的方法实现：

javascript

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 工作目录下，格式示例：

text

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 不为空时，必须按各模块文档定义的默认字段输出，不可省略；用户要求详细信息时输出完整字段

接口选择指引#

代币接口#

接口名称用户意图推荐接口代币排行按时间粒度分页查询代币排行榜，支持成交额、流动性、涨跌幅、市值、交易笔数、持币地址数等多维过滤与排序queryCoinRankPage代币详情查代币详细信息，包含代币名称、代币符号、创建者、流动性、代币价格、代币市值、总供应量、代币24h交易量、代币24h交易额queryCoinInfo代币信号列表查询24小时信号，支持游标分页，每页返回20条，含代币价格、市值、信号评分、首次信号最大涨幅queryCoinSignalScroll信号排行榜查询24小时信号排行榜 TOP10，基于首次信号最大涨幅降序，最新信号推送时间降序queryCoinSignalRank开发者代币列表查某代币的开发者创建的代币queryCoinDeveloperScroll代币搜索通过关键字搜索代币或者地址queryCoinSearch社媒热度排行社媒热度列表，含热度贡献 Top5 KOL、买入 Top5 KOL、24h 价格走势及推文 AI 总结queryCoinHeatPageMeme币排行查询meme币新创建、带发射、已发射的代币列表queryCoinMemeRankMeme支持的DEX列表查Meme支持的DEX列表queryCoinMemeDexs推文热度查询指定推文 ID 的热度数据，包含浏览、回复、转发、点赞、热度贡献值queryCoinTwitterTweetsHeat

行情接口#

接口名称用户意图推荐接口交易活动列表游标分页查询指定代币的链上交易记录，返回买卖方向、交易金额、地址标签（KOL/DEV/TOP10等）及交易时间queryMarketTradeScroll流动性变化列表游标分页查询指定代币的流动性增减事件，返回添加/移除流动性的金额、LP地址及操作时间/移除记录queryMarketLiquidScroll代币盈利列表查询指定代币的持有者盈亏统计，返回各地址的买入成本、当前市值、已实现/未实现盈亏数据queryMarketPnlCoinList代币近期统计信息查询代币各时间周期（5m/1h/4h/24h）的近期行情概要，包括价格、涨跌幅、成交量及 KOL 交易统计queryMarketCoinSummaryK线历史数据查询代币指定时间粒度（1m/5m/1h/1d等）的K线历史数据，返回开高低收及成交量序列queryMarketKlineHistorical代币流动性池子列表查询代币流动性最高的前20个池子，返回所属DEX、配对代币、流动性金额及24小时交易量queryMarketPoolTop

地址接口#

接口名称用户意图推荐接口地址交易历史游标分页查询指定地址的链上交易记录，返回代币名称、买卖方向、交易金额、盈亏及交易时间queryAddressTradeScroll地址盈亏分析列表分页查询指定地址持有的代币盈亏情况，返回买入均价、持仓量、已实现盈亏、未实现盈亏及盈亏比例queryAddressPnlPage地址资产组合列表分页查询指定地址当前持有的代币资产，按持仓市值降序返回代币名称、数量、均价及当前价值queryAddressAssetTop地址开发者代币列表分页查询指定开发者地址曾发行的代币列表，返回代币名称、发行时间、当前价格及涨跌幅queryAddressDeveloperPage聪明钱/牛人榜分页查询链上盈利能力排名靠前的地址，基于已实现盈亏、胜率等指标综合排序，返回地址标签、交易统计及盈亏数据queryAddressRankPage

模块接口文档#

• 代币接口：详见 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）