\r \r

DexScan 技能说明\r

\r

目录结构\r

\r

dexscan-skill/\r
├── SKILL.md              # 主技能文件（当前文件）\r
├── scripts/\r
│   └── dexscan.js        # API 调用脚本（get/post封装+签名认证）\r
├── references/\r
│   ├── signal.md         # 代币信号接口文档\r
│   ├── market.md         # 行情接口文档\r
│   ├── address.md        # 地址情况接口文档\r
│   ├── address-rank.md   # 地址牛人榜接口文档\r
│   └── heat.md           # 热度接口文档\r
└── assets/               # 资源文件目录\r
```\r
\r
## API 调用方式\r
\r
所有 API 调用通过 `scripts/dexscan.js` 导出的方法实现：\r
\r
```javascript\r
const dexscan = require('./scripts/dexscan.js');\r
\r
// 信号列表查询（游标分页）\r
await dexscan.querySignalList({ chainName: 'SOL' });\r
await dexscan.querySignalList({ chainName: 'SOL', cursor: { address: 'xxx', signalTime: 1234567890 } });\r
\r
// 信号排行榜查询\r
await dexscan.querySignalRank({ chainName: 'SOL' });\r
\r
// 行情模块 - 代币排行查询\r
await dexscan.queryCoinRank({ chainName: 'SOL', bar: '1h', page: 1, pageSize: 20 });\r
\r
// 行情模块 - 交易活动列表\r
await dexscan.queryTradeScroll({ chainName: 'SOL', tokenContractAddress: 'xxx' });\r
\r
// 地址情况模块 - 地址交易历史\r
await dexscan.queryAddressTradeScroll({ chainName: 'SOL', address: 'xxx' });\r
\r
// 地址情况模块 - 地址盈亏分析\r
await dexscan.queryAddressList({ chainName: 'SOL', address: 'xxx' });\r
```\r
\r
## 认证机制\r
\r
API 请求头包含签名认证：\r
- `ACCESS-KEY`：\r
  - 操作系统环境变量（最高优先级）：`DS_ACCESS_KEY`，环境变量未设置时使用公用默认配置（低频限制，仅适用于轻量体验）\r
- `ACCESS-TIMESTAMP`：当前毫秒时间戳\r
- `ACCESS-SIGN`：`HMAC-SHA256(ACCESS-KEY + ":" + ACCESS-TIMESTAMP)` 的 Base64 编码\r
\r
SECRET-KEY：\r
- 操作系统环境变量（最高优先级）：`DS_SECRET_KEY`，环境变量未设置时使用公用默认配置（低频限制，仅适用于轻量体验）\r
\r
## 支持的链名称\r
\r
必须使用以下链名称之一：`SOL, BSC, Base, ETH, Polygon, Arbitrum, Optimism, Avalanche, Monad, SUI`\r
\r
## 通用行为规则\r
\r
1. **语言**：始终以用户提问的语言回复\r
2. **链名称**：用户未指定链时默认使用 `SOL`；用户给出别称（如"以太坊"）时映射为对应链名（`ETH`）\r
3. **错误处理**：API 返回 `code !== 200` 时，展示 `msg` 字段内容，不展示空数据\r
4. **时间字段格式化**：响应数据中字段名含 `time` 或 `date`（不区分大小写）的字段，按客户端默认时区转换为 `yyyy-MM-dd HH:mm:ss` 展示；`cursor` 对象内的字段除外，保持原始值\r
5. **数值格式化**：\r
   - 价格：小数位超过16位时保留16位小数，截断多余位数\r
   - 金额/市值：`≥1B` 显示为 `xB`，`≥1M` 显示为 `xM`，`≥1K` 显示为 `xK`\r
   - 涨跌幅/收益率：转为百分比，保留2位小数，正值加 `+` 前缀（如 `+12.34%`）\r
   - 胜率/比例：转为百分比，保留1位小数\r
6. **分页提示**：响应包含 `cursor` 字段时提示"还有更多数据，如需继续请告知"；无 `cursor` 时提示"已显示全部数据"\r
7. **默认输出**：`data` 不为空时，必须按各模块文档定义的默认字段输出，不可省略；用户要求详细信息时输出完整字段\r
\r
## 接口选择指引\r
\r
| 用户意图 | 推荐接口 |\r
|----------|----------|\r
| 查代币信号/推送列表 | `querySignalList` |\r
| 查信号排行榜 | `querySignalRank` |\r
| 查代币行情排行 | `queryCoinRank` |\r
| 查代币详细信息、价格、市值、24h涨幅、24h成交额、符号、创建时间、流动性、持币地址数 | `queryCoinInfo` |\r
| 查代币近期统计 | `queryCoinSummary` |\r
| 查K线历史数据 | `queryKlineHistorical` |\r
| 查某代币的链上交易记录 | `queryTradeScroll` |\r
| 查某代币的流动性变化 | `queryLiquidScroll` |\r
| 查某代币的持仓盈亏 | `queryPnlCoinList` |\r
| 查开发者关联代币 | `queryDeveloperScroll` |\r
| 查Meme币排行 | `queryMemeRank` |\r
| 查Meme支持的DEX列表 | `queryMemeDexs` |\r
| 查某地址的交易历史 | `queryAddressTradeScroll` |\r
| 查某地址的盈亏分析 | `queryAddressList` |\r
| 查某地址的持仓资产 | `queryAddressAssetTop` |\r
| 查开发者创建的代币 | `queryDeveloperPage` |\r
| 查聪明钱/牛人榜 | `queryAddressRank` |\r
| 查社交热度排行 | `queryCoinHeatPage` |\r
| 查推文热度 | `queryTwitterTweetsHeat` |\r
\r
## 模块接口文档\r
\r
- **代币信号模块**：详见 [references/signal.md](references/signal.md)\r
  - 信号列表查询（分页，游标方式）\r
  - 信号排行榜查询（TOP10）\r
- **行情模块**：详见 [references/market.md](references/market.md)\r
  - 代币排行查询（coin-rank）\r
  - 交易活动列表（trade-scroll）\r
  - 流动性变化列表（liquid-scroll）\r
  - 代币盈利列表（pnl-coin-list）\r
  - 开发者代币列表（developer-scroll）\r
  - 代币统计信息（coin-summary）\r
  - 代币信息（coin-info）\r
  - K线历史数据（kline-historical）\r
  - Meme代币排行（meme-rank）\r
  - Meme支持DEX列表（meme-dexs）\r
- **地址情况模块**：详见 [references/address.md](references/address.md)\r
  - 地址交易历史（address-trade-scroll）\r
  - 地址盈亏分析（address-list）\r
  - 地址资产组合（address-asset-top）\r
  - 地址开发者代币（developer-page）\r
- **地址牛人榜模块**：详见 [references/address-rank.md](references/address-rank.md)\r
- **热度模块**：详见 [references/heat.md](references/heat.md)\r
  - 社交热度列表（coin-heat-page）\r
  - 推文热度数据（twitter-tweets-heat）