#加密货币#blockchain#cryptocurrency#data-analysis#数据分析

valuescan-skill

ValueScan数据查询Skill。支持代币搜索、K线数据、主力资金流分析、链上数据查询等加密货币市场数据分析功能。

Install

openclaw skills install @valuescan-io/valuescan-skill

ValueScan API

加密货币主力资金流动向分析 API，追踪大户资金动向，让数据成为你的交易副驾驶。

使用场景示例

场景	通过 Skill 实现
行情信号	用户问：“最近有哪些币出现主力异动？” → 调用 `资金异动列表` 返回结果。用户问：“BTC主力资金异动信号有哪些？”→ Skill 调用 `资金异动消息` 返回结果。
行情信号	用户问：“最近有哪些币可能上涨” → 调用 `资金异动列表`和 `机会代币列表`返回结果并说明场景用户问：“BTC机会信号有哪些？”→ Skill 调用 `机会代币消息` 返回结果。
链上监控	用户设置：“当 ETH 出现超过 1000 ETH 的大额转账时通知我。” → 调用 `大额交易` 实现实时监控。
投资决策	用户问：“BTC 现在的压力位和支撑位在哪？” → 调用 `压力支撑位` 提供数据。
资金面分析	用户问：“过去一周，AI 板块的资金流向如何？” → 调用 `板块资金列表` 获取板块轮动数据。
地址分析	用户提供地址：“帮我分析这个地址的持仓成本变化。” → 调用 `持仓趋势` 返回建仓成本曲线。

接口列表

基础数据

代币列表 → 搜索代币，获取对应的 vsTokenId 等基础标识信息。
代币基本信息 → 获取代币的实时价格、市值、coinKey 等详细信息。
K线数据 → 支持多时间窗口的 K 线数据查询，用于技术分析。

AI智选

AI综合多维度数据，追踪当前行情下的具有上涨机会或有下跌风险的代币，并实时追踪主力行为，提供实时追踪信号，辅助市场判断。

机会代币列表 → 追踪当前行情下具有上涨潜力的代币
机会代币消息 → 上涨潜力币的主力动向实时信号（如吸筹、突破、出逃等）。
风险代币列表 → 当前行情下具有下跌风险趋势的代币
风险代币消息 → 下跌风险币的主力动向实时信号（如派发、破位、反弹等）。
资金异动列表 → 上涨或震荡行情中资金活跃且具有短期套利潜力的代币
资金异动消息 → 短线/趋势异动的实时信号（如主力入场、抛压等）。
~~大盘分析订阅~~ （已废弃，2026-06-01 停止服务） → 迁移至大盘解析列表
大盘解析列表 → 按代币 ID 查询 AI 大盘分析历史，支持时间范围和批量拉取

交易所主力资金监控

监控中心化交易所（现货/合约）的资金流数据，追踪主力动向。

实时资金积累 → 当日资金变化监控，反映主力实时流入/流出。
资金快照 → 最近100天的资金积累趋势，用于中长期资金面分析。
资金市值比 → 资金流入强度判断，辅助识别资金与市值匹配度。
板块资金列表 → 板块轮动资金监控，快速定位热点赛道。
板块代币资金 → 板块内龙头代币的实时资金积累数据。

链上主力资金监控

交易所的充/提资金监控，以及链上大户持仓成本变化监控，辅助主力行为追踪

代币流向 → 链上与交易所之间的资金交互监控（交易所的充提数据）
主力成本变化趋势 → 大户平均持仓成本分析，识别主力建仓/出货位置。

市场指标

valuescan特色指标数据，对关键位置具有重要参考价值

主力行为指标 → BTC/ETH 趋势判断，提供主力买卖行为信号。
压力支撑位 → 关键价格位置（支撑/压力）计算，辅助交易决策
社媒情绪 → 多空情绪分析，基于社交媒体热度与情绪指数。

链上大额交易

链上巨鲸交易监控，实时预警。

大额交易 → 鲸鱼在多链上的转账交易监控。

链上持仓地址数据

持币地址 → 筹码集中度分析，查看地址数量与持仓分布。
余额趋势 → 指定地址的持仓变化历史。
盈亏趋势 → 指定地址的投资绩效（盈利/亏损情况）。
持仓成本趋势 → 指定地址的建仓成本分析（均价变化）。
交易行为趋势 → 指定地址的交易活跃度（转账次数、频率）。

接口参考文件结构

references/ 目录下的每个接口 JSON 文件均遵循统一结构，包含以下字段：

字段	类型	说明
`name`	string	接口中文名称
`endpoint`	string	HTTP方法 + API路径（如 `POST /trade/getCoinTrade`）
`description`	string	接口功能描述
`credits_cost`	integer	调用该接口消耗的积分数量
`needToken`	boolean	是否需要认证（true/false）
`use_case`	string	业务使用场景说明，包含接口适用场景和使用建议
`notes`	string	调用注意事项和重要提醒
`update_frequency`	string	数据更新频率（如 `实时更新`）
`typeNote`	string	类型转换说明（如部分数值字段实际返回字符串）
`params`	object	请求参数定义，key 为参数名，value 含 `type`、`req`、`desc`
`response`	object	响应字段定义，含 `type`、`actualType`、`desc`
`field_meta`	object	字段业务含义，含 `meaning`（业务定义）、`range`（取值范围）、`advice`（使用建议）
`enums`	object	枚举值映射表，定义关键字段的可选值含义
`example`	object	请求/响应示例，含 `req`（请求体）和 `res`（响应体）

字段类型说明

type 值	说明
`long` / `integer`	整数类型
`number`	数值类型（可能实际返回字符串）
`string`	字符串类型
`boolean`	布尔类型
`array`	数组类型，含 `item` 定义元素结构

关键字段解析

调用前必读字段

字段	说明
`params`	请求参数定义，`req: true` 表示必填参数，`req: false` 表示可选参数。调用接口前必须检查并填入所有必填参数。
`notes`	调用注意事项，包含接口使用限制、数据范围、业务约束等重要提示。必须阅读后再发起请求。
`enums`	枚举值映射表。某些字段（如 `tradeType`、`timeParticleEnum`）使用数字编码，需参照此表转换为实际含义，或从 `references/enums.json` 加载标准枚举定义。

返回解读字段

字段	说明
`response`	响应字段定义，包含字段名、`type`（声明类型）、`actualType`（实际类型）、`desc`（字段含义）。用于解析返回数据的结构和含义。
`field_meta`	核心业务字段解读，提供字段的 `meaning`（业务定义）、`range`（取值范围）、`advice`（使用建议）。解读返回数据时优先参考此字段。
`typeNote`	类型转换说明。部分接口的数值字段声明为 `number` 但实际返回 `string`，使用前需注意类型转换。
`example`	请求/响应示例，包含 `req`（标准请求体格式）和 `res`（典型响应数据结构）。用于验证请求格式和理解返回数据。

快速开始

Base URL: https://api.valuescan.io/api/open/v1

认证: HMAC-SHA256 签名

text


X-API-KEY: 你的API Key
X-TIMESTAMP: 13位毫秒时间戳
X-SIGN: HMAC-SHA256(secret=Secret Key, message=timestamp+body_json)

API Key: 访问 https://www.valuescan.ai/dev-portal/home/ 注册：

json

{
  "valuescanApiKey": "你的API Key",
  "valuescanSecretKey": "你的Secret Key"
}

签名约束: Raw Body 必须与请求体完全一致，禁止格式化 | 签名SDK: sdk/README.md

核心参数

参数	说明	获取方式
`vsTokenId`	代币唯一标识	1. 调用 `/vs-token/list` 接口（参数 `search` 传代币符号如 `BTC`）；2. 从返回数据的 `id` 字段获取；3. 示例：`{ "id": 1, "symbol": "BTC", "name": "Bitcoin" }` 中 `id=1` 即为 `vsTokenId`
`coinKey`	链上代币标识（格式： `{symbol}_{contractAddress}`）	1. 先通过 `vsTokenId` 调用 `/vs-token/detail` 接口；2. 从返回的 `chainAddresses[].coinKey` 获取；3. 示例：`BTC` 返回 `"BTC_BTC"`，`ETH` 返回 `"ETH_0x..."`（原生代币无合约地址）
`address`	链上钱包地址	1. 调用 `持币地址` 接口获取某代币的持币地址列表；2. 或由用户直接提供；3. 格式为区块链标准地址（如 `0x...` 开头的以太坊地址）
`timeParticleEnum`	时间粒度编码	按分析周期选择：`5`=5分钟, `15`=15分钟, `101`=1小时, `104`=4小时, `124`=24小时, `201`=1天, `207`=7天, `230`=30天
`tradeType`	交易类型	`1`=现货市场, `2`=合约/永续市场

参数获取示例

text

# 场景：用户查询 BTC 的主力资金数据

Step 1: 调用代币列表接口
POST /vs-token/list
Body: { "search": "btc" }
响应: { "id": 1, "symbol": "BTC", "name": "Bitcoin" }
      → 获取 vsTokenId = 1

Step 2: 调用代币详情（可选，获取coinKey）
POST /vs-token/detail
Body: { "vsTokenId": 1 }
响应: chainAddresses[0].coinKey = "BTC_BTC"
      → 获取 coinKey = "BTC_BTC"（用于链上数据查询）

Step 3: 使用 vsTokenId 调用目标接口
POST /trade/getCoinTrade
Body: { "vsTokenId": 1, "tradeType": 1 }

目录结构

text

valuescan-skill/
├── SKILL.md                          # 技能文档
├── _meta.json                        # 元信息
├── references/                       # 接口参考文件
│   ├── enums.json                    # 通用枚举定义
│   │
│   ├── base/                         # 基础数据
│   │   ├── token-list.json           # 代币列表
│   │   ├── token-detail.json         # 代币详情
│   │   └── kline.json                # K线数据
│   │
│   ├── ai/                           # AI智选
│   │   ├── chance-coin-list.json     # 机会代币列表
│   │   ├── chance-coin-messages.json # 机会代币消息
│   │   ├── risk-coin-list.json       # 风险代币列表
│   │   ├── risk-coin-messages.json   # 风险代币消息
│   │   ├── funds-coin-list.json      # 资金异动列表
│   │   ├── funds-coin-messages.json  # 资金异动消息
│   │   ├── ai-analyse.json          # 大盘分析订阅（已废弃）
│   │   └── market-analysis-list.json # 大盘解析列表
│   │
│   ├── fund/                         # 主力资金
│   │   ├── realtime-fund.json        # 实时资金积累
│   │   ├── fund-snapshot.json        # 资金快照
│   │   ├── marketcap-ratio.json      # 资金市值比
│   │   ├── coin-flow.json            # 代币流向
│   │   └── cost.json                 # 主力成本
│   │
│   ├── category/                     # 板块资金
│   │   ├── category-list.json        # 板块资金列表
│   │   └── category-tokens.json      # 板块代币资金
│   │
│   ├── indicator/                    # 市场指标
│   │   ├── price-market.json         # 主力行为指标
│   │   ├── dense-area.json           # 压力支撑位
│   │   └── sentiment.json            # 社媒情绪
│   │
│   └── chain/                        # 链上数据
│       ├── large-trade.json          # 大额交易
│       ├── holders.json              # 持币地址
│       ├── balance-trend.json        # 余额趋势
│       ├── profit-loss-trend.json    # 盈亏趋势
│       ├── hold-trend.json           # 持仓趋势
│       └── trade-count-trend.json    # 交易数量趋势
│
└── script/
    └── sdk/                          # 签名SDK
        ├── README.md                 # SDK说明
        └── vs_api_sign.js            # JavaScript签名

运行环境说明

项目	说明
SDK依赖	Node.js: 内置crypto/fetch，无需额外依赖
运行时要求	Node.js 16+
本地资源	references/ 目录下的 JSON 文件仅供接口定义参考，运行时无需加载
安装安全性	本 Skill 无外部下载行为，所有依赖均为标准库或常用包

API 文档

详细 API 文档请参考：https://claw.valuescan.io

valuescan-skill

Install

ValueScan API

使用场景示例

接口列表

基础数据

AI智选

交易所主力资金监控

链上主力资金监控

市场指标

链上大额交易

链上持仓地址数据

接口参考文件结构

字段类型说明

关键字段解析

调用前必读字段

返回解读字段

快速开始

核心参数

参数获取示例

目录结构

运行环境说明

API 文档

Related skills