ValueScan API
加密货币主力资金流动向分析 API，追踪大户资金动向，让数据成为你的交易副驾驶。
使用场景示例
| 场景 | 通过 Skill 实现 |
|---|
| 行情信号 | 用户问：“最近有哪些币出现主力异动？” → 调用 资金异动列表 返回结果。<br>用户问：“BTC主力资金异动信号有哪些？”→ Skill 调用 资金异动消息 返回结果。 |
| 行情信号 |
用户问：“最近有哪些币可能上涨” → 调用
资金异动列表和
机会代币列表返回结果并说明场景
用户问：“BTC机会信号有哪些？”→ Skill 调用
机会代币消息 返回结果。 |
|
链上监控 | 用户设置：“当 ETH 出现超过 1000 ETH 的大额转账时通知我。” → 调用
大额交易 实现实时监控。 |
|
投资决策 | 用户问：“BTC 现在的压力位和支撑位在哪？” → 调用
压力支撑位 提供数据。 |
|
资金面分析 | 用户问：“过去一周，AI 板块的资金流向如何？” → 调用
板块资金列表 获取板块轮动数据。 |
|
地址分析 | 用户提供地址：“帮我分析这个地址的持仓成本变化。” → 调用
持仓趋势 返回建仓成本曲线。 |
接口列表
基础数据
- - 代币列表 → 搜索代币，获取对应的
vsTokenId 等基础标识信息。 - 代币基本信息 → 获取代币的实时价格、市值、
coinKey 等详细信息。 - K线数据 → 支持多时间窗口的 K 线数据查询，用于技术分析。
AI智选
AI综合多维度数据，追踪当前行情下的具有上涨机会或有下跌风险的代币，并实时追踪主力行为，提供实时追踪信号，辅助市场判断。
- - 机会代币列表 → 追踪当前行情下具有上涨潜力的代币
- 机会代币消息 → 上涨潜力币的主力动向实时信号（如吸筹、突破、出逃等）。
- 风险代币列表 → 当前行情下具有下跌风险趋势的代币
- 风险代币消息 → 下跌风险币的主力动向实时信号（如派发、破位、反弹等）。
- 资金异动列表 → 上涨或震荡行情中资金活跃且具有短期套利潜力的代币
- 资金异动消息 → 短线/趋势异动的实时信号（如主力入场、抛压等）。
- 大盘分析订阅 → BTC/ETH 的 AI 综合行情分析结果，辅助判断短期行情走向
交易所主力资金监控
监控中心化交易所（现货/合约）的资金流数据，追踪主力动向。
- - 实时资金积累 → 当日资金变化监控，反映主力实时流入/流出。
- 资金快照 → 最近100天的资金积累趋势，用于中长期资金面分析。
- 资金市值比 → 资金流入强度判断，辅助识别资金与市值匹配度。
- 板块资金列表 → 板块轮动资金监控，快速定位热点赛道。
- 板块代币资金 → 板块内龙头代币的实时资金积累数据。
链上主力资金监控
交易所的充/提资金监控，以及链上大户持仓成本变化监控，辅助主力行为追踪
- - 代币流向 → 链上与交易所之间的资金交互监控（交易所的充提数据）
- 主力成本变化趋势 → 大户平均持仓成本分析，识别主力建仓/出货位置。
市场指标
valuescan特色指标数据，对关键位置具有重要参考价值
- - 主力行为指标 → BTC/ETH 趋势判断，提供主力买卖行为信号。
- 压力支撑位 → 关键价格位置（支撑/压力）计算，辅助交易决策
- 社媒情绪 → 多空情绪分析，基于社交媒体热度与情绪指数。
链上大额交易
链上巨鲸交易监控，实时预警。
链上持仓地址数据
- - 持币地址 → 筹码集中度分析，查看地址数量与持仓分布。
- 余额趋势 → 指定地址的持仓变化历史。
- 盈亏趋势 → 指定地址的投资绩效（盈利/亏损情况）。
- 持仓成本趋势 → 指定地址的建仓成本分析（均价变化）。
- 交易行为趋势 → 指定地址的交易活跃度（转账次数、频率）。
接口参考文件结构
INLINECODE11 目录下的每个接口 JSON 文件均遵循统一结构，包含以下字段：
| 字段 | 类型 | 说明 |
|---|
| INLINECODE12 | string | 接口中文名称 |
| INLINECODE13 |
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 值 | 说明 |
|---|
| INLINECODE39 / INLINECODE40 | 整数类型 |
| INLINECODE41 |
数值类型（可能实际返回字符串） |
|
string | 字符串类型 |
|
boolean | 布尔类型 |
|
array | 数组类型，含
item 定义元素结构 |
关键字段解析
调用前必读字段
| 字段 | 说明 |
|---|
| INLINECODE46 | 请求参数定义，req: true 表示必填参数，req: false 表示可选参数。调用接口前必须检查并填入所有必填参数。 |
| INLINECODE49 |
调用注意事项，包含接口使用限制、数据范围、业务约束等重要提示。必须阅读后再发起请求。 |
|
enums | 枚举值映射表。某些字段（如
tradeType、
timeParticleEnum）使用数字编码，需参照此表转换为实际含义，或从
references/enums.json 加载标准枚举定义。 |
返回解读字段
| 字段 | 说明 |
|---|
| INLINECODE54 | 响应字段定义，包含字段名、type（声明类型）、actualType（实际类型）、desc（字段含义）。用于解析返回数据的结构和含义。 |
| INLINECODE58 |
核心业务字段解读，提供字段的
meaning（业务定义）、
range（取值范围）、
advice（使用建议）。解读返回数据时优先参考此字段。 |
|
typeNote | 类型转换说明。部分接口的数值字段声明为
number 但实际返回
string，使用前需注意类型转换。 |
|
example | 请求/响应示例，包含
req（标准请求体格式）和
res（典型响应数据结构）。用于验证请求格式和理解返回数据。 |
快速开始
Base URL: INLINECODE68
认证: HMAC-SHA256 签名
CODEBLOCK0 INLINECODE69
签名约束: Raw Body 必须与请求体完全一致，禁止格式化 | 签名SDK: sdk/README.md
核心参数
| 参数 | 说明 | 获取方式 |
|---|
| INLINECODE71 | 代币唯一标识 | 1. 调用 /vs-token/list 接口（参数 search 传代币符号如 BTC）；2. 从返回数据的 id 字段获取；3. 示例：{ "id": 1, "symbol": "BTC", "name": "Bitcoin" } 中 id=1 即为 INLINECODE78 |
| INLINECODE79 |
链上代币标识（格式：
{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=合约/永续市场 |
参数获取示例
CODEBLOCK2
目录结构
CODEBLOCK3
运行环境说明
| 项目 | 说明 |
|---|
| SDK依赖 | Node.js: 内置crypto/fetch，无需额外依赖 |
| 运行时要求 |
Node.js 16+ |
| 本地资源 | references/ 目录下的 JSON 文件仅供接口定义参考，运行时无需加载 |
| 安装安全性 | 本 Skill 无外部下载行为，所有依赖均为标准库或常用包 |
API 文档
详细 API 文档请参考：https://claw.valuescan.io
技能名称: valuescan-skill
详细描述:
ValueScan API
加密货币主力资金流动向分析 API，追踪大户资金动向，让数据成为你的交易副驾驶。
使用场景示例
| 场景 | 通过 Skill 实现 |
|---|
| 行情信号 | 用户问：“最近有哪些币出现主力异动？” → 调用 资金异动列表 返回结果。<br>用户问：“BTC主力资金异动信号有哪些？”→ Skill 调用 资金异动消息 返回结果。 |
| 行情信号 |
用户问：“最近有哪些币可能上涨” → 调用 资金异动列表和 机会代币列表返回结果并说明场景
用户问：“BTC机会信号有哪些？”→ Skill 调用 机会代币消息 返回结果。 |
|
链上监控 | 用户设置：“当 ETH 出现超过 1000 ETH 的大额转账时通知我。” → 调用 大额交易 实现实时监控。 |
|
投资决策 | 用户问：“BTC 现在的压力位和支撑位在哪？” → 调用 压力支撑位 提供数据。 |
|
资金面分析 | 用户问：“过去一周，AI 板块的资金流向如何？” → 调用 板块资金列表 获取板块轮动数据。 |
|
地址分析 | 用户提供地址：“帮我分析这个地址的持仓成本变化。” → 调用 持仓趋势 返回建仓成本曲线。 |
接口列表
基础数据
- - 代币列表 → 搜索代币，获取对应的 vsTokenId 等基础标识信息。
- 代币基本信息 → 获取代币的实时价格、市值、coinKey 等详细信息。
- K线数据 → 支持多时间窗口的 K 线数据查询，用于技术分析。
AI智选
AI综合多维度数据，追踪当前行情下的具有上涨机会或有下跌风险的代币，并实时追踪主力行为，提供实时追踪信号，辅助市场判断。
- - 机会代币列表 → 追踪当前行情下具有上涨潜力的代币
- 机会代币消息 → 上涨潜力币的主力动向实时信号（如吸筹、突破、出逃等）。
- 风险代币列表 → 当前行情下具有下跌风险趋势的代币
- 风险代币消息 → 下跌风险币的主力动向实时信号（如派发、破位、反弹等）。
- 资金异动列表 → 上涨或震荡行情中资金活跃且具有短期套利潜力的代币
- 资金异动消息 → 短线/趋势异动的实时信号（如主力入场、抛压等）。
- 大盘分析订阅 → BTC/ETH 的 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 签名
X-API-KEY: 你的API Key
X-TIMESTAMP: 13位毫秒时间戳
X-SIGN: HMAC-SHA256(secret=Secret Key, message=timestamp+body_json)
API Key: 访问 注册：
json
{
valuescanApiKey: 你的API Key,
valuescanSecretKey:
