{"id":"dedadf1c-9995-4b62-8034-b3ac84e0ab81","entityType":"agent","slug":"clawhub-majincheng-mjc-test-destory","name":"valuescan-skill-beta","canonicalUrl":"https://www.xpersona.co/agent/clawhub-majincheng-mjc-test-destory","canonicalPath":"/agent/clawhub-majincheng-mjc-test-destory","generatedAt":"2026-10-11T17:45:13.919Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-11T14:35:06.719Z","emptyReason":null},"description":"测试skill-已废弃 Skill: valuescan-skill-beta Owner: majincheng Summary: 测试skill-已废弃 Tags: latest:1.0.7 Version history: v1.0.7 | 2026-03-24T11:18:19.957Z | user ValueScan Skill v1.0.7 is a minor update with documentation adjustments. - Updated documentation wording for installation and API Key registration. - Removed explicit file installation instructions from the main documentation. - No functional or interface changes; all core AP","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1K downloads reported by the source. Last updated 10/11/2026.","installCommand":"clawhub skill install s17e461mahp8qe0cbwpef9yvhd83gpj5:mjc-test-destory","sourceUrl":"https://clawhub.ai/majincheng/mjc-test-destory","homepage":"https://clawhub.ai/majincheng/skills/mjc-test-destory","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/majincheng/mjc-test-destory","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/majincheng/skills/mjc-test-destory","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":60,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"测试skill-已废弃 Skill: valuescan-skill-beta Owner: majincheng Summary: 测试skill-已废弃 Tags: latest:1.0.7 Version history: v1.0.7 | 2026-03-24T11:18:19.957Z | user Valu"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-11T14:35:06.719Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T14:35:06.719Z","emptyReason":null},"stars":null,"forks":null,"downloads":1049,"packageName":null,"latestVersion":"1.0.7","tractionLabel":"1K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T14:35:06.704Z","emptyReason":null},"lastUpdatedAt":"2026-10-11T14:35:06.719Z","lastCrawledAt":"2026-10-11T14:35:06.704Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-12T14:35:06.704Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.7","createdAt":"2026-03-24T11:18:19.957Z","changelog":"ValueScan Skill v1.0.7 is a minor update with documentation adjustments. - Updated documentation wording for installation and API Key registration. - Removed explicit file installation instructions from the main documentation. - No functional or interface changes; all core API details remain unchanged. - Version updated from 1.0.6 to 1.0.7.","fileCount":31,"zipByteSize":43372},{"version":"1.0.6","createdAt":"2026-03-24T09:43:39.833Z","changelog":"valuescan-skill-beta 1.0.6 - 新增版本号和多项元信息（如 category、license、installation、tags、support_email 等）。 - 调整 API 密钥配置说明，并添加依赖信息（Node 16.x）。 - 优化文档结构与用词，部分接口名称和说明更清晰（如“主力成本”→“主力成本变化趋势”、“持仓趋势”→“持仓成本趋势”）。 - 增补和规范接口使用场景、参数获取方式等文档内容，便于快速上手。 - 明确接口字段结构、参数类型、编码转换说明，细化文档标准。","fileCount":30,"zipByteSize":41957},{"version":"1.0.5","createdAt":"2026-03-23T09:53:32.661Z","changelog":"ValueScan Skill Beta 1.0.0 - Initial public beta release. - Provides cryptocurrency major fund flow analysis: real-time monitoring, whale address tracking, sector rotation, and opportunity/risk identification. - Supports key scenarios: capital flow alerts, sector/trend analysis, large transfer monitoring, and whale cost analysis. - Offers structured API documentation, parameter guides, and quick start examples. - Requires ValueScan API credentials for use.","fileCount":30,"zipByteSize":41048},{"version":"1.0.4","createdAt":"2026-03-23T09:44:33.208Z","changelog":"valuescan-skill-beta 1.0.4 - 增加 SKILL.md 中 credentials 与 environment 字段，明确 API 密钥存储方式和环境变量支持。 - 新增对本地凭证文件 ~/.openclaw/credentials/valuescan.json 的要求与描述。 - 文档未对核心功能和接口列表进行更改，仅改进 API Key 配置说明和参数填写指引。 - 其他内容保持不变，仅为技能接入和部署提供更清晰指引。","fileCount":30,"zipByteSize":41245},{"version":"1.0.3","createdAt":"2026-03-23T09:35:28.770Z","changelog":"Version 1.0.3 - Documentation formatting improved for clarity and consistency in SKILL.md. - Unnecessary repeated separator lines removed. - Markdown code fencing and list alignments standardized. - No functional or API changes; no code or file updates detected. - This update is a documentation refinement only.","fileCount":30,"zipByteSize":41122},{"version":"1.0.2","createdAt":"2026-03-23T09:14:18.996Z","changelog":"## valuescan-skill-beta v1.0.2 - 目录结构变动，SDK 相关文件位置由 /sdk/ 移至 /script/sdk/，相关 Python 签名脚本移除。 - 删除：sdk/README.md、sdk/vs_api_sign.js、sdk/vs_api_sign.py - 新增：script/sdk/README.md、script/sdk/vs_api_sign.js - SKILL 文档内容精简优化，接口说明和字段解释更加清晰，增加部分场景示例。 - skill 名称小幅调整，描述语言更简明。","fileCount":30,"zipByteSize":41173},{"version":"1.0.1","createdAt":"2026-03-20T09:17:49.228Z","changelog":"ValueScan Skill 1.0.0 – 初始版本发布 - 提供加密货币主力资金流、链上分析、AI 智选代币等多维度分析接口。 - 支持多类数据访问：AI智选、主力/板块资金、链上数据、市场指标、大额交易和链上持仓。 - 明确接口调用流程及参数准备、API 签名方法和认证方式。 - 包含详细的目录结构说明及参考文件。 - 支持通过官方 SDK 实现签名与调用。","fileCount":31,"zipByteSize":39871},{"version":"1.0.0","createdAt":"2026-03-20T07:12:49.144Z","changelog":"ValueScan skill 1.0.0 – Initial Release - Introduces API for crypto fund flow analysis and investment opportunity tracking. - Supports AI-based token selection, real-time fund tracking, market indicators, onchain data, and whale monitoring. - Provides detailed endpoint documentation and strict three-step invocation process to ensure correct parameter acquisition and response interpretation. - Includes HMAC-SHA256 API authentication and quickstart guidance. - Lists core parameters and example API key storage for secure access.","fileCount":31,"zipByteSize":39072}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s17e461mahp8qe0cbwpef9yvhd83gpj5:mjc-test-destory","setupComplexity":"low","setupSteps":["Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-majincheng-mjc-test-destory/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-majincheng-mjc-test-destory/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-majincheng-mjc-test-destory/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-majincheng-mjc-test-destory/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-majincheng-mjc-test-destory/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-majincheng-mjc-test-destory/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-11T17:45:13.911Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-majincheng-mjc-test-destory/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-majincheng-mjc-test-destory/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-majincheng-mjc-test-destory/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-majincheng-mjc-test-destory/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-11T14:35:06.719Z","emptyReason":null},"readme":"Skill: valuescan-skill-beta\n\nOwner: majincheng\n\nSummary: 测试skill-已废弃\n\nTags: latest:1.0.7\n\nVersion history:\n\nv1.0.7 | 2026-03-24T11:18:19.957Z | user\n\nValueScan Skill v1.0.7 is a minor update with documentation adjustments.\n\n- Updated documentation wording for installation and API Key registration.\n- Removed explicit file installation instructions from the main documentation.\n- No functional or interface changes; all core API details remain unchanged.\n- Version updated from 1.0.6 to 1.0.7.\n\nv1.0.6 | 2026-03-24T09:43:39.833Z | user\n\nvaluescan-skill-beta 1.0.6\n\n- 新增版本号和多项元信息（如 category、license、installation、tags、support_email 等）。\n- 调整 API 密钥配置说明，并添加依赖信息（Node 16.x）。\n- 优化文档结构与用词，部分接口名称和说明更清晰（如“主力成本”→“主力成本变化趋势”、“持仓趋势”→“持仓成本趋势”）。\n- 增补和规范接口使用场景、参数获取方式等文档内容，便于快速上手。\n- 明确接口字段结构、参数类型、编码转换说明，细化文档标准。\n\nv1.0.5 | 2026-03-23T09:53:32.661Z | user\n\nValueScan Skill Beta 1.0.0\n\n- Initial public beta release.\n- Provides cryptocurrency major fund flow analysis: real-time monitoring, whale address tracking, sector rotation, and opportunity/risk identification.\n- Supports key scenarios: capital flow alerts, sector/trend analysis, large transfer monitoring, and whale cost analysis.\n- Offers structured API documentation, parameter guides, and quick start examples.\n- Requires ValueScan API credentials for use.\n\nv1.0.4 | 2026-03-23T09:44:33.208Z | user\n\nvaluescan-skill-beta 1.0.4\n\n- 增加 SKILL.md 中 credentials 与 environment 字段，明确 API 密钥存储方式和环境变量支持。\n- 新增对本地凭证文件 ~/.openclaw/credentials/valuescan.json 的要求与描述。\n- 文档未对核心功能和接口列表进行更改，仅改进 API Key 配置说明和参数填写指引。\n- 其他内容保持不变，仅为技能接入和部署提供更清晰指引。\n\nv1.0.3 | 2026-03-23T09:35:28.770Z | user\n\nVersion 1.0.3\n\n- Documentation formatting improved for clarity and consistency in SKILL.md.\n- Unnecessary repeated separator lines removed.\n- Markdown code fencing and list alignments standardized.\n- No functional or API changes; no code or file updates detected.\n- This update is a documentation refinement only.\n\nv1.0.2 | 2026-03-23T09:14:18.996Z | user\n\n## valuescan-skill-beta v1.0.2\n\n- 目录结构变动，SDK 相关文件位置由 /sdk/ 移至 /script/sdk/，相关 Python 签名脚本移除。\n- 删除：sdk/README.md、sdk/vs_api_sign.js、sdk/vs_api_sign.py\n- 新增：script/sdk/README.md、script/sdk/vs_api_sign.js\n- SKILL 文档内容精简优化，接口说明和字段解释更加清晰，增加部分场景示例。\n- skill 名称小幅调整，描述语言更简明。\n\nv1.0.1 | 2026-03-20T09:17:49.228Z | user\n\nValueScan Skill 1.0.0 – 初始版本发布\n\n- 提供加密货币主力资金流、链上分析、AI 智选代币等多维度分析接口。\n- 支持多类数据访问：AI智选、主力/板块资金、链上数据、市场指标、大额交易和链上持仓。\n- 明确接口调用流程及参数准备、API 签名方法和认证方式。\n- 包含详细的目录结构说明及参考文件。\n- 支持通过官方 SDK 实现签名与调用。\n\nv1.0.0 | 2026-03-20T07:12:49.144Z | user\n\nValueScan skill 1.0.0 – Initial Release\n\n- Introduces API for crypto fund flow analysis and investment opportunity tracking.\n- Supports AI-based token selection, real-time fund tracking, market indicators, onchain data, and whale monitoring.\n- Provides detailed endpoint documentation and strict three-step invocation process to ensure correct parameter acquisition and response interpretation.\n- Includes HMAC-SHA256 API authentication and quickstart guidance.\n- Lists core parameters and example API key storage for secure access.\n\nArchive index:\n\nArchive v1.0.7: 31 files, 43372 bytes\n\nFiles: _meta.json (135b), references/ai/chance-coin-list.json (8952b), references/ai/chance-coin-messages.json (2356b), references/ai/funds-coin-list.json (4600b), references/ai/funds-coin-messages.json (2495b), references/ai/risk-coin-list.json (6341b), references/ai/risk-coin-messages.json (2387b), references/base/kline.json (2729b), references/base/token-detail.json (4881b), references/base/token-list.json (1388b), references/category/category-list.json (2407b), references/category/category-tokens.json (2360b), references/chain/balance-trend.json (2004b), references/chain/hold-trend.json (2131b), references/chain/holders.json (3491b), references/chain/large-trade.json (4649b), references/chain/profit-loss-trend.json (2016b), references/chain/trade-count-trend.json (2409b), references/enums.json (8104b), references/fund/coin-flow.json (2674b), references/fund/cost.json (2171b), references/fund/fund-snapshot.json (3878b), references/fund/marketcap-ratio.json (2233b), references/fund/realtime-fund.json (4909b), references/indicator/dense-area.json (1408b), references/indicator/price-market.json (1508b), references/indicator/sentiment.json (2982b), script/sdk/README.md (1116b), script/sdk/vs_api_sign.js (3916b), skill-card.md (2885b), SKILL.md (15717b)\n\nFile v1.0.7:SKILL.md\n\n---\r\nname: valuescan-skill-beta\r\ndescription: ValueScan 加密货币主力资金流分析工具。支持资金异动监控、主力动向追踪、鲸鱼地址分析、板块轮动、机会/风险代币识别、大户成本分析。\r\nversion: 1.0.7\r\nuser-invocable: true\r\ncategory: Data Analysis\r\nlicense: MIT\r\nhomepage: https://beta.valuescan.io\r\ndependencies:\r\n  - node: 16.x\r\ntags:\r\n  - cryptocurrency\r\n  - data analysis\r\n  - blockchain\r\n  - finance\r\ndocumentation: |\r\n  该 Skill 用于对加密货币市场进行分析，帮助用户识别资金流向、主力动向等信息。\r\nsupport_email: support@openclaw.com\r\nwebsite: https://beta.valuescan.io\r\ncredentials:\r\n  api_key:\r\n    description: 用于认证的 API 密钥\r\n    required: true\r\n  secret_key:\r\n    description: 用于认证的 Secret 密钥\r\n    required: true\r\n---\r\n\r\n# ValueScan API\r\n\r\n加密货币主力资金流动向分析 API，追踪大户资金动向，让数据成为你的交易副驾驶。\r\n\r\n## 使用场景示例\r\n\r\n| 场景           | 通过 Skill 实现                                              |\r\n| -------------- | ------------------------------------------------------------ |\r\n| **行情信号**   | 用户问：“最近有哪些币出现主力异动？” →  调用 `资金异动列表` 返回结果。<br>用户问：“BTC主力资金异动信号有哪些？”→ Skill 调用 `资金异动消息` 返回结果。 |\r\n| **行情信号**   | 用户问：“最近有哪些币可能上涨” →  调用 `资金异动列表`和  `机会代币列表`返回结果并说明场景     <br/>用户问：“BTC机会信号有哪些？”→ Skill 调用 `机会代币消息` 返回结果。 |\r\n| **链上监控**   | 用户设置：“当 ETH 出现超过 1000 ETH 的大额转账时通知我。” →  调用 `大额交易` 实现实时监控。 |\r\n| **投资决策**   | 用户问：“BTC 现在的压力位和支撑位在哪？” →  调用 `压力支撑位` 提供数据。 |\r\n| **资金面分析** | 用户问：“过去一周，AI 板块的资金流向如何？” →  调用 `板块资金列表` 获取板块轮动数据。 |\r\n| **地址分析**   | 用户提供地址：“帮我分析这个地址的持仓成本变化。” →  调用 `持仓趋势` 返回建仓成本曲线。 |\r\n\r\n## 接口列表\r\n\r\n### 基础数据\r\n\r\n| 接口         | 用途                                              |\r\n| ------------ | ------------------------------------------------- |\r\n| 代币列表     | 搜索代币，获取对应的 `vsTokenId` 等基础标识信息。 |\r\n| 代币基本信息 | 获取代币的实时价格、市值、`coinKey` 等详细信息。  |\r\n| K线数据      | 支持多时间窗口的 K 线数据查询，用于技术分析。     |\r\n\r\n### AI智选\r\n\r\nAI综合多维度数据，追踪当前行情下的具有上涨机会或有下跌风险的代币，并实时追踪主力行为，提供实时追踪信号，辅助市场判断。\r\n\r\n| 接口         | 用途                                                   |\r\n| ------------ | ------------------------------------------------------ |\r\n| 机会代币列表     | 追踪当前行情下具有上涨潜力的代币                       |\r\n| 机会代币消息     | 上涨潜力币的主力动向实时信号（如吸筹、突破、出逃等）。 |\r\n| 风险代币列表     | 当前行情下具有下跌风险趋势的代币                       |\r\n| 风险代币消息     | 下跌风险币的主力动向实时信号（如派发、破位、反弹等）。 |\r\n| 资金异动列表     | 上涨或震荡行情中资金活跃且具有短期套利潜力的代币       |\r\n| 资金异动消息     | 短线/趋势异动的实时信号（如主力入场、抛压等）。        |\r\n\r\n### 交易所主力资金监控\r\n\r\n监控中心化交易所（现货/合约）的资金流数据，追踪主力动向。\r\n\r\n| 接口           | 用途                                            |\r\n| -------------- | ----------------------------------------------- |\r\n| 实时资金积累       | 当日资金变化监控，反映主力实时流入/流出。       |\r\n| 资金快照           | 最近100天的资金积累趋势，用于中长期资金面分析。 |\r\n| 资金市值比         | 资金流入强度判断，辅助识别资金与市值匹配度。    |\r\n| 板块资金列表       | 板块轮动资金监控，快速定位热点赛道。            |\r\n| 板块代币资金       | 板块内龙头代币的实时资金积累数据。              |\r\n\r\n### 链上主力资金监控\r\n\r\n交易所的充/提资金监控，以及链上大户持仓成本变化监控，辅助主力行为追踪\r\n\r\n| 接口     | 用途                                          |\r\n| -------- | --------------------------------------------- |\r\n| 代币流向     | 链上与交易所之间的资金交互监控（交易所的充提数据） |\r\n| 主力成本变化趋势 | 大户平均持仓成本分析，识别主力建仓/出货位置。 |\r\n\r\n### 市场指标\r\n\r\nvaluescan特色指标数据，对关键位置具有重要参考价值\r\n\r\n| 接口         | 用途                                        |\r\n| ------------ | ------------------------------------------- |\r\n| 主力行为指标     | BTC/ETH 趋势判断，提供主力买卖行为信号。    |\r\n| 压力支撑位     | 关键价格位置（支撑/压力）计算，辅助交易决策 |\r\n| 社媒情绪        | 多空情绪分析，基于社交媒体热度与情绪指数。  |\r\n\r\n### 链上大额交易\r\n\r\n链上巨鲸交易监控，实时预警。\r\n\r\n| 接口     | 用途                         |\r\n| -------- | ---------------------------- |\r\n| 大额交易     | 鲸鱼在多链上的转账交易监控。 |\r\n\r\n### 链上持仓地址数据\r\n\r\n| 接口           | 用途                                           |\r\n| -------------- | ---------------------------------------------- |\r\n| 持币地址           | 筹码集中度分析，查看地址数量与持仓分布。       |\r\n| 余额趋势         | 指定地址的持仓变化历史。                       |\r\n| 盈亏趋势         | 指定地址的投资绩效（盈利/亏损情况）。          |\r\n| 持仓成本趋势 | 指定地址的建仓成本分析（均价变化）。           |\r\n| 交易行为趋势 | 指定地址的交易活跃度（转账次数、频率）。       |\r\n\r\n---\r\n\r\n## 接口参考文件结构\r\n\r\n`references/` 目录下的每个接口 JSON 文件均遵循统一结构，包含以下字段：\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| `name` | string | 接口中文名称 |\r\n| `endpoint` | string | HTTP方法 + API路径（如 `POST /trade/getCoinTrade`） |\r\n| `description` | string | 接口功能描述 |\r\n| `credits_cost` | integer | 调用该接口消耗的积分数量 |\r\n| `needToken` | boolean | 是否需要认证（true/false） |\r\n| `use_case` | string | 业务使用场景说明，包含接口适用场景和使用建议 |\r\n| `notes` | string | 调用注意事项和重要提醒 |\r\n| `update_frequency` | string | 数据更新频率（如 `实时更新`） |\r\n| `typeNote` | string | 类型转换说明（如部分数值字段实际返回字符串） |\r\n| `params` | object | 请求参数定义，key 为参数名，value 含 `type`、`req`、`desc` |\r\n| `response` | object | 响应字段定义，含 `type`、`actualType`、`desc` |\r\n| `field_meta` | object | 字段业务含义，含 `meaning`（业务定义）、`range`（取值范围）、`advice`（使用建议） |\r\n| `enums` | object | 枚举值映射表，定义关键字段的可选值含义 |\r\n| `example` | object | 请求/响应示例，含 `req`（请求体）和 `res`（响应体） |\r\n\r\n### 字段类型说明\r\n\r\n| type 值 | 说明 |\r\n|---------|------|\r\n| `long` / `integer` | 整数类型 |\r\n| `number` | 数值类型（可能实际返回字符串） |\r\n| `string` | 字符串类型 |\r\n| `boolean` | 布尔类型 |\r\n| `array` | 数组类型，含 `item` 定义元素结构 |\r\n\r\n### 关键字段解析\r\n\r\n#### 调用前必读字段\r\n\r\n| 字段 | 说明 |\r\n|------|------|\r\n| `params` | 请求参数定义，`req: true` 表示必填参数，`req: false` 表示可选参数。调用接口前必须检查并填入所有必填参数。 |\r\n| `notes` | 调用注意事项，包含接口使用限制、数据范围、业务约束等重要提示。必须阅读后再发起请求。 |\r\n| `enums` | 枚举值映射表。某些字段（如 `tradeType`、`timeParticleEnum`）使用数字编码，需参照此表转换为实际含义，或从 `references/enums.json` 加载标准枚举定义。 |\r\n\r\n#### 返回解读字段\r\n\r\n| 字段 | 说明 |\r\n|------|------|\r\n| `response` | 响应字段定义，包含字段名、`type`（声明类型）、`actualType`（实际类型）、`desc`（字段含义）。用于解析返回数据的结构和含义。 |\r\n| `field_meta` | 核心业务字段解读，提供字段的 `meaning`（业务定义）、`range`（取值范围）、`advice`（使用建议）。解读返回数据时优先参考此字段。 |\r\n| `typeNote` | 类型转换说明。部分接口的数值字段声明为 `number` 但实际返回 `string`，使用前需注意类型转换。 |\r\n| `example` | 请求/响应示例，包含 `req`（标准请求体格式）和 `res`（典型响应数据结构）。用于验证请求格式和理解返回数据。 |\r\n\r\n---\r\n\r\n## 快速开始\r\n\r\n**Base URL**: `https://api-beta.valuescan.io/api/open/v1`\r\n\r\n**认证**: HMAC-SHA256 签名\r\n\r\n```\r\n\r\nX-API-KEY: 你的API Key\r\nX-TIMESTAMP: 13位毫秒时间戳\r\nX-SIGN: HMAC-SHA256(secret=Secret Key, message=timestamp+body_json)\r\n\r\n````\r\n\r\n**API Key**: 访问 <https://beta.valuescan.io/dev-portal/home/> 注册：\r\n\r\n```json\r\n{ \r\n  \"valuescanApiKey\": \"你的API Key\", \r\n  \"valuescanSecretKey\": \"你的Secret Key\" \r\n}\r\n````\r\n\r\n**签名约束**: Raw Body 必须与请求体完全一致，禁止格式化 | 签名SDK: `sdk/README.md`\r\n\r\n---\r\n\r\n## 核心参数\r\n\r\n| 参数                 | 说明                                       | 获取方式                                                                                                                                                    |\r\n| ------------------ | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |\r\n| `vsTokenId`        | 代币唯一标识                                   | 1. 调用 `/vs-token/list` 接口（参数 `search` 传代币符号如 `BTC`）；2. 从返回数据的 `id` 字段获取；3. 示例：`{ \"id\": 1, \"symbol\": \"BTC\", \"name\": \"Bitcoin\" }` 中 `id=1` 即为 `vsTokenId` |\r\n| `coinKey`          | 链上代币标识（格式： `{symbol}_{contractAddress}`） | 1. 先通过 `vsTokenId` 调用 `/vs-token/detail` 接口；2. 从返回的 `chainAddresses[].coinKey` 获取；3. 示例：`BTC` 返回 `\"BTC_BTC\"`，`ETH` 返回 `\"ETH_0x...\"`（原生代币无合约地址）          |\r\n| `address`          | 链上钱包地址                                   | 1. 调用 `持币地址` 接口获取某代币的持币地址列表；2. 或由用户直接提供；3. 格式为区块链标准地址（如 `0x...` 开头的以太坊地址）                                                                               |\r\n| `timeParticleEnum` | 时间粒度编码                                   | 按分析周期选择：`5`=5分钟, `15`=15分钟, `101`=1小时, `104`=4小时, `124`=24小时, `201`=1天, `207`=7天, `230`=30天                                                             |\r\n| `tradeType`        | 交易类型                                     | `1`=现货市场, `2`=合约/永续市场                                                                                                                                   |\r\n\r\n### 参数获取示例\r\n\r\n```\r\n# 场景：用户查询 BTC 的主力资金数据\r\n\r\nStep 1: 调用代币列表接口\r\nPOST /vs-token/list\r\nBody: { \"search\": \"btc\" }\r\n响应: { \"id\": 1, \"symbol\": \"BTC\", \"name\": \"Bitcoin\" }\r\n      → 获取 vsTokenId = 1\r\n\r\nStep 2: 调用代币详情（可选，获取coinKey）\r\nPOST /vs-token/detail\r\nBody: { \"vsTokenId\": 1 }\r\n响应: chainAddresses[0].coinKey = \"BTC_BTC\"\r\n      → 获取 coinKey = \"BTC_BTC\"（用于链上数据查询）\r\n\r\nStep 3: 使用 vsTokenId 调用目标接口\r\nPOST /trade/getCoinTrade\r\nBody: { \"vsTokenId\": 1, \"tradeType\": 1 }\r\n```\r\n\r\n---\r\n\r\n## 目录结构\r\n\r\n```\r\nvaluescan-skill-beta/\r\n├── SKILL.md                          # 技能文档\r\n├── _meta.json                        # 元信息\r\n├── references/                       # 接口参考文件\r\n│   ├── enums.json                    # 通用枚举定义\r\n│   │\r\n│   ├── base/                         # 基础数据\r\n│   │   ├── token-list.json           # 代币列表\r\n│   │   ├── token-detail.json         # 代币详情\r\n│   │   └── kline.json                # K线数据\r\n│   │\r\n│   ├── ai/                           # AI智选\r\n│   │   ├── chance-coin-list.json     # 机会代币列表\r\n│   │   ├── chance-coin-messages.json # 机会代币消息\r\n│   │   ├── risk-coin-list.json       # 风险代币列表\r\n│   │   ├── risk-coin-messages.json   # 风险代币消息\r\n│   │   ├── funds-coin-list.json      # 资金异动列表\r\n│   │   └── funds-coin-messages.json  # 资金异动消息\r\n│   │\r\n│   ├── fund/                         # 主力资金\r\n│   │   ├── realtime-fund.json        # 实时资金积累\r\n│   │   ├── fund-snapshot.json        # 资金快照\r\n│   │   ├── marketcap-ratio.json      # 资金市值比\r\n│   │   ├── coin-flow.json            # 代币流向\r\n│   │   └── cost.json                 # 主力成本\r\n│   │\r\n│   ├── category/                     # 板块资金\r\n│   │   ├── category-list.json        # 板块资金列表\r\n│   │   └── category-tokens.json      # 板块代币资金\r\n│   │\r\n│   ├── indicator/                    # 市场指标\r\n│   │   ├── price-market.json         # 主力行为指标\r\n│   │   ├── dense-area.json           # 压力支撑位\r\n│   │   └── sentiment.json            # 社媒情绪\r\n│   │\r\n│   └── chain/                        # 链上数据\r\n│       ├── large-trade.json          # 大额交易\r\n│       ├── holders.json              # 持币地址\r\n│       ├── balance-trend.json        # 余额趋势\r\n│       ├── profit-loss-trend.json    # 盈亏趋势\r\n│       ├── hold-trend.json           # 持仓趋势\r\n│       └── trade-count-trend.json    # 交易数量趋势\r\n│\r\n└── script/\r\n    └── sdk/                          # 签名SDK\r\n        ├── README.md                 # SDK说明\r\n        └── vs_api_sign.js            # JavaScript签名\r\n```\r\n\r\n---\r\n\r\n## 运行环境说明\r\n\r\n| 项目    | 说明                                       |\r\n| ----- | ---------------------------------------- |\r\n| SDK依赖 | Node.js: 内置crypto/fetch，无需额外依赖           |\r\n| 运行时要求 | Node.js 16+                              |\r\n| 本地资源  | references/ 目录下的 JSON 文件仅供接口定义参考，运行时无需加载 |\r\n| 安装安全性 | 本 Skill 无外部下载行为，所有依赖均为标准库或常用包            |\r\n\r\n---\r\n\r\n## API 文档\r\n\r\n详细 API 文档请参考：[https://beta-claw.valuescan.io/zh-CN/](https://beta-claw.valuescan.io/zh-CN/)\n\nFile v1.0.7:script/sdk/README.md\n\n# ValueScan API SDK\r\n\r\n## 使用步骤\r\n\r\n**1. 配置 API Key**\r\n\r\n访问 https://beta.valuescan.io/dev-portal/home/ 注册获取 API Key:\r\n\r\n```json\r\n{\r\n  \"valuescanApiKey\": \"你的API Key\",\r\n  \"valuescanSecretKey\": \"你的Secret Key\"\r\n}\r\n```\r\n##  凭证说明\r\n\r\n本技能需要 ValueScan API 凭证用于请求签名：\r\n\r\n- 存储路径：`~/.openclaw/credentials/valuescan.json`\r\n- 签名方式：HMAC-SHA256\r\n- 数据用途：仅用于访问 ValueScan API，不会外传\r\n\r\n本技能不会收集或上传用户敏感信息。\r\n\r\n**2. SDK 调用**\r\n\r\n| 场景 | 方法 |\r\n|------|------|\r\n| 发送请求 | `vsPost(path, data)` |\r\n| 仅生成签名头 | `buildSignHeader(rawBody)` |\r\n\r\n**3. 调用示例**\r\n\r\n```javascript\r\nconst { vsPost } = require('./vs_api_sign');\r\nconst result = await vsPost('/api/open/v1/vs-token/list', {search: 'BTC'});\r\n```\r\n\r\n## 签名规范\r\n\r\n- **timestamp**: 13位毫秒时间戳（有效期5分钟）\r\n- **算法**: HMAC-SHA256(secret=Secret Key, message=timestamp + body_json)\r\n- **请求头**: `X-API-KEY`, `X-TIMESTAMP`, `X-SIGN`\r\n- **约束**: Raw Body 禁止格式化修改\n\nFile v1.0.7:_meta.json\n\n{\n  \"ownerId\": \"kn77r2vst0yn44kwc81rt8hz9s839z8m\",\n  \"slug\": \"mjc-test-destory\",\n  \"version\": \"1.0.7\",\n  \"publishedAt\": 1774351099957\n}\n\nFile v1.0.7:references/ai/chance-coin-list.json\n\n{\r\n  \"name\": \"机会代币列表\",\r\n  \"endpoint\": \"POST /ai/getChanceCoinList\",\r\n  \"description\": \"获取AI通过多维度数据，追踪当前行情下具有上涨潜力的代币列表\",\r\n  \"credits_cost\": 3,\r\n  \"needToken\": false,\r\n  \"use_case\": \"适用于当前行情下存在上涨行情机会的代币筛选和查询，适用于中短线交易者寻找具有上涨潜力的代币标的，适用于趋势跟踪策略中识别潜在上涨机会\",\r\n  \"update_frequency\": \"每 5 分钟更新一次\",\r\n  \"typeNote\": \"部分数值字段实际返回为字符串类型，使用时请注意类型转换\",\r\n  \"params\": {},\r\n  \"response\": {\r\n    \"vsTokenId\": { \"type\": \"long\", \"actualType\": \"string\", \"desc\": \"代币ID\" },\r\n    \"symbol\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"币种符号\" },\r\n    \"price\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"当前价格(USD)\" },\r\n    \"maxPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"历史最高价格(USD)\" },\r\n    \"minPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"历史最低价格(USD)\" },\r\n    \"percentChange1h\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"1小时价格变化百分比\" },\r\n    \"percentChange24h\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"24小时价格变化百分比\" },\r\n    \"percentChange7d\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"7天价格变化百分比\" },\r\n    \"percentChange30d\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"30天价格变化百分比\" },\r\n    \"percentChange60d\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"60天价格变化百分比\" },\r\n    \"percentChange90d\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"90天价格变化百分比\" },\r\n    \"cost\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"主力成本价格(USD)\" },\r\n    \"costChange\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"成本变化率\" },\r\n    \"deviation\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"价格偏离度(%)\" },\r\n    \"marketCap\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"市值(USD)\" },\r\n    \"marketCapRanking\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"市值排名\" },\r\n    \"circulatingSupply\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"流通供应量\" },\r\n    \"circulationRate\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"流通率(%)\" },\r\n    \"active\": { \"type\": \"integer\", \"actualType\": \"string\", \"desc\": \"24h活跃地址数\" },\r\n    \"newly\": { \"type\": \"integer\", \"actualType\": \"string\", \"desc\": \"24h新增地址数\" },\r\n    \"tradeType\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"交易类型（1:现货 2:合约 3:交割合约）\" },\r\n    \"chanceCoinTradeDataV1Vos\": {\r\n      \"type\": \"array\",\r\n      \"desc\": \"交易时间数据列表\",\r\n      \"item\": {\r\n        \"timeRange\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"时间范围标识（如m15, H4）\" },\r\n        \"timeParticleEnum\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"时间粒度枚举值\" },\r\n        \"tradeInflow\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"交易净流入金额(USD)\" },\r\n        \"tradeAmount\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"交易总金额(USD)\" }\r\n      }\r\n    },\r\n    \"updateTime\": { \"type\": \"long\", \"actualType\": \"long\", \"desc\": \"更新时间（毫秒时间戳）\" },\r\n    \"pushPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"入场推送价格(USD)\" },\r\n    \"pushMaxPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"推送后最高价(USD)\" },\r\n    \"gains\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"推送后涨幅(%)\" },\r\n    \"pushMinPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"推送后最低价(USD)\" },\r\n    \"declines\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"推送后跌幅(%)\" },\r\n    \"score\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"AI综合评分\" },\r\n    \"scoreChange\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"评分变化\" },\r\n    \"grade\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"机会等级(1-3, 3为最高)\" },\r\n    \"alpha\": { \"type\": \"boolean\", \"actualType\": \"boolean\", \"desc\": \"是否Alpha信号\" },\r\n    \"fomo\": { \"type\": \"boolean\", \"actualType\": \"boolean\", \"desc\": \"是否FOMO状态\" },\r\n    \"fomoEscalation\": { \"type\": \"boolean\", \"actualType\": \"boolean\", \"desc\": \"是否FOMO加剧\" },\r\n    \"bullishRatio\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"看涨情绪比例\" },\r\n    \"bearishRatio\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"看跌情绪比例\" }\r\n  },\r\n  \"field_meta\": {\r\n    \"cost\": { \"meaning\": \"主力成本价格\", \"range\": \"根据大额交易加权计算的主力持仓成本\", \"advice\": \"当前价格低于成本价时可能是买入机会\" },\r\n    \"deviation\": { \"meaning\": \"价格偏离度\", \"range\": \"(当前价格 - 主力成本) / 主力成本 * 100%\", \"advice\": \"负值表示低于成本，正值表示高于成本\" },\r\n    \"score\": { \"meaning\": \"AI综合评分\", \"range\": \"0-100，基于资金流、技术指标等综合计算\", \"advice\": \"评分<=45或>=80：待观察代币；45<评分<55：观察代币；55<评分<80：机会代币\" },\r\n    \"grade\": { \"meaning\": \"机会等级\", \"range\": \"1-3，3为最高等级\", \"advice\": \"等级越高表示风险越高\" },\r\n    \"pushPrice\": { \"meaning\": \"入场推送价格\", \"range\": \"系统首次推送该机会代币时的价格\", \"advice\": \"用于计算入场后的涨跌幅\" },\r\n    \"gains\": { \"meaning\": \"推送后涨幅\", \"range\": \"(pushMaxPrice - pushPrice) / pushPrice * 100%\", \"advice\": \"推送后的最大涨幅\" },\r\n    \"declines\": { \"meaning\": \"推送后跌幅\", \"range\": \"(pushPrice - pushMinPrice) / pushPrice * 100%\", \"advice\": \"推送后的最大跌幅\" },\r\n    \"alpha\": { \"meaning\": \"Alpha信号\", \"range\": \"布尔值，表示是否具有超额收益潜力\", \"advice\": \"true时关注度应更高\" },\r\n    \"fomo\": { \"meaning\": \"FOMO信号\", \"range\": \"布尔值，表示市场情绪是否过热\", \"advice\": \"true时需警惕追高风险\" },\r\n    \"fomoEscalation\": { \"meaning\": \"FOMO加剧\", \"range\": \"布尔值，FOMO状态进一步升级\", \"advice\": \"true时风险显著增加\" },\r\n    \"active\": { \"meaning\": \"24h活跃地址数\", \"range\": \"过去24小时内有交易的链上地址数量\", \"advice\": \"反映市场参与热度\" },\r\n    \"newly\": { \"meaning\": \"24h新增地址数\", \"range\": \"过去24小时内首次持有该代币的地址数量\", \"advice\": \"反映新资金流入\" },\r\n    \"bullishRatio\": { \"meaning\": \"看涨情绪比例\", \"range\": \"0-1，基于社媒分析\", \"advice\": \"越接近1表示市场越看涨\" },\r\n    \"bearishRatio\": { \"meaning\": \"看跌情绪比例\", \"range\": \"0-1，基于社媒分析\", \"advice\": \"越接近1表示市场越看跌\" },\r\n    \"tradeInflow\": { \"meaning\": \"交易净流入\", \"range\": \"正值为资金流入，负值为资金流出\", \"advice\": \"持续正值表示主力在吸筹\" }\r\n  },\r\n  \"enums\": {\r\n    \"tradeType\": { \"1\": \"现货\", \"2\": \"合约（永续）\", \"3\": \"交割合约\" },\r\n    \"timeParticleEnum\": { \"5\": \"5分钟\", \"15\": \"15分钟\", \"30\": \"30分钟\", \"101\": \"1小时\", \"104\": \"4小时\", \"124\": \"24小时\", \"201\": \"1天\", \"207\": \"7天\", \"230\": \"30天\" }\r\n  },\r\n  \"example\": {\r\n    \"req\": {},\r\n    \"res\": {\r\n      \"code\": 200,\r\n      \"data\": [\r\n        {\r\n          \"vsTokenId\": \"23335\",\r\n          \"symbol\": \"THE\",\r\n          \"price\": \"0.2792\",\r\n          \"maxPrice\": \"4.1032\",\r\n          \"minPrice\": \"0.0722\",\r\n          \"percentChange1h\": \"0.33\",\r\n          \"percentChange24h\": \"1.42\",\r\n          \"percentChange7d\": \"4.49\",\r\n          \"percentChange30d\": \"7.90\",\r\n          \"percentChange60d\": \"25.65\",\r\n          \"percentChange90d\": \"56.37\",\r\n          \"cost\": \"0.2709\",\r\n          \"costChange\": \"0.0625\",\r\n          \"deviation\": \"-1.42\",\r\n          \"marketCap\": \"36026970.95\",\r\n          \"marketCapRanking\": 312,\r\n          \"circulatingSupply\": \"128932942.42\",\r\n          \"circulationRate\": \"39.54\",\r\n          \"active\": \"347\",\r\n          \"newly\": \"347\",\r\n          \"tradeType\": 1,\r\n          \"chanceCoinTradeDataV1Vos\": [\r\n            { \"timeRange\": \"m15\", \"timeParticleEnum\": 15, \"tradeInflow\": \"460.63\", \"tradeAmount\": \"3213.51\" },\r\n            { \"timeRange\": \"m30\", \"timeParticleEnum\": 30, \"tradeInflow\": \"-338.10\", \"tradeAmount\": \"4455.51\" },\r\n            { \"timeRange\": \"H4\", \"timeParticleEnum\": 104, \"tradeInflow\": \"-5145.62\", \"tradeAmount\": \"37250.34\" }\r\n          ],\r\n          \"updateTime\": 1773016500000,\r\n          \"pushPrice\": \"0.2621\",\r\n          \"pushMaxPrice\": \"0.2806\",\r\n          \"gains\": 0.0,\r\n          \"pushMinPrice\": \"0.2587\",\r\n          \"declines\": 1.30,\r\n          \"score\": 45.0,\r\n          \"scoreChange\": 10.0,\r\n          \"grade\": 2,\r\n          \"alpha\": false,\r\n          \"fomo\": false,\r\n          \"fomoEscalation\": false,\r\n          \"bullishRatio\": 1.0,\r\n          \"bearishRatio\": 0.0\r\n        }\r\n      ]\r\n    }\r\n  }\r\n}\n\nFile v1.0.7:references/ai/chance-coin-messages.json\n\n{\r\n  \"name\": \"机会代币消息列表\",\r\n  \"endpoint\": \"POST /ai/getChanceCoinMessageList\",\r\n  \"description\": \"获取AI通过多数据维度，对当前行情下具有上涨潜力的代币的追踪消息数据\",\r\n  \"credits_cost\": 3,\r\n  \"needToken\": true,\r\n  \"use_case\": \"适用于当前行情下，对有上涨行情机会的代币，进行AI实时追踪的消息查询，适用于了解主力动作（入场、增持、减持、出逃等）\",\r\n  \"params\": {\r\n    \"vsTokenId\": { \"type\": \"long\", \"req\": true, \"desc\": \"代币ID\" }\r\n  },\r\n  \"response\": {\r\n    \"updateTime\": { \"type\": \"long\", \"actualType\": \"long\", \"desc\": \"更新时间\" },\r\n    \"vsTokenId\": { \"type\": \"long\", \"actualType\": \"string\", \"desc\": \"代币ID\" },\r\n    \"symbol\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"代币符号\" },\r\n    \"name\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"代币名称\" },\r\n    \"chanceMessageType\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"预测类型\" },\r\n    \"scoring\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"得分\" },\r\n    \"grade\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"等级\" },\r\n    \"price\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"币价\" },\r\n    \"percentChange24h\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"24小时涨跌幅\" },\r\n    \"gains\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"涨幅\" },\r\n    \"decline\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"跌幅\" }\r\n  },\r\n  \"field_meta\": {\r\n    \"chanceMessageType\": { \"meaning\": \"机会消息类型\", \"advice\": \"标识主力动作类型，如入场、增持、减持、出逃等\" },\r\n    \"scoring\": { \"meaning\": \"机会得分\", \"advice\": \"该信号的综合评分，分数越高信号越强\" },\r\n    \"grade\": { \"meaning\": \"机会等级\", \"advice\": \"信号等级划分，用于筛选重要信号\" }\r\n  },\r\n  \"example\": {\r\n    \"req\": { \"vsTokenId\": 23335 },\r\n    \"res\": {\r\n      \"code\": 200,\r\n      \"data\": [\r\n        {\r\n          \"updateTime\": 1773071700000,\r\n          \"vsTokenId\": \"23335\",\r\n          \"symbol\": \"THE\",\r\n          \"name\": \"THENA\",\r\n          \"chanceMessageType\": 30,\r\n          \"scoring\": 0.0,\r\n          \"grade\": 2,\r\n          \"price\": \"0.2742\",\r\n          \"percentChange24h\": 6.18,\r\n          \"gains\": 5.07,\r\n          \"decline\": 0.36\r\n        }\r\n      ]\r\n    }\r\n  }\r\n}\n\nFile v1.0.7:references/ai/funds-coin-list.json\n\n{\r\n  \"name\": \"资金异动代币列表\",\r\n  \"endpoint\": \"POST /ai/getFundsCoinList\",\r\n  \"description\": \"获取对指定代币在中心化交易所上，监控到现货或合约交易存在主力资金异动的代币列表\",\r\n  \"credits_cost\": 3,\r\n  \"needToken\": false,\r\n  \"use_case\": \"适用于实时监控在上涨或震荡行情中资金活跃且具有短期套利潜力的代币查询，适用于发现异常资金流动的代币\",\r\n  \"notes\": \"自然语言输入异动、资金看涨、异动看涨等词语时查询此接口；自然语言输入上涨机会、看涨代币等语言时可查询此接口，返回结果需注明资金异动看涨代币\",\r\n  \"update_frequency\": \"实时更新\",\r\n  \"params\": {},\r\n  \"response\": {\r\n    \"updateTime\": { \"type\": \"long\", \"actualType\": \"long\", \"desc\": \"更新时间\" },\r\n    \"tradeType\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"交易类型（1:现货 2:合约 3:交割合约）\" },\r\n    \"vsTokenId\": { \"type\": \"long\", \"actualType\": \"string\", \"desc\": \"代币ID\" },\r\n    \"symbol\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"交易符号\" },\r\n    \"name\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"代币名称\" },\r\n    \"startTime\": { \"type\": \"long\", \"actualType\": \"long\", \"desc\": \"开始时间\" },\r\n    \"endTime\": { \"type\": \"long\", \"actualType\": \"long\", \"desc\": \"结束时间\" },\r\n    \"number24h\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"24小时内的数量\" },\r\n    \"numberNot24h\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"非24小时内的数量\" },\r\n    \"price\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"价格\" },\r\n    \"pushPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"开始价格\" },\r\n    \"gains\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"涨幅\" },\r\n    \"decline\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"推送后跌幅(%)\" },\r\n    \"percentChange24h\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"24小时价格变化百分比\" },\r\n    \"marketCap\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"市值\" },\r\n    \"alpha\": { \"type\": \"boolean\", \"actualType\": \"boolean\", \"desc\": \"是否Alpha\" },\r\n    \"fomo\": { \"type\": \"boolean\", \"actualType\": \"boolean\", \"desc\": \"是否Fomo\" },\r\n    \"fomoEscalation\": { \"type\": \"boolean\", \"actualType\": \"boolean\", \"desc\": \"是否Fomo加剧\" },\r\n    \"bullishRatio\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"看涨情绪比例\" }\r\n  },\r\n  \"field_meta\": {\r\n    \"startTime\": { \"meaning\": \"异动开始时间\", \"range\": \"资金异动周期的起始时间\", \"advice\": \"用于了解异动持续时长\" },\r\n    \"endTime\": { \"meaning\": \"异动结束时间\", \"range\": \"资金异动周期的结束时间\", \"advice\": \"与startTime配合判断异动周期\" },\r\n    \"number24h\": { \"meaning\": \"短线行情异动\", \"range\": \"最近24小时内资金的异动次数检测\", \"advice\": \"次数越多表示异动越频繁\" },\r\n    \"numberNot24h\": { \"meaning\": \"趋势行情异动\", \"range\": \"3个月内的资金异动次数检测\", \"advice\": \"次数越多表示异动越频繁\" },\r\n    \"pushPrice\": { \"meaning\": \"异动推送价格\", \"range\": \"系统首次推送该异动代币时的价格\", \"advice\": \"用于计算入场后的涨跌幅\" },\r\n    \"alpha\": { \"meaning\": \"Alpha信号\", \"range\": \"布尔值，表示主力异常活跃或上涨可能高\", \"advice\": \"true时关注度应更高\" },\r\n    \"fomo\": { \"meaning\": \"FOMO信号\", \"range\": \"布尔值，表示市场情绪活跃，上涨趋势可能延续\", \"advice\": \"true时上涨延续可能性高，但需注意追高风险\" },\r\n    \"fomoEscalation\": { \"meaning\": \"FOMO加剧\", \"range\": \"布尔值，FOMO市场情绪过热，可能有突发风险\", \"advice\": \"true时风险显著增加\" }\r\n  },\r\n  \"enums\": {\r\n    \"tradeType\": { \"1\": \"现货\", \"2\": \"合约（永续）\", \"3\": \"交割合约\" }\r\n  },\r\n  \"example\": {\r\n    \"req\": {},\r\n    \"res\": {\r\n      \"code\": 200,\r\n      \"data\": [\r\n        {\r\n          \"updateTime\": 1773395400000,\r\n          \"tradeType\": 2,\r\n          \"vsTokenId\": \"22974\",\r\n          \"symbol\": \"TAO\",\r\n          \"name\": \"Bittensor\",\r\n          \"startTime\": 1773297600000,\r\n          \"endTime\": 1773395400000,\r\n          \"number24h\": 7,\r\n          \"numberNot24h\": 1,\r\n          \"price\": \"237.5\",\r\n          \"pushPrice\": \"205.7\",\r\n          \"gains\": 19.20,\r\n          \"declines\": 1.07,\r\n          \"percentChange24h\": \"4.56\",\r\n          \"marketCap\": \"2555201474.45\",\r\n          \"alpha\": true,\r\n          \"fomo\": false,\r\n          \"fomoEscalation\": false,\r\n          \"bullishRatio\": 0.56\r\n        }\r\n      ]\r\n    }\r\n  }\r\n}\n\nFile v1.0.7:references/ai/funds-coin-messages.json\n\n{\r\n  \"name\": \"资金异动代币消息列表\",\r\n  \"endpoint\": \"POST /ai/getFundsCoinMessageList\",\r\n  \"description\": \"获取对指定代币在中心化交易所上，现货或合约交易的主力资金异动的监控消息记录\",\r\n  \"credits_cost\": 3,\r\n  \"needToken\": true,\r\n  \"use_case\": \"适用于资金异动监控列表下的代币，在AI实时追踪过程中的消息查询，适用于查看历史资金异动信号记录，包括但不限于短线/趋势行情异动、Alpha、FOMO、止盈、止损等\",\r\n  \"notes\": \"信号类型需展示名称，出现多个alpha，fomo等消息时，统计各自出现的次数，同时出现时特别提醒；自然语言查询异动代币后，或查询异动信号，调用此接口；与资金异动代币列表接口配合使用，资金异动代币里的代币信号查询才调用此接口\",\r\n  \"params\": {\r\n    \"vsTokenId\": { \"type\": \"long\", \"req\": true, \"desc\": \"代币ID\" },\r\n    \"tradeType\": { \"type\": \"integer\", \"req\": true, \"desc\": \"交易类型（1:现货, 2:合约）\" }\r\n  },\r\n  \"response\": {\r\n    \"updateTime\": { \"type\": \"long\", \"actualType\": \"long\", \"desc\": \"更新时间\" },\r\n    \"vsTokenId\": { \"type\": \"long\", \"actualType\": \"string\", \"desc\": \"代币ID\" },\r\n    \"symbol\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"代币符号\" },\r\n    \"name\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"名称\" },\r\n    \"tradeType\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"交易类型（1:现货; 2:合约; 3:交割合约）\" },\r\n    \"price\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"币价\" },\r\n    \"percentChange24h\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"24小时涨跌幅\" },\r\n    \"fundsMovementType\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"资金流动类型\" }\r\n  },\r\n  \"field_meta\": {\r\n    \"fundsMovementType\": { \"meaning\": \"资金异动类型\", \"advice\": \"标识资金异动类型，如短线行情异动、趋势行情异动、Alpha等，同一时间多个类型时，可特别提醒，信号类型的对应关系不展示\" }\r\n  },\r\n  \"example\": {\r\n    \"req\": { \"vsTokenId\": 22974, \"tradeType\": 1 },\r\n    \"res\": {\r\n      \"code\": 200,\r\n      \"data\": [\r\n        {\r\n          \"updateTime\": 1773395700000,\r\n          \"vsTokenId\": \"22974\",\r\n          \"symbol\": \"TAO\",\r\n          \"name\": \"Bittensor\",\r\n          \"tradeType\": 1,\r\n          \"price\": \"241.4\",\r\n          \"percentChange24h\": 15.36,\r\n          \"fundsMovementType\": 6\r\n        }\r\n      ]\r\n    }\r\n  }\r\n}\n\nFile v1.0.7:references/ai/risk-coin-list.json\n\n{\r\n  \"name\": \"风险代币列表\",\r\n  \"endpoint\": \"POST /ai/getRiskCoinList\",\r\n  \"description\": \"获取AI通过多维度数据，追踪到当前行情下具有下跌风险趋势的代币列表\",\r\n  \"credits_cost\": 3,\r\n  \"needToken\": false,\r\n  \"use_case\": \"适用于当前行情下存在下跌行情风险的代币查询，适用于风险预警和持仓规避参考\",\r\n  \"update_frequency\": \"每 5 分钟更新一次\",\r\n  \"params\": {},\r\n  \"response\": {\r\n    \"vsTokenId\": { \"type\": \"long\", \"actualType\": \"string\", \"desc\": \"代币ID\" },\r\n    \"symbol\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"币种符号\" },\r\n    \"price\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"当前价格\" },\r\n    \"maxPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"最高价格\" },\r\n    \"minPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"最低价格\" },\r\n    \"percentChange1h\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"1小时价格变化百分比\" },\r\n    \"percentChange24h\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"24小时价格变化百分比\" },\r\n    \"percentChange7d\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"7天价格变化百分比\" },\r\n    \"percentChange30d\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"30天价格变化百分比\" },\r\n    \"percentChange60d\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"60天价格变化百分比\" },\r\n    \"percentChange90d\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"90天价格变化百分比\" },\r\n    \"cost\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"成本价格\" },\r\n    \"costChange\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"成本变化\" },\r\n    \"deviation\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"偏离度\" },\r\n    \"marketCap\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"市值\" },\r\n    \"marketCapRanking\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"市值排名\" },\r\n    \"circulatingSupply\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"流通供应量\" },\r\n    \"circulationRate\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"流通率\" },\r\n    \"active\": { \"type\": \"integer\", \"actualType\": \"string\", \"desc\": \"活跃地址\" },\r\n    \"newly\": { \"type\": \"integer\", \"actualType\": \"string\", \"desc\": \"新增地址\" },\r\n    \"tradeType\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"交易类型（1:现货 2:合约 3:交割合约）\" },\r\n    \"chanceCoinTradeDataV1Vos\": {\r\n      \"type\": \"array\",\r\n      \"desc\": \"交易时间数据列表\",\r\n      \"item\": {\r\n        \"timeRange\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"时间范围标识（如m15, H4）\" },\r\n        \"timeParticleEnum\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"时间粒度枚举值\" },\r\n        \"tradeInflow\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"交易净流入金额(USD)\" },\r\n        \"tradeAmount\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"交易总金额(USD)\" }\r\n      }\r\n    },\r\n    \"updateTime\": { \"type\": \"long\", \"actualType\": \"long\", \"desc\": \"更新时间\" },\r\n    \"pushPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"推送价格\" },\r\n    \"pushMaxPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"推送最高价\" },\r\n    \"gains\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"回撤\" },\r\n    \"pushMinPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"推送最低价\" },\r\n    \"declines\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"跌幅\" },\r\n    \"score\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"当前评分\" },\r\n    \"bullishRatio\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"看涨比例\" },\r\n    \"bearishRatio\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"看跌比例\" }\r\n  },\r\n  \"field_meta\": {\r\n    \"cost\": { \"meaning\": \"主力成本价格\", \"range\": \"根据大额交易加权计算的主力持仓成本\", \"advice\": \"当前价格高于成本价时主力可能获利了结\" },\r\n    \"deviation\": { \"meaning\": \"价格偏离度\", \"range\": \"(当前价格 - 主力成本) / 主力成本 * 100%\", \"advice\": \"正值过大时需警惕回调风险\" },\r\n    \"score\": { \"meaning\": \"AI风险评分\", \"range\": \"0-100，基于资金流、技术指标等综合计算\", \"advice\": \"评分<=45或>=80:待观察代币；45<评分<75:观察代币；75<评分<80：下跌风险代币\" },\r\n    \"pushPrice\": { \"meaning\": \"风险推送价格\", \"range\": \"系统首次推送该风险代币时的价格\", \"advice\": \"用于计算推送后的涨跌幅\" },\r\n    \"declines\": { \"meaning\": \"推送后跌幅\", \"range\": \"(pushPrice - pushMinPrice) / pushPrice * 100%\", \"advice\": \"验证风险预警的准确性\" },\r\n    \"tradeInflow\": { \"meaning\": \"交易净流入\", \"range\": \"正值为资金流入，负值为资金流出\", \"advice\": \"持续负值表示主力在出货\" }\r\n  },\r\n  \"enums\": {\r\n    \"tradeType\": { \"1\": \"现货\", \"2\": \"合约（永续）\", \"3\": \"交割合约\" },\r\n    \"timeParticleEnum\": { \"5\": \"5分钟\", \"15\": \"15分钟\", \"30\": \"30分钟\", \"101\": \"1小时\", \"104\": \"4小时\", \"106\": \"6小时\", \"124\": \"24小时\", \"201\": \"1天\", \"202\": \"2天\", \"207\": \"7天\", \"230\": \"30天\" }\r\n  },\r\n  \"example\": {\r\n    \"req\": {},\r\n    \"res\": {\r\n      \"code\": 200,\r\n      \"data\": [\r\n        {\r\n          \"vsTokenId\": \"38178\",\r\n          \"symbol\": \"TRUTH\",\r\n          \"price\": \"0.0094\",\r\n          \"maxPrice\": \"0.0502\",\r\n          \"minPrice\": \"0.0084\",\r\n          \"percentChange1h\": \"-0.42\",\r\n          \"percentChange24h\": \"-0.22\",\r\n          \"percentChange7d\": \"-0.64\",\r\n          \"percentChange30d\": \"-33.89\",\r\n          \"percentChange60d\": \"-36.71\",\r\n          \"percentChange90d\": \"-52.50\",\r\n          \"cost\": \"\",\r\n          \"costChange\": \"\",\r\n          \"deviation\": \"\",\r\n          \"marketCap\": \"19433307.40\",\r\n          \"marketCapRanking\": 427,\r\n          \"circulatingSupply\": \"2085305300\",\r\n          \"circulationRate\": \"20.85\",\r\n          \"active\": \"\",\r\n          \"newly\": \"\",\r\n          \"tradeType\": 2,\r\n          \"updateTime\": 1771287000000,\r\n          \"pushPrice\": \"0.0157\",\r\n          \"pushMaxPrice\": \"0.0163\",\r\n          \"gains\": 0.0,\r\n          \"pushMinPrice\": \"0.0088\",\r\n          \"declines\": 43.77,\r\n          \"score\": 36.5,\r\n          \"bullishRatio\": \"\",\r\n          \"bearishRatio\": \"\"\r\n        }\r\n      ]\r\n    }\r\n  }\r\n}\n\nFile v1.0.7:references/ai/risk-coin-messages.json\n\n{\r\n  \"name\": \"风险代币消息列表\",\r\n  \"endpoint\": \"POST /ai/getRiskCoinMessageList\",\r\n  \"description\": \"获取AI通过多数据维度，对当前行情下具有下跌风险趋势的代币的追踪消息数据\",\r\n  \"credits_cost\": 3,\r\n  \"needToken\": true,\r\n  \"use_case\": \"适用于当前行情下，对有下跌行情风险的代币，进行AI实时追踪的消息查询，适用于了解出货预警、下跌风险、反弹等风险信号\",\r\n  \"params\": {\r\n    \"vsTokenId\": { \"type\": \"long\", \"req\": true, \"desc\": \"代币ID\" }\r\n  },\r\n  \"response\": {\r\n    \"updateTime\": { \"type\": \"long\", \"actualType\": \"long\", \"desc\": \"更新时间\" },\r\n    \"vsTokenId\": { \"type\": \"long\", \"actualType\": \"string\", \"desc\": \"代币ID\" },\r\n    \"symbol\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"代币符号\" },\r\n    \"name\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"代币名称\" },\r\n    \"riskMessageType\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"预测类型\" },\r\n    \"scoring\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"得分\" },\r\n    \"grade\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"等级\" },\r\n    \"price\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"币价\" },\r\n    \"percentChange24h\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"24小时涨跌幅\" },\r\n    \"riskDecline\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"风险跌幅\" },\r\n    \"rebound\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"反弹\" }\r\n  },\r\n  \"field_meta\": {\r\n    \"riskMessageType\": { \"meaning\": \"风险消息类型\", \"advice\": \"标识风险信号类型，如出货预警、下跌风险、反弹等\" },\r\n    \"riskDecline\": { \"meaning\": \"风险跌幅\", \"advice\": \"推送后价格下跌幅度，用于验证风险预警准确性\" },\r\n    \"rebound\": { \"meaning\": \"反弹幅度\", \"advice\": \"价格下跌后的反弹程度\" }\r\n  },\r\n  \"example\": {\r\n    \"req\": { \"vsTokenId\": 38178 },\r\n    \"res\": {\r\n      \"code\": 200,\r\n      \"data\": [\r\n        {\r\n          \"updateTime\": 1771317300000,\r\n          \"vsTokenId\": \"38178\",\r\n          \"symbol\": \"TRUTH\",\r\n          \"name\": \"Swarm Network\",\r\n          \"riskMessageType\": 19,\r\n          \"scoring\": \"\",\r\n          \"grade\": \"\",\r\n          \"price\": \"0.0118\",\r\n          \"percentChange24h\": -2.32,\r\n          \"riskDecline\": 26.38,\r\n          \"rebound\": 6.61\r\n        }\r\n      ]\r\n    }\r\n  }\r\n}\n\nFile v1.0.7:references/base/kline.json\n\n{\r\n  \"name\": \"K 线数据\",\r\n  \"endpoint\": \"POST /trade/kline/getTradeKLineList\",\r\n  \"description\": \"获取K线数据，可查询指定代币（仅支持USDT交易对）和指定时间段内不超过1000条的K线数据\",\r\n  \"credits_cost\": 1,\r\n  \"needToken\": true,\r\n  \"use_case\": \"适用于查询不同时间窗口类型的K线数据查询，适用于结合价格K线判断买卖时机\",\r\n  \"update_frequency\": \"根据bucketType实时更新\",\r\n  \"params\": {\r\n    \"vsTokenId\": { \"type\": \"long\", \"req\": true, \"desc\": \"代币ID\" },\r\n    \"bucketType\": { \"type\": \"string\", \"req\": true, \"desc\": \"K线时间窗口类型(5m/15m/30m/1h/4h/1d/1w)\" },\r\n    \"startTime\": { \"type\": \"long\", \"req\": false, \"desc\": \"开始时间（毫秒时间戳）\" },\r\n    \"endTime\": { \"type\": \"long\", \"req\": true, \"desc\": \"结束时间（毫秒时间戳）\" },\r\n    \"size\": { \"type\": \"integer\", \"req\": false, \"desc\": \"查询记录数，默认360条，最大不超过1000条\" }\r\n  },\r\n  \"response\": {\r\n    \"vsTokenId\": { \"type\": \"long\", \"actualType\": \"string\", \"desc\": \"代币ID\" },\r\n    \"symbol\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"代币符号\" },\r\n    \"name\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"代币名称\" },\r\n    \"klineType\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"K线类型\" },\r\n    \"klineData\": {\r\n      \"type\": \"array\",\r\n      \"desc\": \"K线数据\",\r\n      \"item\": {\r\n        \"time\": { \"type\": \"long\", \"actualType\": \"long\", \"desc\": \"时间（毫秒时间戳）\" },\r\n        \"open\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"开盘价\" },\r\n        \"close\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"收盘价\" },\r\n        \"high\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"最高价\" },\r\n        \"low\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"最低价\" },\r\n        \"volume\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"成交量\" },\r\n        \"amount\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"成交额(USD)\" }\r\n      }\r\n    }\r\n  },\r\n  \"enums\": {\r\n    \"bucketType\": {\r\n      \"5m\": \"5分钟\",\r\n      \"15m\": \"15分钟\",\r\n      \"30m\": \"30分钟\",\r\n      \"1h\": \"1小时\",\r\n      \"4h\": \"4小时\",\r\n      \"1d\": \"1天\",\r\n      \"1w\": \"1周\"\r\n    }\r\n  },\r\n  \"example\": {\r\n    \"req\": { \"vsTokenId\": 1, \"bucketType\": \"5m\", \"endTime\": 1773478632535, \"size\": 20 },\r\n    \"res\": {\r\n      \"code\": 200,\r\n      \"data\": {\r\n        \"vsTokenId\": \"1\",\r\n        \"symbol\": \"BTC\",\r\n        \"name\": \"Bitcoin\",\r\n        \"klineType\": \"01\",\r\n        \"klineData\": [\r\n          { \"time\": 1773478200000, \"open\": \"70544.92\", \"close\": \"70594.48\", \"high\": \"70594.49\", \"low\": \"70536.58\", \"volume\": \"20.54\", \"amount\": \"1449509.94\" }\r\n        ]\r\n      }\r\n    }\r\n  }\r\n}\n\nFile v1.0.7:references/base/token-detail.json\n\n{\r\n  \"name\": \"代币详情\",\r\n  \"endpoint\": \"POST /vs-token/detail\",\r\n  \"description\": \"获取指定代币的基础信息，包括市场信息，链上基本信息，行情基本信息等\",\r\n  \"credits_cost\": 1,\r\n  \"needToken\": true,\r\n  \"use_case\": \"适用于代币的通用信息查询，适用于获取代币的完整信息，包括价格、市值、供应量等，适用于获取coinKey（调用链上数据接口的必要参数）\",\r\n  \"important\": \"chainAddresses数组中包含该代币在不同区块链上的coinKey，如需查询链上持仓地址、余额趋势等数据，需让用户选择目标链并缓存对应的coinKey\",\r\n  \"params\": {\r\n    \"vsTokenId\": { \"type\": \"long\", \"req\": true, \"desc\": \"代币ID\" }\r\n  },\r\n  \"response\": {\r\n    \"vsTokenId\": { \"type\": \"long\", \"actualType\": \"string\", \"desc\": \"代币ID\" },\r\n    \"name\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"代币名称\" },\r\n    \"symbol\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"代币符号\" },\r\n    \"oldSymbol\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"改名前的symbol\" },\r\n    \"price\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"当前价格(USD)\" },\r\n    \"highPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"历史最高价(USD)\" },\r\n    \"lowPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"历史最低价(USD)\" },\r\n    \"marketCapDominance\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"市值占比(%)\" },\r\n    \"volume24h\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"24H交易量(USD)\" },\r\n    \"volumeChange24h\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"24H交易量变化率(%)\" },\r\n    \"percentChange1h\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"1小时涨跌幅(%)\" },\r\n    \"percentChange24h\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"24小时涨跌幅(%)\" },\r\n    \"percentChange7d\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"7天涨跌幅(%)\" },\r\n    \"percentChange30d\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"30天涨跌幅(%)\" },\r\n    \"percentChange60d\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"60天涨跌幅(%)\" },\r\n    \"percentChange90d\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"90天涨跌幅(%)\" },\r\n    \"marketCap\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"市值(USD)\" },\r\n    \"totalSupply\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"总供应量\" },\r\n    \"circulationSupply\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"流通量\" },\r\n    \"maxSupply\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"最大供应量\" },\r\n    \"cost\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"链上持仓成本(USD)\" },\r\n    \"chainAddresses\": {\r\n      \"type\": \"array\",\r\n      \"desc\": \"各个链上信息\",\r\n      \"item\": {\r\n        \"contractAddress\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"合约地址\" },\r\n        \"chainName\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"链名\" },\r\n        \"holderCount\": { \"type\": \"integer\", \"actualType\": \"string\", \"desc\": \"持仓地址数\" },\r\n        \"transCount\": { \"type\": \"integer\", \"actualType\": \"string\", \"desc\": \"交易笔数\" },\r\n        \"issueDate\": { \"type\": \"long\", \"actualType\": \"long\", \"desc\": \"发行时间（毫秒时间戳）\" },\r\n        \"precision\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"精度\" },\r\n        \"totalSupply\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"该链上供应量\" },\r\n        \"coinKey\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"链上代币标识（调用链上数据接口的必要参数）\" }\r\n      }\r\n    }\r\n  },\r\n  \"example\": {\r\n    \"req\": { \"vsTokenId\": 1 },\r\n    \"res\": {\r\n      \"code\": 200,\r\n      \"data\": {\r\n        \"vsTokenId\": \"1\",\r\n        \"name\": \"Bitcoin\",\r\n        \"symbol\": \"BTC\",\r\n        \"oldSymbol\": \"\",\r\n        \"price\": \"70559.18\",\r\n        \"highPrice\": \"126198.07\",\r\n        \"lowPrice\": \"0.04864654\",\r\n        \"marketCapDominance\": \"\",\r\n        \"volume24h\": \"54389029990.50\",\r\n        \"volumeChange24h\": \"15.6056\",\r\n        \"percentChange1h\": \"-0.09\",\r\n        \"percentChange24h\": \"-1.29\",\r\n        \"percentChange7d\": \"3.96\",\r\n        \"percentChange30d\": \"5.35\",\r\n        \"percentChange60d\": \"-23.17\",\r\n        \"percentChange90d\": \"-21.71\",\r\n        \"marketCap\": \"1412725749093.27\",\r\n        \"totalSupply\": \"20001887\",\r\n        \"circulationSupply\": \"20001887\",\r\n        \"maxSupply\": \"21000000\",\r\n        \"cost\": \"60515.83\",\r\n        \"chainAddresses\": [\r\n          {\r\n            \"contractAddress\": \"BTC\",\r\n            \"chainName\": \"BTC\",\r\n            \"holderCount\": \"55905596\",\r\n            \"transCount\": \"1322741358\",\r\n            \"issueDate\": 1230998400000,\r\n            \"precision\": \"8\",\r\n            \"totalSupply\": \"20001892\",\r\n            \"coinKey\": \"BTC_BTC\"\r\n          }\r\n        ]\r\n      }\r\n    }\r\n  }\r\n}\n\nFile v1.0.7:references/base/token-list.json\n\n{\r\n  \"name\": \"代币列表\",\r\n  \"endpoint\": \"POST /vs-token/list\",\r\n  \"description\": \"获取ValueScan支持的代币列表，支持按代币全称或代币简称进行模糊搜索\",\r\n  \"credits_cost\": 1,\r\n  \"needToken\": false,\r\n  \"use_case\": \"这是基础接口，用于获取代币的vsTokenId，该ID是调用其他代币相关接口的必要参数。重要提示：当用户输入代币名称时，若存在多个同名或相近的代币（如不同链、不同标准），需引导用户选择目标代币，并缓存代币名称与vsTokenId的对应关系，以便后续接口调用时直接引用\",\r\n  \"params\": {\r\n    \"search\": { \"type\": \"string\", \"req\": false, \"desc\": \"搜索关键字（符号，支持模糊匹配），最大长度100字符，大小写不敏感\" }\r\n  },\r\n  \"response\": {\r\n    \"id\": { \"type\": \"long\", \"actualType\": \"long\", \"desc\": \"代币ID（即vsTokenId，用于其他接口调用）\" },\r\n    \"symbol\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"代币符号（如BTC, ETH）\" },\r\n    \"name\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"代币名称（如Bitcoin, Ethereum）\" }\r\n  },\r\n  \"example\": {\r\n    \"req\": { \"search\": \"btc\" },\r\n    \"res\": {\r\n      \"code\": 200,\r\n      \"data\": [\r\n        { \"id\": 1, \"symbol\": \"BTC\", \"name\": \"Bitcoin\" },\r\n        { \"id\": 33652, \"symbol\": \"LBTC\", \"name\": \"Lombard Staked BTC\" }\r\n      ]\r\n    }\r\n  }\r\n}\n\nArchive v1.0.6: 30 files, 41957 bytes\n\nFiles: _meta.json (135b), references/ai/chance-coin-list.json (8952b), references/ai/chance-coin-messages.json (2356b), references/ai/funds-coin-list.json (4600b), references/ai/funds-coin-messages.json (2495b), references/ai/risk-coin-list.json (6341b), references/ai/risk-coin-messages.json (2387b), references/base/kline.json (2729b), references/base/token-detail.json (4881b), references/base/token-list.json (1388b), references/category/category-list.json (2407b), references/category/category-tokens.json (2360b), references/chain/balance-trend.json (2004b), references/chain/hold-trend.json (2131b), references/chain/holders.json (3491b), references/chain/large-trade.json (4649b), references/chain/profit-loss-trend.json (2016b), references/chain/trade-count-trend.json (2409b), references/enums.json (8104b), references/fund/coin-flow.json (2674b), references/fund/cost.json (2171b), references/fund/fund-snapshot.json (3878b), references/fund/marketcap-ratio.json (2233b), references/fund/realtime-fund.json (4909b), references/indicator/dense-area.json (1408b), references/indicator/price-market.json (1508b), references/indicator/sentiment.json (2982b), script/sdk/README.md (1169b), script/sdk/vs_api_sign.js (3916b), SKILL.md (15947b)\n\nFile v1.0.6:SKILL.md\n\n---\r\nname: valuescan-skill-beta\r\ndescription: ValueScan 加密货币主力资金流分析工具。支持资金异动监控、主力动向追踪、鲸鱼地址分析、板块轮动、机会/风险代币识别、大户成本分析。\r\nversion: 1.0.6\r\nuser-invocable: true\r\ncategory: Data Analysis\r\nlicense: MIT\r\nhomepage: https://beta.valuescan.io\r\ninstallation: |\r\n  1. 安装依赖：`npm install` 或 `pip install`。\r\n  2. 配置 API 密钥：请在 `~/.openclaw/credentials/valuescan.json` 文件中设置 API 密钥。\r\ndependencies:\r\n  - node: 16.x\r\ntags:\r\n  - cryptocurrency\r\n  - data analysis\r\n  - blockchain\r\n  - finance\r\ndocumentation: |\r\n  该 Skill 用于对加密货币市场进行分析，帮助用户识别资金流向、主力动向等信息。\r\nsupport_email: support@openclaw.com\r\nwebsite: https://beta.valuescan.io\r\ncredentials:\r\n  api_key:\r\n    description: 用于认证的 API 密钥\r\n    required: true\r\n  secret_key:\r\n    description: 用于认证的 Secret 密钥\r\n    required: true\r\n---\r\n\r\n# ValueScan API\r\n\r\n加密货币主力资金流动向分析 API，追踪大户资金动向，让数据成为你的交易副驾驶。\r\n\r\n## 使用场景示例\r\n\r\n| 场景           | 通过 Skill 实现                                              |\r\n| -------------- | ------------------------------------------------------------ |\r\n| **行情信号**   | 用户问：“最近有哪些币出现主力异动？” →  调用 `资金异动列表` 返回结果。<br>用户问：“BTC主力资金异动信号有哪些？”→ Skill 调用 `资金异动消息` 返回结果。 |\r\n| **行情信号**   | 用户问：“最近有哪些币可能上涨” →  调用 `资金异动列表`和  `机会代币列表`返回结果并说明场景     <br/>用户问：“BTC机会信号有哪些？”→ Skill 调用 `机会代币消息` 返回结果。 |\r\n| **链上监控**   | 用户设置：“当 ETH 出现超过 1000 ETH 的大额转账时通知我。” →  调用 `大额交易` 实现实时监控。 |\r\n| **投资决策**   | 用户问：“BTC 现在的压力位和支撑位在哪？” →  调用 `压力支撑位` 提供数据。 |\r\n| **资金面分析** | 用户问：“过去一周，AI 板块的资金流向如何？” →  调用 `板块资金列表` 获取板块轮动数据。 |\r\n| **地址分析**   | 用户提供地址：“帮我分析这个地址的持仓成本变化。” →  调用 `持仓趋势` 返回建仓成本曲线。 |\r\n\r\n## 接口列表\r\n\r\n### 基础数据\r\n\r\n| 接口         | 用途                                              |\r\n| ------------ | ------------------------------------------------- |\r\n| 代币列表     | 搜索代币，获取对应的 `vsTokenId` 等基础标识信息。 |\r\n| 代币基本信息 | 获取代币的实时价格、市值、`coinKey` 等详细信息。  |\r\n| K线数据      | 支持多时间窗口的 K 线数据查询，用于技术分析。     |\r\n\r\n### AI智选\r\n\r\nAI综合多维度数据，追踪当前行情下的具有上涨机会或有下跌风险的代币，并实时追踪主力行为，提供实时追踪信号，辅助市场判断。\r\n\r\n| 接口         | 用途                                                   |\r\n| ------------ | ------------------------------------------------------ |\r\n| 机会代币列表     | 追踪当前行情下具有上涨潜力的代币                       |\r\n| 机会代币消息     | 上涨潜力币的主力动向实时信号（如吸筹、突破、出逃等）。 |\r\n| 风险代币列表     | 当前行情下具有下跌风险趋势的代币                       |\r\n| 风险代币消息     | 下跌风险币的主力动向实时信号（如派发、破位、反弹等）。 |\r\n| 资金异动列表     | 上涨或震荡行情中资金活跃且具有短期套利潜力的代币       |\r\n| 资金异动消息     | 短线/趋势异动的实时信号（如主力入场、抛压等）。        |\r\n\r\n### 交易所主力资金监控\r\n\r\n监控中心化交易所（现货/合约）的资金流数据，追踪主力动向。\r\n\r\n| 接口           | 用途                                            |\r\n| -------------- | ----------------------------------------------- |\r\n| 实时资金积累       | 当日资金变化监控，反映主力实时流入/流出。       |\r\n| 资金快照           | 最近100天的资金积累趋势，用于中长期资金面分析。 |\r\n| 资金市值比         | 资金流入强度判断，辅助识别资金与市值匹配度。    |\r\n| 板块资金列表       | 板块轮动资金监控，快速定位热点赛道。            |\r\n| 板块代币资金       | 板块内龙头代币的实时资金积累数据。              |\r\n\r\n### 链上主力资金监控\r\n\r\n交易所的充/提资金监控，以及链上大户持仓成本变化监控，辅助主力行为追踪\r\n\r\n| 接口     | 用途                                          |\r\n| -------- | --------------------------------------------- |\r\n| 代币流向     | 链上与交易所之间的资金交互监控（交易所的充提数据） |\r\n| 主力成本变化趋势 | 大户平均持仓成本分析，识别主力建仓/出货位置。 |\r\n\r\n### 市场指标\r\n\r\nvaluescan特色指标数据，对关键位置具有重要参考价值\r\n\r\n| 接口         | 用途                                        |\r\n| ------------ | ------------------------------------------- |\r\n| 主力行为指标     | BTC/ETH 趋势判断，提供主力买卖行为信号。    |\r\n| 压力支撑位     | 关键价格位置（支撑/压力）计算，辅助交易决策 |\r\n| 社媒情绪        | 多空情绪分析，基于社交媒体热度与情绪指数。  |\r\n\r\n### 链上大额交易\r\n\r\n链上巨鲸交易监控，实时预警。\r\n\r\n| 接口     | 用途                         |\r\n| -------- | ---------------------------- |\r\n| 大额交易     | 鲸鱼在多链上的转账交易监控。 |\r\n\r\n### 链上持仓地址数据\r\n\r\n| 接口           | 用途                                           |\r\n| -------------- | ---------------------------------------------- |\r\n| 持币地址           | 筹码集中度分析，查看地址数量与持仓分布。       |\r\n| 余额趋势         | 指定地址的持仓变化历史。                       |\r\n| 盈亏趋势         | 指定地址的投资绩效（盈利/亏损情况）。          |\r\n| 持仓成本趋势 | 指定地址的建仓成本分析（均价变化）。           |\r\n| 交易行为趋势 | 指定地址的交易活跃度（转账次数、频率）。       |\r\n\r\n---\r\n\r\n## 接口参考文件结构\r\n\r\n`references/` 目录下的每个接口 JSON 文件均遵循统一结构，包含以下字段：\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| `name` | string | 接口中文名称 |\r\n| `endpoint` | string | HTTP方法 + API路径（如 `POST /trade/getCoinTrade`） |\r\n| `description` | string | 接口功能描述 |\r\n| `credits_cost` | integer | 调用该接口消耗的积分数量 |\r\n| `needToken` | boolean | 是否需要认证（true/false） |\r\n| `use_case` | string | 业务使用场景说明，包含接口适用场景和使用建议 |\r\n| `notes` | string | 调用注意事项和重要提醒 |\r\n| `update_frequency` | string | 数据更新频率（如 `实时更新`） |\r\n| `typeNote` | string | 类型转换说明（如部分数值字段实际返回字符串） |\r\n| `params` | object | 请求参数定义，key 为参数名，value 含 `type`、`req`、`desc` |\r\n| `response` | object | 响应字段定义，含 `type`、`actualType`、`desc` |\r\n| `field_meta` | object | 字段业务含义，含 `meaning`（业务定义）、`range`（取值范围）、`advice`（使用建议） |\r\n| `enums` | object | 枚举值映射表，定义关键字段的可选值含义 |\r\n| `example` | object | 请求/响应示例，含 `req`（请求体）和 `res`（响应体） |\r\n\r\n### 字段类型说明\r\n\r\n| type 值 | 说明 |\r\n|---------|------|\r\n| `long` / `integer` | 整数类型 |\r\n| `number` | 数值类型（可能实际返回字符串） |\r\n| `string` | 字符串类型 |\r\n| `boolean` | 布尔类型 |\r\n| `array` | 数组类型，含 `item` 定义元素结构 |\r\n\r\n### 关键字段解析\r\n\r\n#### 调用前必读字段\r\n\r\n| 字段 | 说明 |\r\n|------|------|\r\n| `params` | 请求参数定义，`req: true` 表示必填参数，`req: false` 表示可选参数。调用接口前必须检查并填入所有必填参数。 |\r\n| `notes` | 调用注意事项，包含接口使用限制、数据范围、业务约束等重要提示。必须阅读后再发起请求。 |\r\n| `enums` | 枚举值映射表。某些字段（如 `tradeType`、`timeParticleEnum`）使用数字编码，需参照此表转换为实际含义，或从 `references/enums.json` 加载标准枚举定义。 |\r\n\r\n#### 返回解读字段\r\n\r\n| 字段 | 说明 |\r\n|------|------|\r\n| `response` | 响应字段定义，包含字段名、`type`（声明类型）、`actualType`（实际类型）、`desc`（字段含义）。用于解析返回数据的结构和含义。 |\r\n| `field_meta` | 核心业务字段解读，提供字段的 `meaning`（业务定义）、`range`（取值范围）、`advice`（使用建议）。解读返回数据时优先参考此字段。 |\r\n| `typeNote` | 类型转换说明。部分接口的数值字段声明为 `number` 但实际返回 `string`，使用前需注意类型转换。 |\r\n| `example` | 请求/响应示例，包含 `req`（标准请求体格式）和 `res`（典型响应数据结构）。用于验证请求格式和理解返回数据。 |\r\n\r\n---\r\n\r\n## 快速开始\r\n\r\n**Base URL**: `https://api-beta.valuescan.io/api/open/v1`\r\n\r\n**认证**: HMAC-SHA256 签名\r\n\r\n```\r\n\r\nX-API-KEY: 你的API Key\r\nX-TIMESTAMP: 13位毫秒时间戳\r\nX-SIGN: HMAC-SHA256(secret=Secret Key, message=timestamp+body_json)\r\n\r\n````\r\n\r\n**API Key**: 访问 <https://beta.valuescan.io/dev-portal/home/> 注册，保存到 `~/.openclaw/credentials/valuescan.json`：\r\n\r\n```json\r\n{ \r\n  \"valuescanApiKey\": \"你的API Key\", \r\n  \"valuescanSecretKey\": \"你的Secret Key\" \r\n}\r\n````\r\n\r\n**签名约束**: Raw Body 必须与请求体完全一致，禁止格式化 | 签名SDK: `sdk/README.md`\r\n\r\n---\r\n\r\n## 核心参数\r\n\r\n| 参数                 | 说明                                       | 获取方式                                                                                                                                                    |\r\n| ------------------ | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |\r\n| `vsTokenId`        | 代币唯一标识                                   | 1. 调用 `/vs-token/list` 接口（参数 `search` 传代币符号如 `BTC`）；2. 从返回数据的 `id` 字段获取；3. 示例：`{ \"id\": 1, \"symbol\": \"BTC\", \"name\": \"Bitcoin\" }` 中 `id=1` 即为 `vsTokenId` |\r\n| `coinKey`          | 链上代币标识（格式： `{symbol}_{contractAddress}`） | 1. 先通过 `vsTokenId` 调用 `/vs-token/detail` 接口；2. 从返回的 `chainAddresses[].coinKey` 获取；3. 示例：`BTC` 返回 `\"BTC_BTC\"`，`ETH` 返回 `\"ETH_0x...\"`（原生代币无合约地址）          |\r\n| `address`          | 链上钱包地址                                   | 1. 调用 `持币地址` 接口获取某代币的持币地址列表；2. 或由用户直接提供；3. 格式为区块链标准地址（如 `0x...` 开头的以太坊地址）                                                                               |\r\n| `timeParticleEnum` | 时间粒度编码                                   | 按分析周期选择：`5`=5分钟, `15`=15分钟, `101`=1小时, `104`=4小时, `124`=24小时, `201`=1天, `207`=7天, `230`=30天                                                             |\r\n| `tradeType`        | 交易类型                                     | `1`=现货市场, `2`=合约/永续市场                                                                                                                                   |\r\n\r\n### 参数获取示例\r\n\r\n```\r\n# 场景：用户查询 BTC 的主力资金数据\r\n\r\nStep 1: 调用代币列表接口\r\nPOST /vs-token/list\r\nBody: { \"search\": \"btc\" }\r\n响应: { \"id\": 1, \"symbol\": \"BTC\", \"name\": \"Bitcoin\" }\r\n      → 获取 vsTokenId = 1\r\n\r\nStep 2: 调用代币详情（可选，获取coinKey）\r\nPOST /vs-token/detail\r\nBody: { \"vsTokenId\": 1 }\r\n响应: chainAddresses[0].coinKey = \"BTC_BTC\"\r\n      → 获取 coinKey = \"BTC_BTC\"（用于链上数据查询）\r\n\r\nStep 3: 使用 vsTokenId 调用目标接口\r\nPOST /trade/getCoinTrade\r\nBody: { \"vsTokenId\": 1, \"tradeType\": 1 }\r\n```\r\n\r\n---\r\n\r\n## 目录结构\r\n\r\n```\r\nvaluescan-skill-beta/\r\n├── SKILL.md                          # 技能文档\r\n├── _meta.json                        # 元信息\r\n├── references/                       # 接口参考文件\r\n│   ├── enums.json                    # 通用枚举定义\r\n│   │\r\n│   ├── base/                         # 基础数据\r\n│   │   ├── token-list.json           # 代币列表\r\n│   │   ├── token-detail.json         # 代币详情\r\n│   │   └── kline.json                # K线数据\r\n│   │\r\n│   ├── ai/                           # AI智选\r\n│   │   ├── chance-coin-list.json     # 机会代币列表\r\n│   │   ├── chance-coin-messages.json # 机会代币消息\r\n│   │   ├── risk-coin-list.json       # 风险代币列表\r\n│   │   ├── risk-coin-messages.json   # 风险代币消息\r\n│   │   ├── funds-coin-list.json      # 资金异动列表\r\n│   │   └── funds-coin-messages.json  # 资金异动消息\r\n│   │\r\n│   ├── fund/                         # 主力资金\r\n│   │   ├── realtime-fund.json        # 实时资金积累\r\n│   │   ├── fund-snapshot.json        # 资金快照\r\n│   │   ├── marketcap-ratio.json      # 资金市值比\r\n│   │   ├── coin-flow.json            # 代币流向\r\n│   │   └── cost.json                 # 主力成本\r\n│   │\r\n│   ├── category/                     # 板块资金\r\n│   │   ├── category-list.json        # 板块资金列表\r\n│   │   └── category-tokens.json      # 板块代币资金\r\n│   │\r\n│   ├── indicator/                    # 市场指标\r\n│   │   ├── price-market.json         # 主力行为指标\r\n│   │   ├── dense-area.json           # 压力支撑位\r\n│   │   └── sentiment.json            # 社媒情绪\r\n│   │\r\n│   └── chain/                        # 链上数据\r\n│       ├── large-trade.json          # 大额交易\r\n│       ├── holders.json              # 持币地址\r\n│       ├── balance-trend.json        # 余额趋势\r\n│       ├── profit-loss-trend.json    # 盈亏趋势\r\n│       ├── hold-trend.json           # 持仓趋势\r\n│       └── trade-count-trend.json    # 交易数量趋势\r\n│\r\n└── script/\r\n    └── sdk/                          # 签名SDK\r\n        ├── README.md                 # SDK说明\r\n        └── vs_api_sign.js            # JavaScript签名\r\n```\r\n\r\n---\r\n\r\n## 运行环境说明\r\n\r\n| 项目    | 说明                                       |\r\n| ----- | ---------------------------------------- |\r\n| SDK依赖 | Node.js: 内置crypto/fetch，无需额外依赖           |\r\n| 运行时要求 | Node.js 16+                              |\r\n| 本地资源  | references/ 目录下的 JSON 文件仅供接口定义参考，运行时无需加载 |\r\n| 安装安全性 | 本 Skill 无外部下载行为，所有依赖均为标准库或常用包            |\r\n\r\n---\r\n\r\n## API 文档\r\n\r\n详细 API 文档请参考：[https://beta-claw.valuescan.io/zh-CN/](https://beta-claw.valuescan.io/zh-CN/)\n\nFile v1.0.6:script/sdk/README.md\n\n# ValueScan API SDK\r\n\r\n## 使用步骤\r\n\r\n**1. 配置 API Key**\r\n\r\n访问 https://beta.valuescan.io/dev-portal/home/ 注册获取 API Key，保存到 `~/.openclaw/credentials/valuescan.json`:\r\n\r\n```json\r\n{\r\n  \"valuescanApiKey\": \"你的API Key\",\r\n  \"valuescanSecretKey\": \"你的Secret Key\"\r\n}\r\n```\r\n##  凭证说明\r\n\r\n本技能需要 ValueScan API 凭证用于请求签名：\r\n\r\n- 存储路径：`~/.openclaw/credentials/valuescan.json`\r\n- 签名方式：HMAC-SHA256\r\n- 数据用途：仅用于访问 ValueScan API，不会外传\r\n\r\n本技能不会收集或上传用户敏感信息。\r\n\r\n**2. SDK 调用**\r\n\r\n| 场景 | 方法 |\r\n|------|------|\r\n| 发送请求 | `vsPost(path, data)` |\r\n| 仅生成签名头 | `buildSignHeader(rawBody)` |\r\n\r\n**3. 调用示例**\r\n\r\n```javascript\r\nconst { vsPost } = require('./vs_api_sign');\r\nconst result = await vsPost('/api/open/v1/vs-token/list', {search: 'BTC'});\r\n```\r\n\r\n## 签名规范\r\n\r\n- **timestamp**: 13位毫秒时间戳（有效期5分钟）\r\n- **算法**: HMAC-SHA256(secret=Secret Key, message=timestamp + body_json)\r\n- **请求头**: `X-API-KEY`, `X-TIMESTAMP`, `X-SIGN`\r\n- **约束**: Raw Body 禁止格式化修改\n\nFile v1.0.6:_meta.json\n\n{\n  \"ownerId\": \"kn77r2vst0yn44kwc81rt8hz9s839z8m\",\n  \"slug\": \"mjc-test-destory\",\n  \"version\": \"1.0.6\",\n  \"publishedAt\": 1774345419833\n}\n\nFile v1.0.6:references/ai/chance-coin-list.json\n\n{\r\n  \"name\": \"机会代币列表\",\r\n  \"endpoint\": \"POST /ai/getChanceCoinList\",\r\n  \"description\": \"获取AI通过多维度数据，追踪当前行情下具有上涨潜力的代币列表\",\r\n  \"credits_cost\": 3,\r\n  \"needToken\": false,\r\n  \"use_case\": \"适用于当前行情下存在上涨行情机会的代币筛选和查询，适用于中短线交易者寻找具有上涨潜力的代币标的，适用于趋势跟踪策略中识别潜在上涨机会\",\r\n  \"update_frequency\": \"每 5 分钟更新一次\",\r\n  \"typeNote\": \"部分数值字段实际返回为字符串类型，使用时请注意类型转换\",\r\n  \"params\": {},\r\n  \"response\": {\r\n    \"vsTokenId\": { \"type\": \"long\", \"actualType\": \"string\", \"desc\": \"代币ID\" },\r\n    \"symbol\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"币种符号\" },\r\n    \"price\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"当前价格(USD)\" },\r\n    \"maxPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"历史最高价格(USD)\" },\r\n    \"minPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"历史最低价格(USD)\" },\r\n    \"percentChange1h\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"1小时价格变化百分比\" },\r\n    \"percentChange24h\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"24小时价格变化百分比\" },\r\n    \"percentChange7d\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"7天价格变化百分比\" },\r\n    \"percentChange30d\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"30天价格变化百分比\" },\r\n    \"percentChange60d\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"60天价格变化百分比\" },\r\n    \"percentChange90d\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"90天价格变化百分比\" },\r\n    \"cost\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"主力成本价格(USD)\" },\r\n    \"costChange\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"成本变化率\" },\r\n    \"deviation\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"价格偏离度(%)\" },\r\n    \"marketCap\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"市值(USD)\" },\r\n    \"marketCapRanking\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"市值排名\" },\r\n    \"circulatingSupply\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"流通供应量\" },\r\n    \"circulationRate\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"流通率(%)\" },\r\n    \"active\": { \"type\": \"integer\", \"actualType\": \"string\", \"desc\": \"24h活跃地址数\" },\r\n    \"newly\": { \"type\": \"integer\", \"actualType\": \"string\", \"desc\": \"24h新增地址数\" },\r\n    \"tradeType\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"交易类型（1:现货 2:合约 3:交割合约）\" },\r\n    \"chanceCoinTradeDataV1Vos\": {\r\n      \"type\": \"array\",\r\n      \"desc\": \"交易时间数据列表\",\r\n      \"item\": {\r\n        \"timeRange\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"时间范围标识（如m15, H4）\" },\r\n        \"timeParticleEnum\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"时间粒度枚举值\" },\r\n        \"tradeInflow\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"交易净流入金额(USD)\" },\r\n        \"tradeAmount\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"交易总金额(USD)\" }\r\n      }\r\n    },\r\n    \"updateTime\": { \"type\": \"long\", \"actualType\": \"long\", \"desc\": \"更新时间（毫秒时间戳）\" },\r\n    \"pushPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"入场推送价格(USD)\" },\r\n    \"pushMaxPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"推送后最高价(USD)\" },\r\n    \"gains\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"推送后涨幅(%)\" },\r\n    \"pushMinPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"推送后最低价(USD)\" },\r\n    \"declines\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"推送后跌幅(%)\" },\r\n    \"score\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"AI综合评分\" },\r\n    \"scoreChange\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"评分变化\" },\r\n    \"grade\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"机会等级(1-3, 3为最高)\" },\r\n    \"alpha\": { \"type\": \"boolean\", \"actualType\": \"boolean\", \"desc\": \"是否Alpha信号\" },\r\n    \"fomo\": { \"type\": \"boolean\", \"actualType\": \"boolean\", \"desc\": \"是否FOMO状态\" },\r\n    \"fomoEscalation\": { \"type\": \"boolean\", \"actualType\": \"boolean\", \"desc\": \"是否FOMO加剧\" },\r\n    \"bullishRatio\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"看涨情绪比例\" },\r\n    \"bearishRatio\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"看跌情绪比例\" }\r\n  },\r\n  \"field_meta\": {\r\n    \"cost\": { \"meaning\": \"主力成本价格\", \"range\": \"根据大额交易加权计算的主力持仓成本\", \"advice\": \"当前价格低于成本价时可能是买入机会\" },\r\n    \"deviation\": { \"meaning\": \"价格偏离度\", \"range\": \"(当前价格 - 主力成本) / 主力成本 * 100%\", \"advice\": \"负值表示低于成本，正值表示高于成本\" },\r\n    \"score\": { \"meaning\": \"AI综合评分\", \"range\": \"0-100，基于资金流、技术指标等综合计算\", \"advice\": \"评分<=45或>=80：待观察代币；45<评分<55：观察代币；55<评分<80：机会代币\" },\r\n    \"grade\": { \"meaning\": \"机会等级\", \"range\": \"1-3，3为最高等级\", \"advice\": \"等级越高表示风险越高\" },\r\n    \"pushPrice\": { \"meaning\": \"入场推送价格\", \"range\": \"系统首次推送该机会代币时的价格\", \"advice\": \"用于计算入场后的涨跌幅\" },\r\n    \"gains\": { \"meaning\": \"推送后涨幅\", \"range\": \"(pushMaxPrice - pushPrice) / pushPrice * 100%\", \"advice\": \"推送后的最大涨幅\" },\r\n    \"declines\": { \"meaning\": \"推送后跌幅\", \"range\": \"(pushPrice - pushMinPrice) / pushPrice * 100%\", \"advice\": \"推送后的最大跌幅\" },\r\n    \"alpha\": { \"meaning\": \"Alpha信号\", \"range\": \"布尔值，表示是否具有超额收益潜力\", \"advice\": \"true时关注度应更高\" },\r\n    \"fomo\": { \"meaning\": \"FOMO信号\", \"range\": \"布尔值，表示市场情绪是否过热\", \"advice\": \"true时需警惕追高风险\" },\r\n    \"fomoEscalation\": { \"meaning\": \"FOMO加剧\", \"range\": \"布尔值，FOMO状态进一步升级\", \"advice\": \"true时风险显著增加\" },\r\n    \"active\": { \"meaning\": \"24h活跃地址数\", \"range\": \"过去24小时内有交易的链上地址数量\", \"advice\": \"反映市场参与热度\" },\r\n    \"newly\": { \"meaning\": \"24h新增地址数\", \"range\": \"过去24小时内首次持有该代币的地址数量\", \"advice\": \"反映新资金流入\" },\r\n    \"bullishRatio\": { \"meaning\": \"看涨情绪比例\", \"range\": \"0-1，基于社媒分析\", \"advice\": \"越接近1表示市场越看涨\" },\r\n    \"bearishRatio\": { \"meaning\": \"看跌情绪比例\", \"range\": \"0-1，基于社媒分析\", \"advice\": \"越接近1表示市场越看跌\" },\r\n    \"tradeInflow\": { \"meaning\": \"交易净流入\", \"range\": \"正值为资金流入，负值为资金流出\", \"advice\": \"持续正值表示主力在吸筹\" }\r\n  },\r\n  \"enums\": {\r\n    \"tradeType\": { \"1\": \"现货\", \"2\": \"合约（永续）\", \"3\": \"交割合约\" },\r\n    \"timeParticleEnum\": { \"5\": \"5分钟\", \"15\": \"15分钟\", \"30\": \"30分钟\", \"101\": \"1小时\", \"104\": \"4小时\", \"124\": \"24小时\", \"201\": \"1天\", \"207\": \"7天\", \"230\": \"30天\" }\r\n  },\r\n  \"example\": {\r\n    \"req\": {},\r\n    \"res\": {\r\n      \"code\": 200,\r\n      \"data\": [\r\n        {\r\n          \"vsTokenId\": \"23335\",\r\n          \"symbol\": \"THE\",\r\n          \"price\": \"0.2792\",\r\n          \"maxPrice\": \"4.1032\",\r\n          \"minPrice\": \"0.0722\",\r\n          \"percentChange1h\": \"0.33\",\r\n          \"percentChange24h\": \"1.42\",\r\n          \"percentChange7d\": \"4.49\",\r\n          \"percentChange30d\": \"7.90\",\r\n          \"percentChange60d\": \"25.65\",\r\n          \"percentChange90d\": \"56.37\",\r\n          \"cost\": \"0.2709\",\r\n          \"costChange\": \"0.0625\",\r\n          \"deviation\": \"-1.42\",\r\n          \"marketCap\": \"36026970.95\",\r\n          \"marketCapRanking\": 312,\r\n          \"circulatingSupply\": \"128932942.42\",\r\n          \"circulationRate\": \"39.54\",\r\n          \"active\": \"347\",\r\n          \"newly\": \"347\",\r\n          \"tradeType\": 1,\r\n          \"chanceCoinTradeDataV1Vos\": [\r\n            { \"timeRange\": \"m15\", \"timeParticleEnum\": 15, \"tradeInflow\": \"460.63\", \"tradeAmount\": \"3213.51\" },\r\n            { \"timeRange\": \"m30\", \"timeParticleEnum\": 30, \"tradeInflow\": \"-338.10\", \"tradeAmount\": \"4455.51\" },\r\n            { \"timeRange\": \"H4\", \"timeParticleEnum\": 104, \"tradeInflow\": \"-5145.62\", \"tradeAmount\": \"37250.34\" }\r\n          ],\r\n          \"updateTime\": 1773016500000,\r\n          \"pushPrice\": \"0.2621\",\r\n          \"pushMaxPrice\": \"0.2806\",\r\n          \"gains\": 0.0,\r\n          \"pushMinPrice\": \"0.2587\",\r\n          \"declines\": 1.30,\r\n          \"score\": 45.0,\r\n          \"scoreChange\": 10.0,\r\n          \"grade\": 2,\r\n          \"alpha\": false,\r\n          \"fomo\": false,\r\n          \"fomoEscalation\": false,\r\n          \"bullishRatio\": 1.0,\r\n          \"bearishRatio\": 0.0\r\n        }\r\n      ]\r\n    }\r\n  }\r\n}\n\nFile v1.0.6:references/ai/chance-coin-messages.json\n\n{\r\n  \"name\": \"机会代币消息列表\",\r\n  \"endpoint\": \"POST /ai/getChanceCoinMessageList\",\r\n  \"description\": \"获取AI通过多数据维度，对当前行情下具有上涨潜力的代币的追踪消息数据\",\r\n  \"credits_cost\": 3,\r\n  \"needToken\": true,\r\n  \"use_case\": \"适用于当前行情下，对有上涨行情机会的代币，进行AI实时追踪的消息查询，适用于了解主力动作（入场、增持、减持、出逃等）\",\r\n  \"params\": {\r\n    \"vsTokenId\": { \"type\": \"long\", \"req\": true, \"desc\": \"代币ID\" }\r\n  },\r\n  \"response\": {\r\n    \"updateTime\": { \"type\": \"long\", \"actualType\": \"long\", \"desc\": \"更新时间\" },\r\n    \"vsTokenId\": { \"type\": \"long\", \"actualType\": \"string\", \"desc\": \"代币ID\" },\r\n    \"symbol\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"代币符号\" },\r\n    \"name\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"代币名称\" },\r\n    \"chanceMessageType\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"预测类型\" },\r\n    \"scoring\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"得分\" },\r\n    \"grade\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"等级\" },\r\n    \"price\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"币价\" },\r\n    \"percentChange24h\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"24小时涨跌幅\" },\r\n    \"gains\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"涨幅\" },\r\n    \"decline\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"跌幅\" }\r\n  },\r\n  \"field_meta\": {\r\n    \"chanceMessageType\": { \"meaning\": \"机会消息类型\", \"advice\": \"标识主力动作类型，如入场、增持、减持、出逃等\" },\r\n    \"scoring\": { \"meaning\": \"机会得分\", \"advice\": \"该信号的综合评分，分数越高信号越强\" },\r\n    \"grade\": { \"meaning\": \"机会等级\", \"advice\": \"信号等级划分，用于筛选重要信号\" }\r\n  },\r\n  \"example\": {\r\n    \"req\": { \"vsTokenId\": 23335 },\r\n    \"res\": {\r\n      \"code\": 200,\r\n      \"data\": [\r\n        {\r\n          \"updateTime\": 1773071700000,\r\n          \"vsTokenId\": \"23335\",\r\n          \"symbol\": \"THE\",\r\n          \"name\": \"THENA\",\r\n          \"chanceMessageType\": 30,\r\n          \"scoring\": 0.0,\r\n          \"grade\": 2,\r\n          \"price\": \"0.2742\",\r\n          \"percentChange24h\": 6.18,\r\n          \"gains\": 5.07,\r\n          \"decline\": 0.36\r\n        }\r\n      ]\r\n    }\r\n  }\r\n}\n\nFile v1.0.6:references/ai/funds-coin-list.json\n\n{\r\n  \"name\": \"资金异动代币列表\",\r\n  \"endpoint\": \"POST /ai/getFundsCoinList\",\r\n  \"description\": \"获取对指定代币在中心化交易所上，监控到现货或合约交易存在主力资金异动的代币列表\",\r\n  \"credits_cost\": 3,\r\n  \"needToken\": false,\r\n  \"use_case\": \"适用于实时监控在上涨或震荡行情中资金活跃且具有短期套利潜力的代币查询，适用于发现异常资金流动的代币\",\r\n  \"notes\": \"自然语言输入异动、资金看涨、异动看涨等词语时查询此接口；自然语言输入上涨机会、看涨代币等语言时可查询此接口，返回结果需注明资金异动看涨代币\",\r\n  \"update_frequency\": \"实时更新\",\r\n  \"params\": {},\r\n  \"response\": {\r\n    \"updateTime\": { \"type\": \"long\", \"actualType\": \"long\", \"desc\": \"更新时间\" },\r\n    \"tradeType\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"交易类型（1:现货 2:合约 3:交割合约）\" },\r\n    \"vsTokenId\": { \"type\": \"long\", \"actualType\": \"string\", \"desc\": \"代币ID\" },\r\n    \"symbol\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"交易符号\" },\r\n    \"name\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"代币名称\" },\r\n    \"startTime\": { \"type\": \"long\", \"actualType\": \"long\", \"desc\": \"开始时间\" },\r\n    \"endTime\": { \"type\": \"long\", \"actualType\": \"long\", \"desc\": \"结束时间\" },\r\n    \"number24h\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"24小时内的数量\" },\r\n    \"numberNot24h\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"非24小时内的数量\" },\r\n    \"price\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"价格\" },\r\n    \"pushPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"开始价格\" },\r\n    \"gains\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"涨幅\" },\r\n    \"decline\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"推送后跌幅(%)\" },\r\n    \"percentChange24h\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"24小时价格变化百分比\" },\r\n    \"marketCap\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"市值\" },\r\n    \"alpha\": { \"type\": \"boolean\", \"actualType\": \"boolean\", \"desc\": \"是否Alpha\" },\r\n    \"fomo\": { \"type\": \"boolean\", \"actualType\": \"boolean\", \"desc\": \"是否Fomo\" },\r\n    \"fomoEscalation\": { \"type\": \"boolean\", \"actualType\": \"boolean\", \"desc\": \"是否Fomo加剧\" },\r\n    \"bullishRatio\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"看涨情绪比例\" }\r\n  },\r\n  \"field_meta\": {\r\n    \"startTime\": { \"meaning\": \"异动开始时间\", \"range\": \"资金异动周期的起始时间\", \"advice\": \"用于了解异动持续时长\" },\r\n    \"endTime\": { \"meaning\": \"异动结束时间\", \"range\": \"资金异动周期的结束时间\", \"advice\": \"与startTime配合判断异动周期\" },\r\n    \"number24h\": { \"meaning\": \"短线行情异动\", \"range\": \"最近24小时内资金的异动次数检测\", \"advice\": \"次数越多表示异动越频繁\" },\r\n    \"numberNot24h\": { \"meaning\": \"趋势行情异动\", \"range\": \"3个月内的资金异动次数检测\", \"advice\": \"次数越多表示异动越频繁\" },\r\n    \"pushPrice\": { \"meaning\": \"异动推送价格\", \"range\": \"系统首次推送该异动代币时的价格\", \"advice\": \"用于计算入场后的涨跌幅\" },\r\n    \"alpha\": { \"meaning\": \"Alpha信号\", \"range\": \"布尔值，表示主力异常活跃或上涨可能高\", \"advice\": \"true时关注度应更高\" },\r\n    \"fomo\": { \"meaning\": \"FOMO信号\", \"range\": \"布尔值，表示市场情绪活跃，上涨趋势可能延续\", \"advice\": \"true时上涨延续可能性高，但需注意追高风险\" },\r\n    \"fomoEscalation\": { \"meaning\": \"FOMO加剧\", \"range\": \"布尔值，FOMO市场情绪过热，可能有突发风险\", \"advice\": \"true时风险显著增加\" }\r\n  },\r\n  \"enums\": {\r\n    \"tradeType\": { \"1\": \"现货\", \"2\": \"合约（永续）\", \"3\": \"交割合约\" }\r\n  },\r\n  \"example\": {\r\n    \"req\": {},\r\n    \"res\": {\r\n      \"code\": 200,\r\n      \"data\": [\r\n        {\r\n          \"updateTime\": 1773395400000,\r\n          \"tradeType\": 2,\r\n          \"vsTokenId\": \"22974\",\r\n          \"symbol\": \"TAO\",\r\n          \"name\": \"Bittensor\",\r\n          \"startTime\": 1773297600000,\r\n          \"endTime\": 1773395400000,\r\n          \"number24h\": 7,\r\n          \"numberNot24h\": 1,\r\n          \"price\": \"237.5\",\r\n          \"pushPrice\": \"205.7\",\r\n          \"gains\": 19.20,\r\n          \"declines\": 1.07,\r\n          \"percentChange24h\": \"4.56\",\r\n          \"marketCap\": \"2555201474.45\",\r\n          \"alpha\": true,\r\n          \"fomo\": false,\r\n          \"fomoEscalation\": false,\r\n          \"bullishRatio\": 0.56\r\n        }\r\n      ]\r\n    }\r\n  }\r\n}\n\nFile v1.0.6:references/ai/funds-coin-messages.json\n\n{\r\n  \"name\": \"资金异动代币消息列表\",\r\n  \"endpoint\": \"POST /ai/getFundsCoinMessageList\",\r\n  \"description\": \"获取对指定代币在中心化交易所上，现货或合约交易的主力资金异动的监控消息记录\",\r\n  \"credits_cost\": 3,\r\n  \"needToken\": true,\r\n  \"use_case\": \"适用于资金异动监控列表下的代币，在AI实时追踪过程中的消息查询，适用于查看历史资金异动信号记录，包括但不限于短线/趋势行情异动、Alpha、FOMO、止盈、止损等\",\r\n  \"notes\": \"信号类型需展示名称，出现多个alpha，fomo等消息时，统计各自出现的次数，同时出现时特别提醒；自然语言查询异动代币后，或查询异动信号，调用此接口；与资金异动代币列表接口配合使用，资金异动代币里的代币信号查询才调用此接口\",\r\n  \"params\": {\r\n    \"vsTokenId\": { \"type\": \"long\", \"req\": true, \"desc\": \"代币ID\" },\r\n    \"tradeType\": { \"type\": \"integer\", \"req\": true, \"desc\": \"交易类型（1:现货, 2:合约）\" }\r\n  },\r\n  \"response\": {\r\n    \"updateTime\": { \"type\": \"long\", \"actualType\": \"long\", \"desc\": \"更新时间\" },\r\n    \"vsTokenId\": { \"type\": \"long\", \"actualType\": \"string\", \"desc\": \"代币ID\" },\r\n    \"symbol\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"代币符号\" },\r\n    \"name\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"名称\" },\r\n    \"tradeType\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"交易类型（1:现货; 2:合约; 3:交割合约）\" },\r\n    \"price\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"币价\" },\r\n    \"percentChange24h\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"24小时涨跌幅\" },\r\n    \"fundsMovementType\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"资金流动类型\" }\r\n  },\r\n  \"field_meta\": {\r\n    \"fundsMovementType\": { \"meaning\": \"资金异动类型\", \"advice\": \"标识资金异动类型，如短线行情异动、趋势行情异动、Alpha等，同一时间多个类型时，可特别提醒，信号类型的对应关系不展示\" }\r\n  },\r\n  \"example\": {\r\n    \"req\": { \"vsTokenId\": 22974, \"tradeType\": 1 },\r\n    \"res\": {\r\n      \"code\": 200,\r\n      \"data\": [\r\n        {\r\n          \"updateTime\": 1773395700000,\r\n          \"vsTokenId\": \"22974\",\r\n          \"symbol\": \"TAO\",\r\n          \"name\": \"Bittensor\",\r\n          \"tradeType\": 1,\r\n          \"price\": \"241.4\",\r\n          \"percentChange24h\": 15.36,\r\n          \"fundsMovementType\": 6\r\n        }\r\n      ]\r\n    }\r\n  }\r\n}\n\nFile v1.0.6:references/ai/risk-coin-list.json\n\n{\r\n  \"name\": \"风险代币列表\",\r\n  \"endpoint\": \"POST /ai/getRiskCoinList\",\r\n  \"description\": \"获取AI通过多维度数据，追踪到当前行情下具有下跌风险趋势的代币列表\",\r\n  \"credits_cost\": 3,\r\n  \"needToken\": false,\r\n  \"use_case\": \"适用于当前行情下存在下跌行情风险的代币查询，适用于风险预警和持仓规避参考\",\r\n  \"update_frequency\": \"每 5 分钟更新一次\",\r\n  \"params\": {},\r\n  \"response\": {\r\n    \"vsTokenId\": { \"type\": \"long\", \"actualType\": \"string\", \"desc\": \"代币ID\" },\r\n    \"symbol\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"币种符号\" },\r\n    \"price\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"当前价格\" },\r\n    \"maxPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"最高价格\" },\r\n    \"minPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"最低价格\" },\r\n    \"percentChange1h\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"1小时价格变化百分比\" },\r\n    \"percentChange24h\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"24小时价格变化百分比\" },\r\n    \"percentChange7d\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"7天价格变化百分比\" },\r\n    \"percentChange30d\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"30天价格变化百分比\" },\r\n    \"percentChange60d\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"60天价格变化百分比\" },\r\n    \"percentChange90d\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"90天价格变化百分比\" },\r\n    \"cost\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"成本价格\" },\r\n    \"costChange\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"成本变化\" },\r\n    \"deviation\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"偏离度\" },\r\n    \"marketCap\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"市值\" },\r\n    \"marketCapRanking\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"市值排名\" },\r\n    \"circulatingSupply\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"流通供应量\" },\r\n    \"circulationRate\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"流通率\" },\r\n    \"active\": { \"type\": \"integer\", \"actualType\": \"string\", \"desc\": \"活跃地址\" },\r\n    \"newly\": { \"type\": \"integer\", \"actualType\": \"string\", \"desc\": \"新增地址\" },\r\n    \"tradeType\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"交易类型（1:现货 2:合约 3:交割合约）\" },\r\n    \"chanceCoinTradeDataV1Vos\": {\r\n      \"type\": \"array\",\r\n      \"desc\": \"交易时间数据列表\",\r\n      \"item\": {\r\n        \"timeRange\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"时间范围标识（如m15, H4）\" },\r\n        \"timeParticleEnum\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"时间粒度枚举值\" },\r\n        \"tradeInflow\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"交易净流入金额(USD)\" },\r\n        \"tradeAmount\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"交易总金额(USD)\" }\r\n      }\r\n    },\r\n    \"updateTime\": { \"type\": \"long\", \"actualType\": \"long\", \"desc\": \"更新时间\" },\r\n    \"pushPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"推送价格\" },\r\n    \"pushMaxPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"推送最高价\" },\r\n    \"gains\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"回撤\" },\r\n    \"pushMinPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"推送最低价\" },\r\n    \"declines\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"跌幅\" },\r\n    \"score\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"当前评分\" },\r\n    \"bullishRatio\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"看涨比例\" },\r\n    \"bearishRatio\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"看跌比例\" }\r\n  },\r\n  \"field_meta\": {\r\n    \"cost\": { \"meaning\": \"主力成本价格\", \"range\": \"根据大额交易加权计算的主力持仓成本\", \"advice\": \"当前价格高于成本价时主力可能获利了结\" },\r\n    \"deviation\": { \"meaning\": \"价格偏离度\", \"range\": \"(当前价格 - 主力成本) / 主力成本 * 100%\", \"advice\": \"正值过大时需警惕回调风险\" },\r\n    \"score\": { \"meaning\": \"AI风险评分\", \"range\": \"0-100，基于资金流、技术指标等综合计算\", \"advice\": \"评分<=45或>=80:待观察代币；45<评分<75:观察代币；75<评分<80：下跌风险代币\" },\r\n    \"pushPrice\": { \"meaning\": \"风险推送价格\", \"range\": \"系统首次推送该风险代币时的价格\", \"advice\": \"用于计算推送后的涨跌幅\" },\r\n    \"declines\": { \"meaning\": \"推送后跌幅\", \"range\": \"(pushPrice - pushMinPrice) / pushPrice * 100%\", \"advice\": \"验证风险预警的准确性\" },\r\n    \"tradeInflow\": { \"meaning\": \"交易净流入\", \"range\": \"正值为资金流入，负值为资金流出\", \"advice\": \"持续负值表示主力在出货\" }\r\n  },\r\n  \"enums\": {\r\n    \"tradeType\": { \"1\": \"现货\", \"2\": \"合约（永续）\", \"3\": \"交割合约\" },\r\n    \"timeParticleEnum\": { \"5\": \"5分钟\", \"15\": \"15分钟\", \"30\": \"30分钟\", \"101\": \"1小时\", \"104\": \"4小时\", \"106\": \"6小时\", \"124\": \"24小时\", \"201\": \"1天\", \"202\": \"2天\", \"207\": \"7天\", \"230\": \"30天\" }\r\n  },\r\n  \"example\": {\r\n    \"req\": {},\r\n    \"res\": {\r\n      \"code\": 200,\r\n      \"data\": [\r\n        {\r\n          \"vsTokenId\": \"38178\",\r\n          \"symbol\": \"TRUTH\",\r\n          \"price\": \"0.0094\",\r\n          \"maxPrice\": \"0.0502\",\r\n          \"minPrice\": \"0.0084\",\r\n          \"percentChange1h\": \"-0.42\",\r\n          \"percentChange24h\": \"-0.22\",\r\n          \"percentChange7d\": \"-0.64\",\r\n          \"percentChange30d\": \"-33.89\",\r\n          \"percentChange60d\": \"-36.71\",\r\n          \"percentChange90d\": \"-52.50\",\r\n          \"cost\": \"\",\r\n          \"costChange\": \"\",\r\n          \"deviation\": \"\",\r\n          \"marketCap\": \"19433307.40\",\r\n          \"marketCapRanking\": 427,\r\n          \"circulatingSupply\": \"2085305300\",\r\n          \"circulationRate\": \"20.85\",\r\n          \"active\": \"\",\r\n          \"newly\": \"\",\r\n          \"tradeType\": 2,\r\n          \"updateTime\": 1771287000000,\r\n          \"pushPrice\": \"0.0157\",\r\n          \"pushMaxPrice\": \"0.0163\",\r\n          \"gains\": 0.0,\r\n          \"pushMinPrice\": \"0.0088\",\r\n          \"declines\": 43.77,\r\n          \"score\": 36.5,\r\n          \"bullishRatio\": \"\",\r\n          \"bearishRatio\": \"\"\r\n        }\r\n      ]\r\n    }\r\n  }\r\n}\n\nFile v1.0.6:references/ai/risk-coin-messages.json\n\n{\r\n  \"name\": \"风险代币消息列表\",\r\n  \"endpoint\": \"POST /ai/getRiskCoinMessageList\",\r\n  \"description\": \"获取AI通过多数据维度，对当前行情下具有下跌风险趋势的代币的追踪消息数据\",\r\n  \"credits_cost\": 3,\r\n  \"needToken\": true,\r\n  \"use_case\": \"适用于当前行情下，对有下跌行情风险的代币，进行AI实时追踪的消息查询，适用于了解出货预警、下跌风险、反弹等风险信号\",\r\n  \"params\": {\r\n    \"vsTokenId\": { \"type\": \"long\", \"req\": true, \"desc\": \"代币ID\" }\r\n  },\r\n  \"response\": {\r\n    \"updateTime\": { \"type\": \"long\", \"actualType\": \"long\", \"desc\": \"更新时间\" },\r\n    \"vsTokenId\": { \"type\": \"long\", \"actualType\": \"string\", \"desc\": \"代币ID\" },\r\n    \"symbol\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"代币符号\" },\r\n    \"name\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"代币名称\" },\r\n    \"riskMessageType\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"预测类型\" },\r\n    \"scoring\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"得分\" },\r\n    \"grade\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"等级\" },\r\n    \"price\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"币价\" },\r\n    \"percentChange24h\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"24小时涨跌幅\" },\r\n    \"riskDecline\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"风险跌幅\" },\r\n    \"rebound\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"反弹\" }\r\n  },\r\n  \"field_meta\": {\r\n    \"riskMessageType\": { \"meaning\": \"风险消息类型\", \"advice\": \"标识风险信号类型，如出货预警、下跌风险、反弹等\" },\r\n    \"riskDecline\": { \"meaning\": \"风险跌幅\", \"advice\": \"推送后价格下跌幅度，用于验证风险预警准确性\" },\r\n    \"rebound\": { \"meaning\": \"反弹幅度\", \"advice\": \"价格下跌后的反弹程度\" }\r\n  },\r\n  \"example\": {\r\n    \"req\": { \"vsTokenId\": 38178 },\r\n    \"res\": {\r\n      \"code\": 200,\r\n      \"data\": [\r\n        {\r\n          \"updateTime\": 1771317300000,\r\n          \"vsTokenId\": \"38178\",\r\n          \"symbol\": \"TRUTH\",\r\n          \"name\": \"Swarm Network\",\r\n          \"riskMessageType\": 19,\r\n          \"scoring\": \"\",\r\n          \"grade\": \"\",\r\n          \"price\": \"0.0118\",\r\n          \"percentChange24h\": -2.32,\r\n          \"riskDecline\": 26.38,\r\n          \"rebound\": 6.61\r\n        }\r\n      ]\r\n    }\r\n  }\r\n}\n\nFile v1.0.6:references/base/kline.json\n\n{\r\n  \"name\": \"K 线数据\",\r\n  \"endpoint\": \"POST /trade/kline/getTradeKLineList\",\r\n  \"description\": \"获取K线数据，可查询指定代币（仅支持USDT交易对）和指定时间段内不超过1000条的K线数据\",\r\n  \"credits_cost\": 1,\r\n  \"needToken\": true,\r\n  \"use_case\": \"适用于查询不同时间窗口类型的K线数据查询，适用于结合价格K线判断买卖时机\",\r\n  \"update_frequency\": \"根据bucketType实时更新\",\r\n  \"params\": {\r\n    \"vsTokenId\": { \"type\": \"long\", \"req\": true, \"desc\": \"代币ID\" },\r\n    \"bucketType\": { \"type\": \"string\", \"req\": true, \"desc\": \"K线时间窗口类型(5m/15m/30m/1h/4h/1d/1w)\" },\r\n    \"startTime\": { \"type\": \"long\", \"req\": false, \"desc\": \"开始时间（毫秒时间戳）\" },\r\n    \"endTime\": { \"type\": \"long\", \"req\": true, \"desc\": \"结束时间（毫秒时间戳）\" },\r\n    \"size\": { \"type\": \"integer\", \"req\": false, \"desc\": \"查询记录数，默认360条，最大不超过1000条\" }\r\n  },\r\n  \"response\": {\r\n    \"vsTokenId\": { \"type\": \"long\", \"actualType\": \"string\", \"desc\": \"代币ID\" },\r\n    \"symbol\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"代币符号\" },\r\n    \"name\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"代币名称\" },\r\n    \"klineType\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"K线类型\" },\r\n    \"klineData\": {\r\n      \"type\": \"array\",\r\n      \"desc\": \"K线数据\",\r\n      \"item\": {\r\n        \"time\": { \"type\": \"long\", \"actualType\": \"long\", \"desc\": \"时间（毫秒时间戳）\" },\r\n        \"open\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"开盘价\" },\r\n        \"close\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"收盘价\" },\r\n        \"high\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"最高价\" },\r\n        \"low\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"最低价\" },\r\n        \"volume\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"成交量\" },\r\n        \"amount\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"成交额(USD)\" }\r\n      }\r\n    }\r\n  },\r\n  \"enums\": {\r\n    \"bucketType\": {\r\n      \"5m\": \"5分钟\",\r\n      \"15m\": \"15分钟\",\r\n      \"30m\": \"30分钟\",\r\n      \"1h\": \"1小时\",\r\n      \"4h\": \"4小时\",\r\n      \"1d\": \"1天\",\r\n      \"1w\": \"1周\"\r\n    }\r\n  },\r\n  \"example\": {\r\n    \"req\": { \"vsTokenId\": 1, \"bucketType\": \"5m\", \"endTime\": 1773478632535, \"size\": 20 },\r\n    \"res\": {\r\n      \"code\": 200,\r\n      \"data\": {\r\n        \"vsTokenId\": \"1\",\r\n        \"symbol\": \"BTC\",\r\n        \"name\": \"Bitcoin\",\r\n        \"klineType\": \"01\",\r\n        \"klineData\": [\r\n          { \"time\": 1773478200000, \"open\": \"70544.92\", \"close\": \"70594.48\", \"high\": \"70594.49\", \"low\": \"70536.58\", \"volume\": \"20.54\", \"amount\": \"1449509.94\" }\r\n        ]\r\n      }\r\n    }\r\n  }\r\n}\n\nFile v1.0.6:references/base/token-detail.json\n\n{\r\n  \"name\": \"代币详情\",\r\n  \"endpoint\": \"POST /vs-token/detail\",\r\n  \"description\": \"获取指定代币的基础信息，包括市场信息，链上基本信息，行情基本信息等\",\r\n  \"credits_cost\": 1,\r\n  \"needToken\": true,\r\n  \"use_case\": \"适用于代币的通用信息查询，适用于获取代币的完整信息，包括价格、市值、供应量等，适用于获取coinKey（调用链上数据接口的必要参数）\",\r\n  \"important\": \"chainAddresses数组中包含该代币在不同区块链上的coinKey，如需查询链上持仓地址、余额趋势等数据，需让用户选择目标链并缓存对应的coinKey\",\r\n  \"params\": {\r\n    \"vsTokenId\": { \"type\": \"long\", \"req\": true, \"desc\": \"代币ID\" }\r\n  },\r\n  \"response\": {\r\n    \"vsTokenId\": { \"type\": \"long\", \"actualType\": \"string\", \"desc\": \"代币ID\" },\r\n    \"name\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"代币名称\" },\r\n    \"symbol\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"代币符号\" },\r\n    \"oldSymbol\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"改名前的symbol\" },\r\n    \"price\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"当前价格(USD)\" },\r\n    \"highPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"历史最高价(USD)\" },\r\n    \"lowPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"历史最低价(USD)\" },\r\n    \"marketCapDominance\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"市值占比(%)\" },\r\n    \"volume24h\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"24H交易量(USD)\" },\r\n    \"volumeChange24h\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"24H交易量变化率(%)\" },\r\n    \"percentChange1h\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"1小时涨跌幅(%)\" },\r\n    \"percentChange24h\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"24小时涨跌幅(%)\" },\r\n    \"percentChange7d\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"7天涨跌幅(%)\" },\r\n    \"percentChange30d\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"30天涨跌幅(%)\" },\r\n    \"percentChange60d\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"60天涨跌幅(%)\" },\r\n    \"percentChange90d\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"90天涨跌幅(%)\" },\r\n    \"marketCap\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"市值(USD)\" },\r\n    \"totalSupply\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"总供应量\" },\r\n    \"circulationSupply\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"流通量\" },\r\n    \"maxSupply\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"最大供应量\" },\r\n    \"cost\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"链上持仓成本(USD)\" },\r\n    \"chainAddresses\": {\r\n      \"type\": \"array\",\r\n      \"desc\": \"各个链上信息\",\r\n      \"item\": {\r\n        \"contractAddress\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"合约地址\" },\r\n        \"chainName\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"链名\" },\r\n        \"holderCount\": { \"type\": \"integer\", \"actualType\": \"string\", \"desc\": \"持仓地址数\" },\r\n        \"transCount\": { \"type\": \"integer\", \"actualType\": \"string\", \"desc\": \"交易笔数\" },\r\n        \"issueDate\": { \"type\": \"long\", \"actualType\": \"long\", \"desc\": \"发行时间（毫秒时间戳）\" },\r\n        \"precision\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"精度\" },\r\n        \"totalSupply\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"该链上供应量\" },\r\n        \"coinKey\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"链上代币标识（调用链上数据接口的必要参数）\" }\r\n      }\r\n    }\r\n  },\r\n  \"example\": {\r\n    \"req\": { \"vsTokenId\": 1 },\r\n    \"res\": {\r\n      \"code\": 200,\r\n      \"data\": {\r\n        \"vsTokenId\": \"1\",\r\n        \"name\": \"Bitcoin\",\r\n        \"symbol\": \"BTC\",\r\n        \"oldSymbol\": \"\",\r\n        \"price\": \"70559.18\",\r\n        \"highPrice\": \"126198.07\",\r\n        \"lowPrice\": \"0.04864654\",\r\n        \"marketCapDominance\": \"\",\r\n        \"volume24h\": \"54389029990.50\",\r\n        \"volumeChange24h\": \"15.6056\",\r\n        \"percentChange1h\": \"-0.09\",\r\n        \"percentChange24h\": \"-1.29\",\r\n        \"percentChange7d\": \"3.96\",\r\n        \"percentChange30d\": \"5.35\",\r\n        \"percentChange60d\": \"-23.17\",\r\n        \"percentChange90d\": \"-21.71\",\r\n        \"marketCap\": \"1412725749093.27\",\r\n        \"totalSupply\": \"20001887\",\r\n        \"circulationSupply\": \"20001887\",\r\n        \"maxSupply\": \"21000000\",\r\n        \"cost\": \"60515.83\",\r\n        \"chainAddresses\": [\r\n          {\r\n            \"contractAddress\": \"BTC\",\r\n            \"chainName\": \"BTC\",\r\n            \"holderCount\": \"55905596\",\r\n            \"transCount\": \"1322741358\",\r\n            \"issueDate\": 1230998400000,\r\n            \"precision\": \"8\",\r\n            \"totalSupply\": \"20001892\",\r\n            \"coinKey\": \"BTC_BTC\"\r\n          }\r\n        ]\r\n      }\r\n    }\r\n  }\r\n}\n\nFile v1.0.6:references/base/token-list.json\n\n{\r\n  \"name\": \"代币列表\",\r\n  \"endpoint\": \"POST /vs-token/list\",\r\n  \"description\": \"获取ValueScan支持的代币列表，支持按代币全称或代币简称进行模糊搜索\",\r\n  \"credits_cost\": 1,\r\n  \"needToken\": false,\r\n  \"use_case\": \"这是基础接口，用于获取代币的vsTokenId，该ID是调用其他代币相关接口的必要参数。重要提示：当用户输入代币名称时，若存在多个同名或相近的代币（如不同链、不同标准），需引导用户选择目标代币，并缓存代币名称与vsTokenId的对应关系，以便后续接口调用时直接引用\",\r\n  \"params\": {\r\n    \"search\": { \"type\": \"string\", \"req\": false, \"desc\": \"搜索关键字（符号，支持模糊匹配），最大长度100字符，大小写不敏感\" }\r\n  },\r\n  \"response\": {\r\n    \"id\": { \"type\": \"long\", \"actualType\": \"long\", \"desc\": \"代币ID（即vsTokenId，用于其他接口调用）\" },\r\n    \"symbol\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"代币符号（如BTC, ETH）\" },\r\n    \"name\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"代币名称（如Bitcoin, Ethereum）\" }\r\n  },\r\n  \"example\": {\r\n    \"req\": { \"search\": \"btc\" },\r\n    \"res\": {\r\n      \"code\": 200,\r\n      \"data\": [\r\n        { \"id\": 1, \"symbol\": \"BTC\", \"name\": \"Bitcoin\" },\r\n        { \"id\": 33652, \"symbol\": \"LBTC\", \"name\": \"Lombard Staked BTC\" }\r\n      ]\r\n    }\r\n  }\r\n}\n\nArchive v1.0.5: 30 files, 41048 bytes\n\nFiles: _meta.json (135b), references/ai/chance-coin-list.json (8993b), references/ai/chance-coin-messages.json (2358b), references/ai/funds-coin-list.json (4643b), references/ai/funds-coin-messages.json (2495b), references/ai/risk-coin-list.json (5592b), references/ai/risk-coin-messages.json (2387b), references/base/kline.json (2729b), references/base/token-detail.json (4881b), references/base/token-list.json (1388b), references/category/category-list.json (2406b), references/category/category-tokens.json (2360b), references/chain/balance-trend.json (2004b), references/chain/hold-trend.json (2131b), references/chain/holders.json (3459b), references/chain/large-trade.json (2591b), references/chain/profit-loss-trend.json (2016b), references/chain/trade-count-trend.json (2408b), references/enums.json (8104b), references/fund/coin-flow.json (2668b), references/fund/cost.json (2171b), references/fund/fund-snapshot.json (3878b), references/fund/marketcap-ratio.json (2233b), references/fund/realtime-fund.json (4990b), references/indicator/dense-area.json (1408b), references/indicator/price-market.json (1508b), references/indicator/sentiment.json (2982b), script/sdk/README.md (1169b), script/sdk/vs_api_sign.js (3916b), SKILL.md (13804b)\n\nFile v1.0.5:SKILL.md\n\n---\r\nname: valuescan-skill-beta\r\ndescription: ValueScan 加密货币主力资金流分析工具。支持资金异动监控、主力动向追踪、鲸鱼地址分析、板块轮动、机会/风险代币识别、大户成本分析。\r\nuser-invocable: true\r\nhomepage: https://beta.valuescan.io\r\ncredentials:\r\n  - name: valuescan_api\r\n    type: file\r\n    path: ~/.openclaw/credentials/valuescan.json\r\n    required: true\r\n    description: ValueScan API Key 和 Secret，用于请求签名（HMAC-SHA256）\r\nenvironment:\r\n  - name: VALUESCAN_API_KEY\r\n    required: false\r\n  - name: VALUESCAN_SECRET\r\n    required: false\r\n---\r\n\r\n# ValueScan API\r\n\r\n加密货币主力资金流动向分析 API，追踪大户资金动向，让数据坐你的交易副驾驶。\r\n\r\n## 使用场景示例\r\n\r\n| 场景 | 通过 Skill 实现 |\r\n|:---|:---|\r\n| **行情信号** | 用户问：\"最近有哪些币出现主力异动？\" → 调用 `资金异动列表`。<br>用户问：\"BTC异动信号？\"→ 调用 `资金异动消息`。 |\r\n| **行情信号** | 用户问：\"最近有哪些币可能上涨\" → 调用 `资金异动列表`和<br>`机会代币列表`。用户问：\"BTC机会信号？\"→ 调用 `机会代币消息`。 |\r\n| **链上监控**   | 用户设置：“当 ETH 出现超过 1000 ETH 的大额转账时通知我。” → Skill 调用 `大额交易` 实现实时监控。 |\r\n| **投资决策**   | 用户问：“BTC 现在的压力位和支撑位在哪？” → Skill 调用 `压力支撑位` 提供数据。 |\r\n| **资金面分析** | 用户问：“过去一周，AI 板块的资金流向如何？” → Skill 调用 `板块资金列表` 获取板块轮动数据。 |\r\n| **地址分析**   | 用户提供地址：“帮我分析这个地址的持仓成本变化。” → Skill 调用 `持仓趋势` 返回建仓成本曲线。 |\r\n\r\n## 接口列表\r\n\r\n### 基础数据\r\n\r\n| 接口   | 用途                                              |\r\n| ------ | ------------------------------------------------- |\r\n| 代币列表 | 搜索代币，获取对应的 `vsTokenId` 等基础标识信息。 |\r\n| 代币详情 | 获取代币的实时价格、市值、`coinKey` 等详细信息。  |\r\n| K线数据 | 支持多时间窗口的 K 线数据查询，用于技术分析。     |\r\n\r\n### AI智选（无需vsTokenId）\r\n\r\nAI综合多维度数据，追踪当前行情下的具有上涨机会或有下跌风险的代币，并实时追踪主力行为，提供实时追踪信号，辅助市场判断。\r\n\r\n| 接口         | 用途                                                   |\r\n| ------------ | ------------------------------------------------------ |\r\n| 机会代币列表     | 追踪当前行情下具有上涨潜力的代币                       |\r\n| 机会代币消息     | 上涨潜力币的主力动向实时信号（如吸筹、突破、出逃等）。 |\r\n| 风险代币列表     | 当前行情下具有下跌风险趋势的代币                       |\r\n| 风险代币消息     | 下跌风险币的主力动向实时信号（如派发、破位、反弹等）。 |\r\n| 资金异动列表     | 上涨或震荡行情中资金活跃且具有短期套利潜力的代币       |\r\n| 资金异动消息     | 短线/趋势异动的实时信号（如主力入场、抛压等）。        |\r\n\r\n### 交易所主力资金监控（需要vsTokenId）\r\n\r\n监控中心化交易所（现货/合约）的资金流数据，追踪主力动向。\r\n\r\n| 接口           | 用途                                            |\r\n| -------------- | ----------------------------------------------- |\r\n| 实时资金积累       | 当日资金变化监控，反映主力实时流入/流出。       |\r\n| 资金快照           | 最近100天的资金积累趋势，用于中长期资金面分析。 |\r\n| 资金市值比         | 资金流入强度判断，辅助识别资金与市值匹配度。    |\r\n| 板块资金列表       | 板块轮动资金监控，快速定位热点赛道。            |\r\n| 板块代币资金       | 板块内龙头代币的实时资金积累数据。              |\r\n\r\n### 链上主力资金监控\r\n\r\n交易所的充/提资金监控，以及链上大户持仓成本变化监控，辅助主力行为追踪\r\n\r\n| 接口     | 用途                                          |\r\n| -------- | --------------------------------------------- |\r\n| 代币流向     | 链上与交易所之间的资金交互监控（充提数据）    |\r\n| 主力成本     | 大户平均持仓成本分析，识别主力建仓/出货位置。 |\r\n\r\n### 市场指标（需要vsTokenId）\r\n\r\nvaluescan特色指标数据，对关键位置具有重要参考价值\r\n\r\n| 接口         | 用途                                        |\r\n| ------------ | ------------------------------------------- |\r\n| 主力行为指标     | BTC/ETH 趋势判断，提供主力买卖行为信号。    |\r\n| 压力支撑位     | 关键价格位置（支撑/压力）计算，辅助交易决策 |\r\n| 社媒情绪        | 多空情绪分析，基于社交媒体热度与情绪指数。  |\r\n\r\n### 链上大额交易（需要vsTokenId）\r\n\r\n链上巨鲸交易监控，实时预警。\r\n\r\n| 接口     | 用途                         |\r\n| -------- | ---------------------------- |\r\n| 大额交易     | 鲸鱼在多链上的转账交易监控。 |\r\n\r\n### 链上持仓地址数据（需要coinKey，部分需address）\r\n\r\n| 接口           | 用途                                           |\r\n| -------------- | ---------------------------------------------- |\r\n| 持币地址           | 筹码集中度分析，查看地址数量与持仓分布。       |\r\n| 余额趋势           | 指定地址的持仓变化历史。                       |\r\n| 盈亏趋势           | 指定地址的投资绩效（盈利/亏损情况）。          |\r\n| 持仓趋势           | 指定地址的建仓成本分析（均价变化）。           |\r\n| 交易数量趋势       | 指定地址的交易活跃度（转账次数、频率）。       |\r\n\r\n---\r\n\r\n## 接口参考文件结构\r\n\r\n`references/` 目录下的每个接口 JSON 文件均遵循统一结构，包含以下字段：\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| `name` | string | 接口中文名称 |\r\n| `endpoint` | string | HTTP方法 + API路径（如 `POST /trade/getCoinTrade`） |\r\n| `description` | string | 接口功能描述 |\r\n| `credits_cost` | integer | 调用该接口消耗的积分数量 |\r\n| `needToken` | boolean | 是否需要认证（true/false） |\r\n| `use_case` | string | 业务使用场景说明，包含接口适用场景和使用建议 |\r\n| `notes` | string | 调用注意事项和重要提醒 |\r\n| `update_frequency` | string | 数据更新频率（如 `实时更新`） |\r\n| `sort` | string | 返回数据的排序规则 |\r\n| `typeNote` | string | 类型转换说明（如部分数值字段实际返回字符串） |\r\n| `params` | object | 请求参数定义，key 为参数名，value 含 `type`、`req`、`desc` |\r\n| `response` | object | 响应字段定义，含 `type`、`actualType`、`desc` |\r\n| `field_meta` | object | 字段业务含义，含 `meaning`（业务定义）、<br>`range`（取值范围）、`advice`（使用建议） |\r\n| `enums` | object | 枚举值映射表，定义关键字段的可选值含义 |\r\n| `example` | object | 请求/响应示例，含 `req`（请求体）和 `res`（响应体） |\r\n\r\n### 字段类型说明\r\n\r\n| type 值 | 说明 |\r\n|---------|------|\r\n| `long` / `integer` | 整数类型 |\r\n| `number` | 数值类型（可能实际返回字符串） |\r\n| `string` | 字符串类型 |\r\n| `boolean` | 布尔类型 |\r\n| `array` | 数组类型，含 `item` 定义元素结构 |\r\n\r\n### 关键字段解析\r\n\r\n#### 调用前必读字段\r\n\r\n| 字段 | 说明 |\r\n|------|------|\r\n| `params` | 请求参数定义，`req: true` 表示必填，`req: false` 表示可选。<br>调用前必须填入所有必填参数。 |\r\n| `notes` | 调用注意事项，包含接口使用限制、数据范围、业务约束等提示。 |\r\n| `enums` | 枚举值映射表。某些字段使用数字编码，需参照此表转换，<br>或从 `references/enums.json` 加载标准枚举定义。 |\r\n\r\n#### 返回解读字段\r\n\r\n| 字段 | 说明 |\r\n|------|------|\r\n| `response` | 响应字段定义，含字段名、`type`、`actualType`、`desc`。<br>用于解析返回数据结构。 |\r\n| `field_meta` | 核心业务字段解读，提供 `meaning`、`range`、`advice`。<br>解读返回数据时优先参考。 |\r\n| `typeNote` | 类型转换说明。部分接口的数值字段声明为 `number` 但实际返回 `string`，使用前需注意类型转换。 |\r\n| `example` | 请求/响应示例，包含 `req`（标准请求体格式）和 `res`（典型响应数据结构）。用于验证请求格式和理解返回数据。 |\r\n\r\n---\r\n\r\n## 快速开始\r\n\r\n**Base URL**: `https://api-beta.valuescan.io/api/open/v1`\r\n\r\n**认证**: HMAC-SHA256 签名\r\n\r\n```text\r\nX-API-KEY: 你的API Key\r\nX-TIMESTAMP: 13位毫秒时间戳\r\nX-SIGN: HMAC-SHA256(secret=Secret Key, message=timestamp+body_json)\r\n````\r\n\r\n**API Key**: 访问 <https://beta.valuescan.io/dev-portal/home/> 注册，保存到 `~/.openclaw/credentials/valuescan.json`：\r\n\r\n```json\r\n{ \r\n  \"valuescanApiKey\": \"你的API Key\", \r\n  \"valuescanSecretKey\": \"你的Secret Key\" \r\n}\r\n````\r\n\r\n**签名约束**: Raw Body 必须与请求体完全一致，禁止格式化 | 签名SDK: `sdk/README.md`\r\n\r\n---\r\n\r\n## 核心参数\r\n\r\n| 参数 | 说明 | 获取方式 |\r\n|:---|:---|:---|\r\n| `vsTokenId` | 代币唯一标识 | 1. 调用 `/vs-token/list`（参数 `search` 传代币符号）；<br>2. 从返回的 `id` 字段获取。 |\r\n| `coinKey` | 链上代币标识 | 1. 通过 `vsTokenId` 调用 `/vs-token/detail`；<br>2. 从 `chainAddresses[].coinKey` 获取。 |\r\n| `address` | 链上钱包地址 | 1. 调用 `持币地址` 接口获取；<br>2. 或用户直接提供。 |\r\n| `timeParticleEnum` | 时间粒度编码 | `5`=5分钟, `15`=15分钟, `101`=1小时,<br>`104`=4小时, `124`=24小时, `201`=1天,<br>`207`=7天, `230`=30天 |\r\n| `tradeType` | 交易类型 | `1`=现货市场, `2`=合约/永续市场 |\r\n\r\n### 参数获取示例\r\n\r\n```text\r\n# 场景：用户查询 BTC 的主力资金数据\r\n\r\nStep 1: 调用代币列表接口\r\nPOST /vs-token/list\r\nBody: { \"search\": \"btc\" }\r\n响应: { \"id\": 1, \"symbol\": \"BTC\", \"name\": \"Bitcoin\" }\r\n      → 获取 vsTokenId = 1\r\n\r\nStep 2: 调用代币详情（可选，获取coinKey）\r\nPOST /vs-token/detail\r\nBody: { \"vsTokenId\": 1 }\r\n响应: chainAddresses[0].coinKey = \"BTC_BTC\"\r\n      → 获取 coinKey = \"BTC_BTC\"（用于链上数据查询）\r\n\r\nStep 3: 使用 vsTokenId 调用目标接口\r\nPOST /trade/getCoinTrade\r\nBody: { \"vsTokenId\": 1, \"tradeType\": 1 }\r\n```\r\n\r\n---\r\n\r\n## 目录结构\r\n\r\n```text\r\nvaluescan-skill-beta/\r\n├── SKILL.md                          # 技能文档\r\n├── _meta.json                        # 元信息\r\n├── references/                       # 接口参考文件\r\n│   ├── enums.json                    # 通用枚举定义\r\n│   │\r\n│   ├── base/                         # 基础数据\r\n│   │   ├── token-list.json           # 代币列表\r\n│   │   ├── token-detail.json         # 代币详情\r\n│   │   └── kline.json                # K线数据\r\n│   │\r\n│   ├── ai/                           # AI智选\r\n│   │   ├── chance-coin-list.json     # 机会代币列表\r\n│   │   ├── chance-coin-messages.json # 机会代币消息\r\n│   │   ├── risk-coin-list.json       # 风险代币列表\r\n│   │   ├── risk-coin-messages.json   # 风险代币消息\r\n│   │   ├── funds-coin-list.json      # 资金异动列表\r\n│   │   └── funds-coin-messages.json  # 资金异动消息\r\n│   │\r\n│   ├── fund/                         # 主力资金\r\n│   │   ├── realtime-fund.json        # 实时资金积累\r\n│   │   ├── fund-snapshot.json        # 资金快照\r\n│   │   ├── marketcap-ratio.json      # 资金市值比\r\n│   │   ├── coin-flow.json            # 代币流向\r\n│   │   └── cost.json                 # 主力成本\r\n│   │\r\n│   ├── category/                     # 板块资金\r\n│   │   ├── category-list.json        # 板块资金列表\r\n│   │   └── category-tokens.json      # 板块代币资金\r\n│   │\r\n│   ├── indicator/                    # 市场指标\r\n│   │   ├── price-market.json         # 主力行为指标\r\n│   │   ├── dense-area.json           # 压力支撑位\r\n│   │   └── sentiment.json            # 社媒情绪\r\n│   │\r\n│   └── chain/                        # 链上数据\r\n│       ├── large-trade.json          # 大额交易\r\n│       ├── holders.json              # 持币地址\r\n│       ├── balance-trend.json        # 余额趋势\r\n│       ├── profit-loss-trend.json    # 盈亏趋势\r\n│       ├── hold-trend.json           # 持仓趋势\r\n│       └── trade-count-trend.json    # 交易数量趋势\r\n│\r\n└── script/\r\n    └── sdk/                          # 签名SDK\r\n        ├── README.md                 # SDK说明\r\n        └── vs_api_sign.js            # JavaScript签名\r\n```\r\n\r\n---\r\n\r\n## 运行环境说明\r\n\r\n| 项目 | 说明 |\r\n|:---|:---|\r\n| SDK依赖 | Node.js: 内置crypto/fetch，无需额外依赖 |\r\n| 运行时要求 | Node.js 16+ |\r\n| 本地资源 | references/ 目录下的 JSON 文件仅供接口定义参考 |\r\n| 安装安全性 | 本 Skill 无外部下载行为，依赖均为标准库 |\r\n\r\n---\r\n\r\n## API 文档\r\n\r\n详细 API 文档请参考：[https://beta-claw.valuescan.io/zh-CN/](https://beta-claw.valuescan.io/zh-CN/)\n\nFile v1.0.5:script/sdk/README.md\n\n# ValueScan API SDK\r\n\r\n## 使用步骤\r\n\r\n**1. 配置 API Key**\r\n\r\n访问 https://beta.valuescan.io/dev-portal/home/ 注册获取 API Key，保存到 `~/.openclaw/credentials/valuescan.json`:\r\n\r\n```json\r\n{\r\n  \"valuescanApiKey\": \"你的API Key\",\r\n  \"valuescanSecretKey\": \"你的Secret Key\"\r\n}\r\n```\r\n##  凭证说明\r\n\r\n本技能需要 ValueScan API 凭证用于请求签名：\r\n\r\n- 存储路径：`~/.openclaw/credentials/valuescan.json`\r\n- 签名方式：HMAC-SHA256\r\n- 数据用途：仅用于访问 ValueScan API，不会外传\r\n\r\n本技能不会收集或上传用户敏感信息。\r\n\r\n**2. SDK 调用**\r\n\r\n| 场景 | 方法 |\r\n|------|------|\r\n| 发送请求 | `vsPost(path, data)` |\r\n| 仅生成签名头 | `buildSignHeader(rawBody)` |\r\n\r\n**3. 调用示例**\r\n\r\n```javascript\r\nconst { vsPost } = require('./vs_api_sign');\r\nconst result = await vsPost('/api/open/v1/vs-token/list', {search: 'BTC'});\r\n```\r\n\r\n## 签名规范\r\n\r\n- **timestamp**: 13位毫秒时间戳（有效期5分钟）\r\n- **算法**: HMAC-SHA256(secret=Secret Key, message=timestamp + body_json)\r\n- **请求头**: `X-API-KEY`, `X-TIMESTAMP`, `X-SIGN`\r\n- **约束**: Raw Body 禁止格式化修改\n\nFile v1.0.5:_meta.json\n\n{\n  \"ownerId\": \"kn77r2vst0yn44kwc81rt8hz9s839z8m\",\n  \"slug\": \"mjc-test-destory\",\n  \"version\": \"1.0.5\",\n  \"publishedAt\": 1774259612661\n}\n\nFile v1.0.5:references/ai/chance-coin-list.json\n\n{\r\n  \"name\": \"机会代币列表\",\r\n  \"endpoint\": \"POST /ai/getChanceCoinList\",\r\n  \"description\": \"获取AI通过多维度数据，追踪当前行情下具有上涨潜力的代币列表\",\r\n  \"credits_cost\": 1,\r\n  \"needToken\": false,\r\n  \"use_case\": \"适用于当前行情下存在上涨行情机会的代币筛选和查询，适用于中短线交易者寻找具有上涨潜力的代币标的，适用于趋势跟踪策略中识别潜在上涨机会\",\r\n  \"update_frequency\": \"实时更新\",\r\n  \"sort\": \"按score（综合评分）降序排列\",\r\n  \"typeNote\": \"部分数值字段实际返回为字符串类型，使用时请注意类型转换\",\r\n  \"params\": {},\r\n  \"response\": {\r\n    \"vsTokenId\": { \"type\": \"long\", \"actualType\": \"string\", \"desc\": \"代币ID\" },\r\n    \"symbol\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"币种符号\" },\r\n    \"price\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"当前价格(USD)\" },\r\n    \"maxPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"历史最高价格(USD)\" },\r\n    \"minPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"历史最低价格(USD)\" },\r\n    \"percentChange1h\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"1小时价格变化百分比\" },\r\n    \"percentChange24h\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"24小时价格变化百分比\" },\r\n    \"percentChange7d\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"7天价格变化百分比\" },\r\n    \"percentChange30d\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"30天价格变化百分比\" },\r\n    \"percentChange60d\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"60天价格变化百分比\" },\r\n    \"percentChange90d\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"90天价格变化百分比\" },\r\n    \"cost\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"主力成本价格(USD)\" },\r\n    \"costChange\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"成本变化率\" },\r\n    \"deviation\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"价格偏离度(%)\" },\r\n    \"marketCap\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"市值(USD)\" },\r\n    \"marketCapRanking\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"市值排名\" },\r\n    \"circulatingSupply\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"流通供应量\" },\r\n    \"circulationRate\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"流通率(%)\" },\r\n    \"active\": { \"type\": \"integer\", \"actualType\": \"string\", \"desc\": \"24h活跃地址数\" },\r\n    \"newly\": { \"type\": \"integer\", \"actualType\": \"string\", \"desc\": \"24h新增地址数\" },\r\n    \"tradeType\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"交易类型（1:现货 2:合约 3:交割合约）\" },\r\n    \"chanceCoinTradeDataV1Vos\": {\r\n      \"type\": \"array\",\r\n      \"desc\": \"交易时间数据列表\",\r\n      \"item\": {\r\n        \"timeRange\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"时间范围标识（如m15, H4）\" },\r\n        \"timeParticleEnum\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"时间粒度枚举值\" },\r\n        \"tradeInflow\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"交易净流入金额(USD)\" },\r\n        \"tradeAmount\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"交易总金额(USD)\" }\r\n      }\r\n    },\r\n    \"updateTime\": { \"type\": \"long\", \"actualType\": \"long\", \"desc\": \"更新时间（毫秒时间戳）\" },\r\n    \"pushPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"入场推送价格(USD)\" },\r\n    \"pushMaxPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"推送后最高价(USD)\" },\r\n    \"gains\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"推送后涨幅(%)\" },\r\n    \"pushMinPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"推送后最低价(USD)\" },\r\n    \"declines\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"推送后跌幅(%)\" },\r\n    \"score\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"AI综合评分\" },\r\n    \"scoreChange\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"评分变化\" },\r\n    \"grade\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"机会等级(1-3, 3为最高)\" },\r\n    \"alpha\": { \"type\": \"boolean\", \"actualType\": \"boolean\", \"desc\": \"是否Alpha信号\" },\r\n    \"fomo\": { \"type\": \"boolean\", \"actualType\": \"boolean\", \"desc\": \"是否FOMO状态\" },\r\n    \"fomoEscalation\": { \"type\": \"boolean\", \"actualType\": \"boolean\", \"desc\": \"是否FOMO加剧\" },\r\n    \"bullishRatio\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"看涨情绪比例\" },\r\n    \"bearishRatio\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"看跌情绪比例\" }\r\n  },\r\n  \"field_meta\": {\r\n    \"cost\": { \"meaning\": \"主力成本价格\", \"range\": \"根据大额交易加权计算的主力持仓成本\", \"advice\": \"当前价格低于成本价时可能是买入机会\" },\r\n    \"deviation\": { \"meaning\": \"价格偏离度\", \"range\": \"(当前价格 - 主力成本) / 主力成本 * 100%\", \"advice\": \"负值表示低于成本，正值表示高于成本\" },\r\n    \"score\": { \"meaning\": \"AI综合评分\", \"range\": \"0-100，基于资金流、技术指标等综合计算\", \"advice\": \"评分<=45或>=80：待观察代币；45<评分<55：观察代币；55<评分<80：机会代币\" },\r\n    \"grade\": { \"meaning\": \"机会等级\", \"range\": \"1-3，3为最高等级\", \"advice\": \"等级越高表示风险越高\" },\r\n    \"pushPrice\": { \"meaning\": \"入场推送价格\", \"range\": \"系统首次推送该机会代币时的价格\", \"advice\": \"用于计算入场后的涨跌幅\" },\r\n    \"gains\": { \"meaning\": \"推送后涨幅\", \"range\": \"(pushMaxPrice - pushPrice) / pushPrice * 100%\", \"advice\": \"推送后的最大涨幅\" },\r\n    \"declines\": { \"meaning\": \"推送后跌幅\", \"range\": \"(pushPrice - pushMinPrice) / pushPrice * 100%\", \"advice\": \"推送后的最大跌幅\" },\r\n    \"alpha\": { \"meaning\": \"Alpha信号\", \"range\": \"布尔值，表示是否具有超额收益潜力\", \"advice\": \"true时关注度应更高\" },\r\n    \"fomo\": { \"meaning\": \"FOMO信号\", \"range\": \"布尔值，表示市场情绪是否过热\", \"advice\": \"true时需警惕追高风险\" },\r\n    \"fomoEscalation\": { \"meaning\": \"FOMO加剧\", \"range\": \"布尔值，FOMO状态进一步升级\", \"advice\": \"true时风险显著增加\" },\r\n    \"active\": { \"meaning\": \"24h活跃地址数\", \"range\": \"过去24小时内有交易的链上地址数量\", \"advice\": \"反映市场参与热度\" },\r\n    \"newly\": { \"meaning\": \"24h新增地址数\", \"range\": \"过去24小时内首次持有该代币的地址数量\", \"advice\": \"反映新资金流入\" },\r\n    \"bullishRatio\": { \"meaning\": \"看涨情绪比例\", \"range\": \"0-1，基于社媒分析\", \"advice\": \"越接近1表示市场越看涨\" },\r\n    \"bearishRatio\": { \"meaning\": \"看跌情绪比例\", \"range\": \"0-1，基于社媒分析\", \"advice\": \"越接近1表示市场越看跌\" },\r\n    \"tradeInflow\": { \"meaning\": \"交易净流入\", \"range\": \"正值为资金流入，负值为资金流出\", \"advice\": \"持续正值表示主力在吸筹\" }\r\n  },\r\n  \"enums\": {\r\n    \"tradeType\": { \"1\": \"现货\", \"2\": \"合约（永续）\", \"3\": \"交割合约\" },\r\n    \"timeParticleEnum\": { \"5\": \"5分钟\", \"15\": \"15分钟\", \"30\": \"30分钟\", \"101\": \"1小时\", \"104\": \"4小时\", \"124\": \"24小时\", \"201\": \"1天\", \"207\": \"7天\", \"230\": \"30天\" }\r\n  },\r\n  \"example\": {\r\n    \"req\": {},\r\n    \"res\": {\r\n      \"code\": 200,\r\n      \"data\": [\r\n        {\r\n          \"vsTokenId\": \"23335\",\r\n          \"symbol\": \"THE\",\r\n          \"price\": \"0.2792\",\r\n          \"maxPrice\": \"4.1032\",\r\n          \"minPrice\": \"0.0722\",\r\n          \"percentChange1h\": \"0.33\",\r\n          \"percentChange24h\": \"1.42\",\r\n          \"percentChange7d\": \"4.49\",\r\n          \"percentChange30d\": \"7.90\",\r\n          \"percentChange60d\": \"25.65\",\r\n          \"percentChange90d\": \"56.37\",\r\n          \"cost\": \"0.2709\",\r\n          \"costChange\": \"0.0625\",\r\n          \"deviation\": \"-1.42\",\r\n          \"marketCap\": \"36026970.95\",\r\n          \"marketCapRanking\": 312,\r\n          \"circulatingSupply\": \"128932942.42\",\r\n          \"circulationRate\": \"39.54\",\r\n          \"active\": \"347\",\r\n          \"newly\": \"347\",\r\n          \"tradeType\": 1,\r\n          \"chanceCoinTradeDataV1Vos\": [\r\n            { \"timeRange\": \"m15\", \"timeParticleEnum\": 15, \"tradeInflow\": \"460.63\", \"tradeAmount\": \"3213.51\" },\r\n            { \"timeRange\": \"m30\", \"timeParticleEnum\": 30, \"tradeInflow\": \"-338.10\", \"tradeAmount\": \"4455.51\" },\r\n            { \"timeRange\": \"H4\", \"timeParticleEnum\": 104, \"tradeInflow\": \"-5145.62\", \"tradeAmount\": \"37250.34\" }\r\n          ],\r\n          \"updateTime\": 1773016500000,\r\n          \"pushPrice\": \"0.2621\",\r\n          \"pushMaxPrice\": \"0.2806\",\r\n          \"gains\": 0.0,\r\n          \"pushMinPrice\": \"0.2587\",\r\n          \"declines\": 1.30,\r\n          \"score\": 45.0,\r\n          \"scoreChange\": 10.0,\r\n          \"grade\": 2,\r\n          \"alpha\": false,\r\n          \"fomo\": false,\r\n          \"fomoEscalation\": false,\r\n          \"bullishRatio\": 1.0,\r\n          \"bearishRatio\": 0.0\r\n        }\r\n      ]\r\n    }\r\n  }\r\n}\n\nFile v1.0.5:references/ai/chance-coin-messages.json\n\n{\r\n  \"name\": \"机会代币消息列表\",\r\n  \"endpoint\": \"POST /ai/getChanceCoinMessageList\",\r\n  \"description\": \"获取AI通过多数据维度，对当前行情下具有上涨潜力的代币的追踪消息数据\",\r\n  \"credits_cost\": 1,\r\n  \"needToken\": true,\r\n  \"use_case\": \"适用于当前行情下，对有上涨行情机会的代币，进行AI实时追踪的消息查询，适用于了解主力动作（入场、增持、减持、出逃等）\",\r\n  \"params\": {\r\n    \"vsTokenId\": { \"type\": \"long\", \"req\": true, \"desc\": \"代币ID\" }\r\n  },\r\n  \"response\": {\r\n    \"updateTime\": { \"type\": \"long\", \"actualType\": \"long\", \"desc\": \"更新时间\" },\r\n    \"vsTokenId\": { \"type\": \"long\", \"actualType\": \"string\", \"desc\": \"代币ID\" },\r\n    \"symbol\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"代币符号\" },\r\n    \"name\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"代币名称\" },\r\n    \"chanceMessageType\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"预测类型\" },\r\n    \"scoring\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"得分\" },\r\n    \"grade\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"等级\" },\r\n    \"price\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"币价\" },\r\n    \"percentChange24h\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"24小时涨跌幅\" },\r\n    \"gains\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"涨幅\" },\r\n    \"declines\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"跌幅\" }\r\n  },\r\n  \"field_meta\": {\r\n    \"chanceMessageType\": { \"meaning\": \"机会消息类型\", \"advice\": \"标识主力动作类型，如入场、增持、减持、出逃等\" },\r\n    \"scoring\": { \"meaning\": \"机会得分\", \"advice\": \"该信号的综合评分，分数越高信号越强\" },\r\n    \"grade\": { \"meaning\": \"机会等级\", \"advice\": \"信号等级划分，用于筛选重要信号\" }\r\n  },\r\n  \"example\": {\r\n    \"req\": { \"vsTokenId\": 23335 },\r\n    \"res\": {\r\n      \"code\": 200,\r\n      \"data\": [\r\n        {\r\n          \"updateTime\": 1773071700000,\r\n          \"vsTokenId\": \"23335\",\r\n          \"symbol\": \"THE\",\r\n          \"name\": \"THENA\",\r\n          \"chanceMessageType\": 30,\r\n          \"scoring\": 0.0,\r\n          \"grade\": 2,\r\n          \"price\": \"0.2742\",\r\n          \"percentChange24h\": 6.18,\r\n          \"gains\": 5.07,\r\n          \"declines\": 0.36\r\n        }\r\n      ]\r\n    }\r\n  }\r\n}\n\nFile v1.0.5:references/ai/funds-coin-list.json\n\n{\r\n  \"name\": \"资金异动代币列表\",\r\n  \"endpoint\": \"POST /ai/getFundsCoinList\",\r\n  \"description\": \"获取对指定代币在中心化交易所上，监控到现货或合约交易存在主力资金异动的代币列表\",\r\n  \"credits_cost\": 1,\r\n  \"needToken\": false,\r\n  \"use_case\": \"适用于实时监控在上涨或震荡行情中资金活跃且具有短期套利潜力的代币查询，适用于发现异常资金流动的代币\",\r\n  \"notes\": \"自然语言输入异动、资金看涨、异动看涨等词语时查询此接口；自然语言输入上涨机会、看涨代币等语言时可查询此接口，返回结果需注明资金异动看涨代币\",\r\n  \"update_frequency\": \"实时更新\",\r\n  \"sort\": \"按资金异动强度排列\",\r\n  \"params\": {},\r\n  \"response\": {\r\n    \"updateTime\": { \"type\": \"long\", \"actualType\": \"long\", \"desc\": \"更新时间\" },\r\n    \"tradeType\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"交易类型（1:现货 2:合约 3:交割合约）\" },\r\n    \"vsTokenId\": { \"type\": \"long\", \"actualType\": \"string\", \"desc\": \"代币ID\" },\r\n    \"symbol\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"交易符号\" },\r\n    \"name\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"代币名称\" },\r\n    \"startTime\": { \"type\": \"long\", \"actualType\": \"long\", \"desc\": \"开始时间\" },\r\n    \"endTime\": { \"type\": \"long\", \"actualType\": \"long\", \"desc\": \"结束时间\" },\r\n    \"number24h\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"24小时内的数量\" },\r\n    \"numberNot24h\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"非24小时内的数量\" },\r\n    \"price\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"价格\" },\r\n    \"pushPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"开始价格\" },\r\n    \"gains\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"涨幅\" },\r\n    \"declines\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"推送后跌幅(%)\" },\r\n    \"percentChange24h\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"24小时价格变化百分比\" },\r\n    \"marketCap\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"市值\" },\r\n    \"alpha\": { \"type\": \"boolean\", \"actualType\": \"boolean\", \"desc\": \"是否Alpha\" },\r\n    \"fomo\": { \"type\": \"boolean\", \"actualType\": \"boolean\", \"desc\": \"是否Fomo\" },\r\n    \"fomoEscalation\": { \"type\": \"boolean\", \"actualType\": \"boolean\", \"desc\": \"是否Fomo加剧\" },\r\n    \"bullishRatio\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"看涨情绪比例\" }\r\n  },\r\n  \"field_meta\": {\r\n    \"startTime\": { \"meaning\": \"异动开始时间\", \"range\": \"资金异动周期的起始时间\", \"advice\": \"用于了解异动持续时长\" },\r\n    \"endTime\": { \"meaning\": \"异动结束时间\", \"range\": \"资金异动周期的结束时间\", \"advice\": \"与startTime配合判断异动周期\" },\r\n    \"number24h\": { \"meaning\": \"短线行情异动\", \"range\": \"最近24小时内资金的异动次数检测\", \"advice\": \"次数越多表示异动越频繁\" },\r\n    \"numberNot24h\": { \"meaning\": \"趋势行情异动\", \"range\": \"3个月内的资金异动次数检测\", \"advice\": \"次数越多表示异动越频繁\" },\r\n    \"pushPrice\": { \"meaning\": \"异动推送价格\", \"range\": \"系统首次推送该异动代币时的价格\", \"advice\": \"用于计算入场后的涨跌幅\" },\r\n    \"alpha\": { \"meaning\": \"Alpha信号\", \"range\": \"布尔值，表示主力异常活跃或上涨可能高\", \"advice\": \"true时关注度应更高\" },\r\n    \"fomo\": { \"meaning\": \"FOMO信号\", \"range\": \"布尔值，表示市场情绪活跃，上涨趋势可能延续\", \"advice\": \"true时上涨延续可能性高，但需注意追高风险\" },\r\n    \"fomoEscalation\": { \"meaning\": \"FOMO加剧\", \"range\": \"布尔值，FOMO市场情绪过热，可能有突发风险\", \"advice\": \"true时风险显著增加\" }\r\n  },\r\n  \"enums\": {\r\n    \"tradeType\": { \"1\": \"现货\", \"2\": \"合约（永续）\", \"3\": \"交割合约\" }\r\n  },\r\n  \"example\": {\r\n    \"req\": {},\r\n    \"res\": {\r\n      \"code\": 200,\r\n      \"data\": [\r\n        {\r\n          \"updateTime\": 1773395400000,\r\n          \"tradeType\": 2,\r\n          \"vsTokenId\": \"22974\",\r\n          \"symbol\": \"TAO\",\r\n          \"name\": \"Bittensor\",\r\n          \"startTime\": 1773297600000,\r\n          \"endTime\": 1773395400000,\r\n          \"number24h\": 7,\r\n          \"numberNot24h\": 1,\r\n          \"price\": \"237.5\",\r\n          \"pushPrice\": \"205.7\",\r\n          \"gains\": 19.20,\r\n          \"declines\": 1.07,\r\n          \"percentChange24h\": \"4.56\",\r\n          \"marketCap\": \"2555201474.45\",\r\n          \"alpha\": true,\r\n          \"fomo\": false,\r\n          \"fomoEscalation\": false,\r\n          \"bullishRatio\": 0.56\r\n        }\r\n      ]\r\n    }\r\n  }\r\n}\n\nFile v1.0.5:references/ai/funds-coin-messages.json\n\n{\r\n  \"name\": \"资金异动代币消息列表\",\r\n  \"endpoint\": \"POST /ai/getFundsCoinMessageList\",\r\n  \"description\": \"获取对指定代币在中心化交易所上，现货或合约交易的主力资金异动的监控消息记录\",\r\n  \"credits_cost\": 1,\r\n  \"needToken\": true,\r\n  \"use_case\": \"适用于资金异动监控列表下的代币，在AI实时追踪过程中的消息查询，适用于查看历史资金异动信号记录，包括但不限于短线/趋势行情异动、Alpha、FOMO、止盈、止损等\",\r\n  \"notes\": \"信号类型需展示名称，出现多个alpha，fomo等消息时，统计各自出现的次数，同时出现时特别提醒；自然语言查询异动代币后，或查询异动信号，调用此接口；与资金异动代币列表接口配合使用，资金异动代币里的代币信号查询才调用此接口\",\r\n  \"params\": {\r\n    \"vsTokenId\": { \"type\": \"long\", \"req\": true, \"desc\": \"代币ID\" },\r\n    \"tradeType\": { \"type\": \"integer\", \"req\": true, \"desc\": \"交易类型（1:现货, 2:合约）\" }\r\n  },\r\n  \"response\": {\r\n    \"updateTime\": { \"type\": \"long\", \"actualType\": \"long\", \"desc\": \"更新时间\" },\r\n    \"vsTokenId\": { \"type\": \"long\", \"actualType\": \"string\", \"desc\": \"代币ID\" },\r\n    \"symbol\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"代币符号\" },\r\n    \"name\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"名称\" },\r\n    \"tradeType\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"交易类型（1:现货; 2:合约; 3:交割合约）\" },\r\n    \"price\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"币价\" },\r\n    \"percentChange24h\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"24小时涨跌幅\" },\r\n    \"fundsMovementType\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"资金流动类型\" }\r\n  },\r\n  \"field_meta\": {\r\n    \"fundsMovementType\": { \"meaning\": \"资金异动类型\", \"advice\": \"标识资金异动类型，如短线行情异动、趋势行情异动、Alpha等，同一时间多个类型时，可特别提醒，信号类型的对应关系不展示\" }\r\n  },\r\n  \"example\": {\r\n    \"req\": { \"vsTokenId\": 22974, \"tradeType\": 1 },\r\n    \"res\": {\r\n      \"code\": 200,\r\n      \"data\": [\r\n        {\r\n          \"updateTime\": 1773395700000,\r\n          \"vsTokenId\": \"22974\",\r\n          \"symbol\": \"TAO\",\r\n          \"name\": \"Bittensor\",\r\n          \"tradeType\": 1,\r\n          \"price\": \"241.4\",\r\n          \"percentChange24h\": 15.36,\r\n          \"fundsMovementType\": 6\r\n        }\r\n      ]\r\n    }\r\n  }\r\n}\n\nFile v1.0.5:references/ai/risk-coin-list.json\n\n{\r\n  \"name\": \"风险代币列表\",\r\n  \"endpoint\": \"POST /ai/getRiskCoinList\",\r\n  \"description\": \"获取AI通过多维度数据，追踪到当前行情下具有下跌风险趋势的代币列表\",\r\n  \"credits_cost\": 1,\r\n  \"needToken\": false,\r\n  \"use_case\": \"适用于当前行情下存在下跌行情风险的代币查询，适用于风险预警和持仓规避参考\",\r\n  \"update_frequency\": \"实时更新\",\r\n  \"sort\": \"按score（风险评分）排列\",\r\n  \"params\": {},\r\n  \"response\": {\r\n    \"vsTokenId\": { \"type\": \"long\", \"actualType\": \"string\", \"desc\": \"代币ID\" },\r\n    \"symbol\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"币种符号\" },\r\n    \"price\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"当前价格\" },\r\n    \"maxPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"最高价格\" },\r\n    \"minPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"最低价格\" },\r\n    \"percentChange1h\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"1小时价格变化百分比\" },\r\n    \"percentChange24h\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"24小时价格变化百分比\" },\r\n    \"percentChange7d\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"7天价格变化百分比\" },\r\n    \"percentChange30d\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"30天价格变化百分比\" },\r\n    \"percentChange60d\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"60天价格变化百分比\" },\r\n    \"percentChange90d\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"90天价格变化百分比\" },\r\n    \"cost\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"成本价格\" },\r\n    \"costChange\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"成本变化\" },\r\n    \"deviation\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"偏离度\" },\r\n    \"marketCap\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"市值\" },\r\n    \"marketCapRanking\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"市值排名\" },\r\n    \"circulatingSupply\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"流通供应量\" },\r\n    \"circulationRate\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"流通率\" },\r\n    \"active\": { \"type\": \"integer\", \"actualType\": \"string\", \"desc\": \"活跃地址\" },\r\n    \"newly\": { \"type\": \"integer\", \"actualType\": \"string\", \"desc\": \"新增地址\" },\r\n    \"tradeType\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"交易类型（1:现货 2:合约 3:交割合约）\" },\r\n    \"updateTime\": { \"type\": \"long\", \"actualType\": \"long\", \"desc\": \"更新时间\" },\r\n    \"pushPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"推送价格\" },\r\n    \"pushMaxPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"推送最高价\" },\r\n    \"gains\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"回撤\" },\r\n    \"pushMinPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"推送最低价\" },\r\n    \"declines\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"跌幅\" },\r\n    \"score\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"当前评分\" },\r\n    \"bullishRatio\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"看涨比例\" },\r\n    \"bearishRatio\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"看跌比例\" }\r\n  },\r\n  \"field_meta\": {\r\n    \"cost\": { \"meaning\": \"主力成本价格\", \"range\": \"根据大额交易加权计算的主力持仓成本\", \"advice\": \"当前价格高于成本价时主力可能获利了结\" },\r\n    \"deviation\": { \"meaning\": \"价格偏离度\", \"range\": \"(当前价格 - 主力成本) / 主力成本 * 100%\", \"advice\": \"正值过大时需警惕回调风险\" },\r\n    \"score\": { \"meaning\": \"AI风险评分\", \"range\": \"0-100，基于资金流、技术指标等综合计算\", \"advice\": \"评分<=45或>=80:待观察代币；45<评分<75:观察代币；75<评分<80：下跌风险代币\" },\r\n    \"pushPrice\": { \"meaning\": \"风险推送价格\", \"range\": \"系统首次推送该风险代币时的价格\", \"advice\": \"用于计算推送后的涨跌幅\" },\r\n    \"declines\": { \"meaning\": \"推送后跌幅\", \"range\": \"(pushPrice - pushMinPrice) / pushPrice * 100%\", \"advice\": \"验证风险预警的准确性\" },\r\n    \"tradeInflow\": { \"meaning\": \"交易净流入\", \"range\": \"正值为资金流入，负值为资金流出\", \"advice\": \"持续负值表示主力在出货\" }\r\n  },\r\n  \"enums\": {\r\n    \"tradeType\": { \"1\": \"现货\", \"2\": \"合约（永续）\", \"3\": \"交割合约\" }\r\n  },\r\n  \"example\": {\r\n    \"req\": {},\r\n    \"res\": {\r\n      \"code\": 200,\r\n      \"data\": [\r\n        {\r\n          \"vsTokenId\": \"38178\",\r\n          \"symbol\": \"TRUTH\",\r\n          \"price\": \"0.0094\",\r\n          \"maxPrice\": \"0.0502\",\r\n          \"minPrice\": \"0.0084\",\r\n          \"percentChange1h\": \"-0.42\",\r\n          \"percentChange24h\": \"-0.22\",\r\n          \"percentChange7d\": \"-0.64\",\r\n          \"percentChange30d\": \"-33.89\",\r\n          \"percentChange60d\": \"-36.71\",\r\n          \"percentChange90d\": \"-52.50\",\r\n          \"cost\": \"\",\r\n          \"costChange\": \"\",\r\n          \"deviation\": \"\",\r\n          \"marketCap\": \"19433307.40\",\r\n          \"marketCapRanking\": 427,\r\n          \"circulatingSupply\": \"2085305300\",\r\n          \"circulationRate\": \"20.85\",\r\n          \"active\": \"\",\r\n          \"newly\": \"\",\r\n          \"tradeType\": 2,\r\n          \"updateTime\": 1771287000000,\r\n          \"pushPrice\": \"0.0157\",\r\n          \"pushMaxPrice\": \"0.0163\",\r\n          \"gains\": 0.0,\r\n          \"pushMinPrice\": \"0.0088\",\r\n          \"declines\": 43.77,\r\n          \"score\": 36.5,\r\n          \"bullishRatio\": \"\",\r\n          \"bearishRatio\": \"\"\r\n        }\r\n      ]\r\n    }\r\n  }\r\n}\n\nFile v1.0.5:references/ai/risk-coin-messages.json\n\n{\r\n  \"name\": \"风险代币消息列表\",\r\n  \"endpoint\": \"POST /ai/getRiskCoinMessageList\",\r\n  \"description\": \"获取AI通过多数据维度，对当前行情下具有下跌风险趋势的代币的追踪消息数据\",\r\n  \"credits_cost\": 1,\r\n  \"needToken\": true,\r\n  \"use_case\": \"适用于当前行情下，对有下跌行情风险的代币，进行AI实时追踪的消息查询，适用于了解出货预警、下跌风险、反弹等风险信号\",\r\n  \"params\": {\r\n    \"vsTokenId\": { \"type\": \"long\", \"req\": true, \"desc\": \"代币ID\" }\r\n  },\r\n  \"response\": {\r\n    \"updateTime\": { \"type\": \"long\", \"actualType\": \"long\", \"desc\": \"更新时间\" },\r\n    \"vsTokenId\": { \"type\": \"long\", \"actualType\": \"string\", \"desc\": \"代币ID\" },\r\n    \"symbol\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"代币符号\" },\r\n    \"name\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"代币名称\" },\r\n    \"riskMessageType\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"预测类型\" },\r\n    \"scoring\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"得分\" },\r\n    \"grade\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"等级\" },\r\n    \"price\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"币价\" },\r\n    \"percentChange24h\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"24小时涨跌幅\" },\r\n    \"riskDecline\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"风险跌幅\" },\r\n    \"rebound\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"反弹\" }\r\n  },\r\n  \"field_meta\": {\r\n    \"riskMessageType\": { \"meaning\": \"风险消息类型\", \"advice\": \"标识风险信号类型，如出货预警、下跌风险、反弹等\" },\r\n    \"riskDecline\": { \"meaning\": \"风险跌幅\", \"advice\": \"推送后价格下跌幅度，用于验证风险预警准确性\" },\r\n    \"rebound\": { \"meaning\": \"反弹幅度\", \"advice\": \"价格下跌后的反弹程度\" }\r\n  },\r\n  \"example\": {\r\n    \"req\": { \"vsTokenId\": 38178 },\r\n    \"res\": {\r\n      \"code\": 200,\r\n      \"data\": [\r\n        {\r\n          \"updateTime\": 1771317300000,\r\n          \"vsTokenId\": \"38178\",\r\n          \"symbol\": \"TRUTH\",\r\n          \"name\": \"Swarm Network\",\r\n          \"riskMessageType\": 19,\r\n          \"scoring\": \"\",\r\n          \"grade\": \"\",\r\n          \"price\": \"0.0118\",\r\n          \"percentChange24h\": -2.32,\r\n          \"riskDecline\": 26.38,\r\n          \"rebound\": 6.61\r\n        }\r\n      ]\r\n    }\r\n  }\r\n}\n\nFile v1.0.5:references/base/kline.json\n\n{\r\n  \"name\": \"K 线数据\",\r\n  \"endpoint\": \"POST /trade/kline/getTradeKLineList\",\r\n  \"description\": \"获取K线数据，可查询指定代币（仅支持USDT交易对）和指定时间段内不超过1000条的K线数据\",\r\n  \"credits_cost\": 1,\r\n  \"needToken\": true,\r\n  \"use_case\": \"适用于查询不同时间窗口类型的K线数据查询，适用于结合价格K线判断买卖时机\",\r\n  \"update_frequency\": \"根据bucketType实时更新\",\r\n  \"params\": {\r\n    \"vsTokenId\": { \"type\": \"long\", \"req\": true, \"desc\": \"代币ID\" },\r\n    \"bucketType\": { \"type\": \"string\", \"req\": true, \"desc\": \"K线时间窗口类型(5m/15m/30m/1h/4h/1d/1w)\" },\r\n    \"startTime\": { \"type\": \"long\", \"req\": false, \"desc\": \"开始时间（毫秒时间戳）\" },\r\n    \"endTime\": { \"type\": \"long\", \"req\": true, \"desc\": \"结束时间（毫秒时间戳）\" },\r\n    \"size\": { \"type\": \"integer\", \"req\": false, \"desc\": \"查询记录数，默认360条，最大不超过1000条\" }\r\n  },\r\n  \"response\": {\r\n    \"vsTokenId\": { \"type\": \"long\", \"actualType\": \"string\", \"desc\": \"代币ID\" },\r\n    \"symbol\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"代币符号\" },\r\n    \"name\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"代币名称\" },\r\n    \"klineType\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"K线类型\" },\r\n    \"klineData\": {\r\n      \"type\": \"array\",\r\n      \"desc\": \"K线数据\",\r\n      \"item\": {\r\n        \"time\": { \"type\": \"long\", \"actualType\": \"long\", \"desc\": \"时间（毫秒时间戳）\" },\r\n        \"open\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"开盘价\" },\r\n        \"close\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"收盘价\" },\r\n        \"high\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"最高价\" },\r\n        \"low\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"最低价\" },\r\n        \"volume\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"成交量\" },\r\n        \"amount\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"成交额(USD)\" }\r\n      }\r\n    }\r\n  },\r\n  \"enums\": {\r\n    \"bucketType\": {\r\n      \"5m\": \"5分钟\",\r\n      \"15m\": \"15分钟\",\r\n      \"30m\": \"30分钟\",\r\n      \"1h\": \"1小时\",\r\n      \"4h\": \"4小时\",\r\n      \"1d\": \"1天\",\r\n      \"1w\": \"1周\"\r\n    }\r\n  },\r\n  \"example\": {\r\n    \"req\": { \"vsTokenId\": 1, \"bucketType\": \"5m\", \"endTime\": 1773478632535, \"size\": 20 },\r\n    \"res\": {\r\n      \"code\": 200,\r\n      \"data\": {\r\n        \"vsTokenId\": \"1\",\r\n        \"symbol\": \"BTC\",\r\n        \"name\": \"Bitcoin\",\r\n        \"klineType\": \"01\",\r\n        \"klineData\": [\r\n          { \"time\": 1773478200000, \"open\": \"70544.92\", \"close\": \"70594.48\", \"high\": \"70594.49\", \"low\": \"70536.58\", \"volume\": \"20.54\", \"amount\": \"1449509.94\" }\r\n        ]\r\n      }\r\n    }\r\n  }\r\n}\n\nFile v1.0.5:references/base/token-detail.json\n\n{\r\n  \"name\": \"代币详情\",\r\n  \"endpoint\": \"POST /vs-token/detail\",\r\n  \"description\": \"获取指定代币的基础信息，包括市场信息，链上基本信息，行情基本信息等\",\r\n  \"credits_cost\": 1,\r\n  \"needToken\": true,\r\n  \"use_case\": \"适用于代币的通用信息查询，适用于获取代币的完整信息，包括价格、市值、供应量等，适用于获取coinKey（调用链上数据接口的必要参数）\",\r\n  \"important\": \"chainAddresses数组中包含该代币在不同区块链上的coinKey，如需查询链上持仓地址、余额趋势等数据，需让用户选择目标链并缓存对应的coinKey\",\r\n  \"params\": {\r\n    \"vsTokenId\": { \"type\": \"long\", \"req\": true, \"desc\": \"代币ID\" }\r\n  },\r\n  \"response\": {\r\n    \"vsTokenId\": { \"type\": \"long\", \"actualType\": \"string\", \"desc\": \"代币ID\" },\r\n    \"name\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"代币名称\" },\r\n    \"symbol\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"代币符号\" },\r\n    \"oldSymbol\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"改名前的symbol\" },\r\n    \"price\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"当前价格(USD)\" },\r\n    \"highPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"历史最高价(USD)\" },\r\n    \"lowPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"历史最低价(USD)\" },\r\n    \"marketCapDominance\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"市值占比(%)\" },\r\n    \"volume24h\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"24H交易量(USD)\" },\r\n    \"volumeChange24h\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"24H交易量变化率(%)\" },\r\n    \"percentChange1h\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"1小时涨跌幅(%)\" },\r\n    \"percentChange24h\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"24小时涨跌幅(%)\" },\r\n    \"percentChange7d\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"7天涨跌幅(%)\" },\r\n    \"percentChange30d\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"30天涨跌幅(%)\" },\r\n    \"percentChange60d\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"60天涨跌幅(%)\" },\r\n    \"percentChange90d\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"90天涨跌幅(%)\" },\r\n    \"marketCap\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"市值(USD)\" },\r\n    \"totalSupply\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"总供应量\" },\r\n    \"circulationSupply\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"流通量\" },\r\n    \"maxSupply\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"最大供应量\" },\r\n    \"cost\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"链上持仓成本(USD)\" },\r\n    \"chainAddresses\": {\r\n      \"type\": \"array\",\r\n      \"desc\": \"各个链上信息\",\r\n      \"item\": {\r\n        \"contractAddress\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"合约地址\" },\r\n        \"chainName\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"链名\" },\r\n        \"holderCount\": { \"type\": \"integer\", \"actualType\": \"string\", \"desc\": \"持仓地址数\" },\r\n        \"transCount\": { \"type\": \"integer\", \"actualType\": \"string\", \"desc\": \"交易笔数\" },\r\n        \"issueDate\": { \"type\": \"long\", \"actualType\": \"long\", \"desc\": \"发行时间（毫秒时间戳）\" },\r\n        \"precision\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"精度\" },\r\n        \"totalSupply\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"该链上供应量\" },\r\n        \"coinKey\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"链上代币标识（调用链上数据接口的必要参数）\" }\r\n      }\r\n    }\r\n  },\r\n  \"example\": {\r\n    \"req\": { \"vsTokenId\": 1 },\r\n    \"res\": {\r\n      \"code\": 200,\r\n      \"data\": {\r\n        \"vsTokenId\": \"1\",\r\n        \"name\": \"Bitcoin\",\r\n        \"symbol\": \"BTC\",\r\n        \"oldSymbol\": \"\",\r\n        \"price\": \"70559.18\",\r\n        \"highPrice\": \"126198.07\",\r\n        \"lowPrice\": \"0.04864654\",\r\n        \"marketCapDominance\": \"\",\r\n        \"volume24h\": \"54389029990.50\",\r\n        \"volumeChange24h\": \"15.6056\",\r\n        \"percentChange1h\": \"-0.09\",\r\n        \"percentChange24h\": \"-1.29\",\r\n        \"percentChange7d\": \"3.96\",\r\n        \"percentChange30d\": \"5.35\",\r\n        \"percentChange60d\": \"-23.17\",\r\n        \"percentChange90d\": \"-21.71\",\r\n        \"marketCap\": \"1412725749093.27\",\r\n        \"totalSupply\": \"20001887\",\r\n        \"circulationSupply\": \"20001887\",\r\n        \"maxSupply\": \"21000000\",\r\n        \"cost\": \"60515.83\",\r\n        \"chainAddresses\": [\r\n          {\r\n            \"contractAddress\": \"BTC\",\r\n            \"chainName\": \"BTC\",\r\n            \"holderCount\": \"55905596\",\r\n            \"transCount\": \"1322741358\",\r\n            \"issueDate\": 1230998400000,\r\n            \"precision\": \"8\",\r\n            \"totalSupply\": \"20001892\",\r\n            \"coinKey\": \"BTC_BTC\"\r\n          }\r\n        ]\r\n      }\r\n    }\r\n  }\r\n}\n\nFile v1.0.5:references/base/token-list.json\n\n{\r\n  \"name\": \"代币列表\",\r\n  \"endpoint\": \"POST /vs-token/list\",\r\n  \"description\": \"获取ValueScan支持的代币列表，支持按代币全称或代币简称进行模糊搜索\",\r\n  \"credits_cost\": 1,\r\n  \"needToken\": false,\r\n  \"use_case\": \"这是基础接口，用于获取代币的vsTokenId，该ID是调用其他代币相关接口的必要参数。重要提示：当用户输入代币名称时，若存在多个同名或相近的代币（如不同链、不同标准），需引导用户选择目标代币，并缓存代币名称与vsTokenId的对应关系，以便后续接口调用时直接引用\",\r\n  \"params\": {\r\n    \"search\": { \"type\": \"string\", \"req\": false, \"desc\": \"搜索关键字（符号，支持模糊匹配），最大长度100字符，大小写不敏感\" }\r\n  },\r\n  \"response\": {\r\n    \"id\": { \"type\": \"long\", \"actualType\": \"long\", \"desc\": \"代币ID（即vsTokenId，用于其他接口调用）\" },\r\n    \"symbol\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"代币符号（如BTC, ETH）\" },\r\n    \"name\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"代币名称（如Bitcoin, Ethereum）\" }\r\n  },\r\n  \"example\": {\r\n    \"req\": { \"search\": \"btc\" },\r\n    \"res\": {\r\n      \"code\": 200,\r\n      \"data\": [\r\n        { \"id\": 1, \"symbol\": \"BTC\", \"name\": \"Bitcoin\" },\r\n        { \"id\": 33652, \"symbol\": \"LBTC\", \"name\": \"Lombard Staked BTC\" }\r\n      ]\r\n    }\r\n  }\r\n}\n\nArchive v1.0.4: 30 files, 41245 bytes\n\nFiles: _meta.json (135b), references/ai/chance-coin-list.json (8993b), references/ai/chance-coin-messages.json (2358b), references/ai/funds-coin-list.json (4643b), references/ai/funds-coin-messages.json (2495b), references/ai/risk-coin-list.json (5592b), references/ai/risk-coin-messages.json (2387b), references/base/kline.json (2729b), references/base/token-detail.json (4881b), references/base/token-list.json (1388b), references/category/category-list.json (2406b), references/category/category-tokens.json (2360b), references/chain/balance-trend.json (2004b), references/chain/hold-trend.json (2131b), references/chain/holders.json (3459b), references/chain/large-trade.json (2591b), references/chain/profit-loss-trend.json (2016b), references/chain/trade-count-trend.json (2408b), references/enums.json (8104b), references/fund/coin-flow.json (2668b), references/fund/cost.json (2171b), references/fund/fund-snapshot.json (3878b), references/fund/marketcap-ratio.json (2233b), references/fund/realtime-fund.json (4990b), references/indicator/dense-area.json (1408b), references/indicator/price-market.json (1508b), references/indicator/sentiment.json (2982b), script/sdk/README.md (881b), script/sdk/vs_api_sign.js (3916b), SKILL.md (15722b)\n\nFile v1.0.4:SKILL.md\n\n```\r\nname: valuescan-skill-beta\r\ndescription: ValueScan 加密货币主力资金流分析工具。支持资金异动监控、主力动向追踪、鲸鱼地址分析、板块轮动、机会/风险代币识别、大户成本分析。\r\nuser-invocable: true\r\nhomepage: https://beta.valuescan.io\r\ncredentials:\r\n  - name: valuescan_api\r\n    type: file\r\n    path: ~/.openclaw/credentials/valuescan.json\r\n    required: true\r\n    description: ValueScan API Key 和 Secret，用于请求签名（HMAC-SHA256）\r\nenvironment:\r\n  - name: VALUESCAN_API_KEY\r\n    required: false\r\n  - name: VALUESCAN_SECRET\r\n    required: false\r\n---\r\n\r\n# ValueScan API\r\n\r\n加密货币主力资金流动向分析 API，追踪大户资金动向，让数据坐你的交易副驾驶。\r\n\r\n## 使用场景示例\r\n\r\n| 场景           | 通过 Skill 实现                                              |\r\n| -------------- | ------------------------------------------------------------ |\r\n| **行情信号**   | 用户问：“最近有哪些币出现主力异动？” → Skill 调用 `资金异动列表` 返回结果。<br>用户问：“BTC主力资金异动信号有哪些？”→ Skill 调用 `资金异动消息` 返回结果。 |\r\n| **行情信号**   | 用户问：“最近有哪些币可能上涨” → Skill 调用 `资金异动列表`和  `机会代币列表`返回结果并说明场景     <br/>用户问：“BTC机会信号有哪些？”→ Skill 调用 `机会代币消息` 返回结果。 |\r\n| **链上监控**   | 用户设置：“当 ETH 出现超过 1000 ETH 的大额转账时通知我。” → Skill 调用 `大额交易` 实现实时监控。 |\r\n| **投资决策**   | 用户问：“BTC 现在的压力位和支撑位在哪？” → Skill 调用 `压力支撑位` 提供数据。 |\r\n| **资金面分析** | 用户问：“过去一周，AI 板块的资金流向如何？” → Skill 调用 `板块资金列表` 获取板块轮动数据。 |\r\n| **地址分析**   | 用户提供地址：“帮我分析这个地址的持仓成本变化。” → Skill 调用 `持仓趋势` 返回建仓成本曲线。 |\r\n\r\n## 接口列表\r\n\r\n### 基础数据\r\n\r\n| 接口   | 用途                                              |\r\n| ------ | ------------------------------------------------- |\r\n| 代币列表 | 搜索代币，获取对应的 `vsTokenId` 等基础标识信息。 |\r\n| 代币详情 | 获取代币的实时价格、市值、`coinKey` 等详细信息。  |\r\n| K线数据 | 支持多时间窗口的 K 线数据查询，用于技术分析。     |\r\n\r\n### AI智选（无需vsTokenId）\r\n\r\nAI综合多维度数据，追踪当前行情下的具有上涨机会或有下跌风险的代币，并实时追踪主力行为，提供实时追踪信号，辅助市场判断。\r\n\r\n| 接口         | 用途                                                   |\r\n| ------------ | ------------------------------------------------------ |\r\n| 机会代币列表     | 追踪当前行情下具有上涨潜力的代币                       |\r\n| 机会代币消息     | 上涨潜力币的主力动向实时信号（如吸筹、突破、出逃等）。 |\r\n| 风险代币列表     | 当前行情下具有下跌风险趋势的代币                       |\r\n| 风险代币消息     | 下跌风险币的主力动向实时信号（如派发、破位、反弹等）。 |\r\n| 资金异动列表     | 上涨或震荡行情中资金活跃且具有短期套利潜力的代币       |\r\n| 资金异动消息     | 短线/趋势异动的实时信号（如主力入场、抛压等）。        |\r\n\r\n### 交易所主力资金监控（需要vsTokenId）\r\n\r\n监控中心化交易所（现货/合约）的资金流数据，追踪主力动向。\r\n\r\n| 接口           | 用途                                            |\r\n| -------------- | ----------------------------------------------- |\r\n| 实时资金积累       | 当日资金变化监控，反映主力实时流入/流出。       |\r\n| 资金快照           | 最近100天的资金积累趋势，用于中长期资金面分析。 |\r\n| 资金市值比         | 资金流入强度判断，辅助识别资金与市值匹配度。    |\r\n| 板块资金列表       | 板块轮动资金监控，快速定位热点赛道。            |\r\n| 板块代币资金       | 板块内龙头代币的实时资金积累数据。              |\r\n\r\n### 链上主力资金监控\r\n\r\n交易所的充/提资金监控，以及链上大户持仓成本变化监控，辅助主力行为追踪\r\n\r\n| 接口     | 用途                                          |\r\n| -------- | --------------------------------------------- |\r\n| 代币流向     | 链上与交易所之间的资金交互监控（充提数据）    |\r\n| 主力成本     | 大户平均持仓成本分析，识别主力建仓/出货位置。 |\r\n\r\n### 市场指标（需要vsTokenId）\r\n\r\nvaluescan特色指标数据，对关键位置具有重要参考价值\r\n\r\n| 接口         | 用途                                        |\r\n| ------------ | ------------------------------------------- |\r\n| 主力行为指标     | BTC/ETH 趋势判断，提供主力买卖行为信号。    |\r\n| 压力支撑位     | 关键价格位置（支撑/压力）计算，辅助交易决策 |\r\n| 社媒情绪        | 多空情绪分析，基于社交媒体热度与情绪指数。  |\r\n\r\n### 链上大额交易（需要vsTokenId）\r\n\r\n链上巨鲸交易监控，实时预警。\r\n\r\n| 接口     | 用途                         |\r\n| -------- | ---------------------------- |\r\n| 大额交易     | 鲸鱼在多链上的转账交易监控。 |\r\n\r\n### 链上持仓地址数据（需要coinKey，部分需address）\r\n\r\n| 接口           | 用途                                           |\r\n| -------------- | ---------------------------------------------- |\r\n| 持币地址           | 筹码集中度分析，查看地址数量与持仓分布。       |\r\n| 余额趋势           | 指定地址的持仓变化历史。                       |\r\n| 盈亏趋势           | 指定地址的投资绩效（盈利/亏损情况）。          |\r\n| 持仓趋势           | 指定地址的建仓成本分析（均价变化）。           |\r\n| 交易数量趋势       | 指定地址的交易活跃度（转账次数、频率）。       |\r\n\r\n---\r\n\r\n## 接口参考文件结构\r\n\r\n`references/` 目录下的每个接口 JSON 文件均遵循统一结构，包含以下字段：\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| `name` | string | 接口中文名称 |\r\n| `endpoint` | string | HTTP方法 + API路径（如 `POST /trade/getCoinTrade`） |\r\n| `description` | string | 接口功能描述 |\r\n| `credits_cost` | integer | 调用该接口消耗的积分数量 |\r\n| `needToken` | boolean | 是否需要认证（true/false） |\r\n| `use_case` | string | 业务使用场景说明，包含接口适用场景和使用建议 |\r\n| `notes` | string | 调用注意事项和重要提醒 |\r\n| `update_frequency` | string | 数据更新频率（如 `实时更新`） |\r\n| `sort` | string | 返回数据的排序规则 |\r\n| `typeNote` | string | 类型转换说明（如部分数值字段实际返回字符串） |\r\n| `params` | object | 请求参数定义，key 为参数名，value 含 `type`、`req`、`desc` |\r\n| `response` | object | 响应字段定义，含 `type`、`actualType`、`desc` |\r\n| `field_meta` | object | 字段业务含义，含 `meaning`（业务定义）、`range`（取值范围）、`advice`（使用建议） |\r\n| `enums` | object | 枚举值映射表，定义关键字段的可选值含义 |\r\n| `example` | object | 请求/响应示例，含 `req`（请求体）和 `res`（响应体） |\r\n\r\n### 字段类型说明\r\n\r\n| type 值 | 说明 |\r\n|---------|------|\r\n| `long` / `integer` | 整数类型 |\r\n| `number` | 数值类型（可能实际返回字符串） |\r\n| `string` | 字符串类型 |\r\n| `boolean` | 布尔类型 |\r\n| `array` | 数组类型，含 `item` 定义元素结构 |\r\n\r\n### 关键字段解析\r\n\r\n#### 调用前必读字段\r\n\r\n| 字段 | 说明 |\r\n|------|------|\r\n| `params` | 请求参数定义，`req: true` 表示必填参数，`req: false` 表示可选参数。调用接口前必须检查并填入所有必填参数。 |\r\n| `notes` | 调用注意事项，包含接口使用限制、数据范围、业务约束等重要提示。必须阅读后再发起请求。 |\r\n| `enums` | 枚举值映射表。某些字段（如 `tradeType`、`timeParticleEnum`）使用数字编码，需参照此表转换为实际含义，或从 `references/enums.json` 加载标准枚举定义。 |\r\n\r\n#### 返回解读字段\r\n\r\n| 字段 | 说明 |\r\n|------|------|\r\n| `response` | 响应字段定义，包含字段名、`type`（声明类型）、`actualType`（实际类型）、`desc`（字段含义）。用于解析返回数据的结构和含义。 |\r\n| `field_meta` | 核心业务字段解读，提供字段的 `meaning`（业务定义）、`range`（取值范围）、`advice`（使用建议）。解读返回数据时优先参考此字段。 |\r\n| `typeNote` | 类型转换说明。部分接口的数值字段声明为 `number` 但实际返回 `string`，使用前需注意类型转换。 |\r\n| `example` | 请求/响应示例，包含 `req`（标准请求体格式）和 `res`（典型响应数据结构）。用于验证请求格式和理解返回数据。 |\r\n\r\n---\r\n\r\n## 快速开始\r\n\r\n**Base URL**: `https://api-beta.valuescan.io/api/open/v1`\r\n\r\n**认证**: HMAC-SHA256 签名\r\n\r\n```\r\n\r\nX-API-KEY: 你的API Key\r\nX-TIMESTAMP: 13位毫秒时间戳\r\nX-SIGN: HMAC-SHA256(secret=Secret Key, message=timestamp+body_json)\r\n\r\n````\r\n\r\n**API Key**: 访问 https://beta.valuescan.io/dev-portal/home/ 注册，保存到 `~/.openclaw/credentials/valuescan.json`：\r\n\r\n```json\r\n{ \r\n  \"valuescanApiKey\": \"你的API Key\", \r\n  \"valuescanSecretKey\": \"你的Secret Key\" \r\n}\r\n````\r\n\r\n**签名约束**: Raw Body 必须与请求体完全一致，禁止格式化 | 签名SDK: `sdk/README.md`\r\n\r\n---\r\n\r\n## 核心参数\r\n\r\n| 参数                 | 说明                                       | 获取方式                                                                                                                                                    |\r\n| ------------------ | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |\r\n| `vsTokenId`        | 代币唯一标识                                   | 1. 调用 `/vs-token/list` 接口（参数 `search` 传代币符号如 `BTC`）；2. 从返回数据的 `id` 字段获取；3. 示例：`{ \"id\": 1, \"symbol\": \"BTC\", \"name\": \"Bitcoin\" }` 中 `id=1` 即为 `vsTokenId` |\r\n| `coinKey`          | 链上代币标识（格式： `{symbol}_{contractAddress}`） | 1. 先通过 `vsTokenId` 调用 `/vs-token/detail` 接口；2. 从返回的 `chainAddresses[].coinKey` 获取；3. 示例：`BTC` 返回 `\"BTC_BTC\"`，`ETH` 返回 `\"ETH_0x...\"`（原生代币无合约地址）          |\r\n| `address`          | 链上钱包地址                                   | 1. 调用 `持币地址` 接口获取某代币的持币地址列表；2. 或由用户直接提供；3. 格式为区块链标准地址（如 `0x...` 开头的以太坊地址）                                                                               |\r\n| `timeParticleEnum` | 时间粒度编码                                   | 按分析周期选择：`5`=5分钟, `15`=15分钟, `101`=1小时, `104`=4小时, `124`=24小时, `201`=1天, `207`=7天, `230`=30天                                                             |\r\n| `tradeType`        | 交易类型                                     | `1`=现货市场, `2`=合约/永续市场                                                                                                                                   |\r\n\r\n### 参数获取示例\r\n\r\n```\r\n# 场景：用户查询 BTC 的主力资金数据\r\n\r\nStep 1: 调用代币列表接口\r\nPOST /vs-token/list\r\nBody: { \"search\": \"btc\" }\r\n响应: { \"id\": 1, \"symbol\": \"BTC\", \"name\": \"Bitcoin\" }\r\n      → 获取 vsTokenId = 1\r\n\r\nStep 2: 调用代币详情（可选，获取coinKey）\r\nPOST /vs-token/detail\r\nBody: { \"vsTokenId\": 1 }\r\n响应: chainAddresses[0].coinKey = \"BTC_BTC\"\r\n      → 获取 coinKey = \"BTC_BTC\"（用于链上数据查询）\r\n\r\nStep 3: 使用 vsTokenId 调用目标接口\r\nPOST /trade/getCoinTrade\r\nBody: { \"vsTokenId\": 1, \"tradeType\": 1 }\r\n```\r\n\r\n---\r\n\r\n## 目录结构\r\n\r\n```\r\nvaluescan-skill-beta/\r\n├── SKILL.md                          # 技能文档\r\n├── _meta.json                        # 元信息\r\n├── references/                       # 接口参考文件\r\n│   ├── enums.json                    # 通用枚举定义\r\n│   │\r\n│   ├── base/                         # 基础数据\r\n│   │   ├── token-list.json           # 代币列表\r\n│   │   ├── token-detail.json         # 代币详情\r\n│   │   └── kline.json                # K线数据\r\n│   │\r\n│   ├── ai/                           # AI智选\r\n│   │   ├── chance-coin-list.json     # 机会代币列表\r\n│   │   ├── chance-coin-messages.json # 机会代币消息\r\n│   │   ├── risk-coin-list.json       # 风险代币列表\r\n│   │   ├── risk-coin-messages.json   # 风险代币消息\r\n│   │   ├── funds-coin-list.json      # 资金异动列表\r\n│   │   └── funds-coin-messages.json  # 资金异动消息\r\n│   │\r\n│   ├── fund/                         # 主力资金\r\n│   │   ├── realtime-fund.json        # 实时资金积累\r\n│   │   ├── fund-snapshot.json        # 资金快照\r\n│   │   ├── marketcap-ratio.json      # 资金市值比\r\n│   │   ├── coin-flow.json            # 代币流向\r\n│   │   └── cost.json                 # 主力成本\r\n│   │\r\n│   ├── category/                     # 板块资金\r\n│   │   ├── category-list.json        # 板块资金列表\r\n│   │   └── category-tokens.json      # 板块代币资金\r\n│   │\r\n│   ├── indicator/                    # 市场指标\r\n│   │   ├── price-market.json         # 主力行为指标\r\n│   │   ├── dense-area.json           # 压力支撑位\r\n│   │   └── sentiment.json            # 社媒情绪\r\n│   │\r\n│   └── chain/                        # 链上数据\r\n│       ├── large-trade.json          # 大额交易\r\n│       ├── holders.json              # 持币地址\r\n│       ├── balance-trend.json        # 余额趋势\r\n│       ├── profit-loss-trend.json    # 盈亏趋势\r\n│       ├── hold-trend.json           # 持仓趋势\r\n│       └── trade-count-trend.json    # 交易数量趋势\r\n│\r\n└── script/\r\n    └── sdk/                          # 签名SDK\r\n        ├── README.md                 # SDK说明\r\n        └── vs_api_sign.js            # JavaScript签名\r\n```\r\n\r\n---\r\n\r\n## 运行环境说明\r\n\r\n| 项目    | 说明                                       |\r\n| ----- | ---------------------------------------- |\r\n| SDK依赖 | Node.js: 内置crypto/fetch，无需额外依赖           |\r\n| 运行时要求 | Node.js 16+                              |\r\n| 本地资源  | references/ 目录下的 JSON 文件仅供接口定义参考，运行时无需加载 |\r\n| 安装安全性 | 本 Skill 无外部下载行为，所有依赖均为标准库或常用包            |\r\n\r\n---\r\n\r\n## API 文档\r\n\r\n详细 API 文档请参考：[https://beta-claw.valuescan.io/zh-CN/](https://beta-claw.valuescan.io/zh-CN/)\n\nFile v1.0.4:script/sdk/README.md\n\n# ValueScan API SDK\r\n\r\n## 使用步骤\r\n\r\n**1. 配置 API Key**\r\n\r\n访问 https://beta.valuescan.io/dev-portal/home/ 注册获取 API Key，保存到 `~/.openclaw/credentials/valuescan.json`:\r\n\r\n```json\r\n{\r\n  \"valuescanApiKey\": \"你的API Key\",\r\n  \"valuescanSecretKey\": \"你的Secret Key\"\r\n}\r\n```\r\n\r\n**2. SDK 调用**\r\n\r\n| 场景 | 方法 |\r\n|------|------|\r\n| 发送请求 | `vsPost(path, data)` |\r\n| 仅生成签名头 | `buildSignHeader(rawBody)` |\r\n\r\n**3. 调用示例**\r\n\r\n```javascript\r\nconst { vsPost } = require('./vs_api_sign');\r\nconst result = await vsPost('/api/open/v1/vs-token/list', {search: 'BTC'});\r\n```\r\n\r\n## 签名规范\r\n\r\n- **timestamp**: 13位毫秒时间戳（有效期5分钟）\r\n- **算法**: HMAC-SHA256(secret=Secret Key, message=timestamp + body_json)\r\n- **请求头**: `X-API-KEY`, `X-TIMESTAMP`, `X-SIGN`\r\n- **约束**: Raw Body 禁止格式化修改\n\nFile v1.0.4:_meta.json\n\n{\n  \"ownerId\": \"kn77r2vst0yn44kwc81rt8hz9s839z8m\",\n  \"slug\": \"mjc-test-destory\",\n  \"version\": \"1.0.4\",\n  \"publishedAt\": 1774259073208\n}\n\nFile v1.0.4:references/ai/chance-coin-list.json\n\n{\r\n  \"name\": \"机会代币列表\",\r\n  \"endpoint\": \"POST /ai/getChanceCoinList\",\r\n  \"description\": \"获取AI通过多维度数据，追踪当前行情下具有上涨潜力的代币列表\",\r\n  \"credits_cost\": 1,\r\n  \"needToken\": false,\r\n  \"use_case\": \"适用于当前行情下存在上涨行情机会的代币筛选和查询，适用于中短线交易者寻找具有上涨潜力的代币标的，适用于趋势跟踪策略中识别潜在上涨机会\",\r\n  \"update_frequency\": \"实时更新\",\r\n  \"sort\": \"按score（综合评分）降序排列\",\r\n  \"typeNote\": \"部分数值字段实际返回为字符串类型，使用时请注意类型转换\",\r\n  \"params\": {},\r\n  \"response\": {\r\n    \"vsTokenId\": { \"type\": \"long\", \"actualType\": \"string\", \"desc\": \"代币ID\" },\r\n    \"symbol\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"币种符号\" },\r\n    \"price\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"当前价格(USD)\" },\r\n    \"maxPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"历史最高价格(USD)\" },\r\n    \"minPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"历史最低价格(USD)\" },\r\n    \"percentChange1h\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"1小时价格变化百分比\" },\r\n    \"percentChange24h\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"24小时价格变化百分比\" },\r\n    \"percentChange7d\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"7天价格变化百分比\" },\r\n    \"percentChange30d\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"30天价格变化百分比\" },\r\n    \"percentChange60d\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"60天价格变化百分比\" },\r\n    \"percentChange90d\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"90天价格变化百分比\" },\r\n    \"cost\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"主力成本价格(USD)\" },\r\n    \"costChange\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"成本变化率\" },\r\n    \"deviation\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"价格偏离度(%)\" },\r\n    \"marketCap\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"市值(USD)\" },\r\n    \"marketCapRanking\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"市值排名\" },\r\n    \"circulatingSupply\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"流通供应量\" },\r\n    \"circulationRate\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"流通率(%)\" },\r\n    \"active\": { \"type\": \"integer\", \"actualType\": \"string\", \"desc\": \"24h活跃地址数\" },\r\n    \"newly\": { \"type\": \"integer\", \"actualType\": \"string\", \"desc\": \"24h新增地址数\" },\r\n    \"tradeType\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"交易类型（1:现货 2:合约 3:交割合约）\" },\r\n    \"chanceCoinTradeDataV1Vos\": {\r\n      \"type\": \"array\",\r\n      \"desc\": \"交易时间数据列表\",\r\n      \"item\": {\r\n        \"timeRange\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"时间范围标识（如m15, H4）\" },\r\n        \"timeParticleEnum\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"时间粒度枚举值\" },\r\n        \"tradeInflow\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"交易净流入金额(USD)\" },\r\n        \"tradeAmount\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"交易总金额(USD)\" }\r\n      }\r\n    },\r\n    \"updateTime\": { \"type\": \"long\", \"actualType\": \"long\", \"desc\": \"更新时间（毫秒时间戳）\" },\r\n    \"pushPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"入场推送价格(USD)\" },\r\n    \"pushMaxPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"推送后最高价(USD)\" },\r\n    \"gains\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"推送后涨幅(%)\" },\r\n    \"pushMinPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"推送后最低价(USD)\" },\r\n    \"declines\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"推送后跌幅(%)\" },\r\n    \"score\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"AI综合评分\" },\r\n    \"scoreChange\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"评分变化\" },\r\n    \"grade\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"机会等级(1-3, 3为最高)\" },\r\n    \"alpha\": { \"type\": \"boolean\", \"actualType\": \"boolean\", \"desc\": \"是否Alpha信号\" },\r\n    \"fomo\": { \"type\": \"boolean\", \"actualType\": \"boolean\", \"desc\": \"是否FOMO状态\" },\r\n    \"fomoEscalation\": { \"type\": \"boolean\", \"actualType\": \"boolean\", \"desc\": \"是否FOMO加剧\" },\r\n    \"bullishRatio\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"看涨情绪比例\" },\r\n    \"bearishRatio\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"看跌情绪比例\" }\r\n  },\r\n  \"field_meta\": {\r\n    \"cost\": { \"meaning\": \"主力成本价格\", \"range\": \"根据大额交易加权计算的主力持仓成本\", \"advice\": \"当前价格低于成本价时可能是买入机会\" },\r\n    \"deviation\": { \"meaning\": \"价格偏离度\", \"range\": \"(当前价格 - 主力成本) / 主力成本 * 100%\", \"advice\": \"负值表示低于成本，正值表示高于成本\" },\r\n    \"score\": { \"meaning\": \"AI综合评分\", \"range\": \"0-100，基于资金流、技术指标等综合计算\", \"advice\": \"评分<=45或>=80：待观察代币；45<评分<55：观察代币；55<评分<80：机会代币\" },\r\n    \"grade\": { \"meaning\": \"机会等级\", \"range\": \"1-3，3为最高等级\", \"advice\": \"等级越高表示风险越高\" },\r\n    \"pushPrice\": { \"meaning\": \"入场推送价格\", \"range\": \"系统首次推送该机会代币时的价格\", \"advice\": \"用于计算入场后的涨跌幅\" },\r\n    \"gains\": { \"meaning\": \"推送后涨幅\", \"range\": \"(pushMaxPrice - pushPrice) / pushPrice * 100%\", \"advice\": \"推送后的最大涨幅\" },\r\n    \"declines\": { \"meaning\": \"推送后跌幅\", \"range\": \"(pushPrice - pushMinPrice) / pushPrice * 100%\", \"advice\": \"推送后的最大跌幅\" },\r\n    \"alpha\": { \"meaning\": \"Alpha信号\", \"range\": \"布尔值，表示是否具有超额收益潜力\", \"advice\": \"true时关注度应更高\" },\r\n    \"fomo\": { \"meaning\": \"FOMO信号\", \"range\": \"布尔值，表示市场情绪是否过热\", \"advice\": \"true时需警惕追高风险\" },\r\n    \"fomoEscalation\": { \"meaning\": \"FOMO加剧\", \"range\": \"布尔值，FOMO状态进一步升级\", \"advice\": \"true时风险显著增加\" },\r\n    \"active\": { \"meaning\": \"24h活跃地址数\", \"range\": \"过去24小时内有交易的链上地址数量\", \"advice\": \"反映市场参与热度\" },\r\n    \"newly\": { \"meaning\": \"24h新增地址数\", \"range\": \"过去24小时内首次持有该代币的地址数量\", \"advice\": \"反映新资金流入\" },\r\n    \"bullishRatio\": { \"meaning\": \"看涨情绪比例\", \"range\": \"0-1，基于社媒分析\", \"advice\": \"越接近1表示市场越看涨\" },\r\n    \"bearishRatio\": { \"meaning\": \"看跌情绪比例\", \"range\": \"0-1，基于社媒分析\", \"advice\": \"越接近1表示市场越看跌\" },\r\n    \"tradeInflow\": { \"meaning\": \"交易净流入\", \"range\": \"正值为资金流入，负值为资金流出\", \"advice\": \"持续正值表示主力在吸筹\" }\r\n  },\r\n  \"enums\": {\r\n    \"tradeType\": { \"1\": \"现货\", \"2\": \"合约（永续）\", \"3\": \"交割合约\" },\r\n    \"timeParticleEnum\": { \"5\": \"5分钟\", \"15\": \"15分钟\", \"30\": \"30分钟\", \"101\": \"1小时\", \"104\": \"4小时\", \"124\": \"24小时\", \"201\": \"1天\", \"207\": \"7天\", \"230\": \"30天\" }\r\n  },\r\n  \"example\": {\r\n    \"req\": {},\r\n    \"res\": {\r\n      \"code\": 200,\r\n      \"data\": [\r\n        {\r\n          \"vsTokenId\": \"23335\",\r\n          \"symbol\": \"THE\",\r\n          \"price\": \"0.2792\",\r\n          \"maxPrice\": \"4.1032\",\r\n          \"minPrice\": \"0.0722\",\r\n          \"percentChange1h\": \"0.33\",\r\n          \"percentChange24h\": \"1.42\",\r\n          \"percentChange7d\": \"4.49\",\r\n          \"percentChange30d\": \"7.90\",\r\n          \"percentChange60d\": \"25.65\",\r\n          \"percentChange90d\": \"56.37\",\r\n          \"cost\": \"0.2709\",\r\n          \"costChange\": \"0.0625\",\r\n          \"deviation\": \"-1.42\",\r\n          \"marketCap\": \"36026970.95\",\r\n          \"marketCapRanking\": 312,\r\n          \"circulatingSupply\": \"128932942.42\",\r\n          \"circulationRate\": \"39.54\",\r\n          \"active\": \"347\",\r\n          \"newly\": \"347\",\r\n          \"tradeType\": 1,\r\n          \"chanceCoinTradeDataV1Vos\": [\r\n            { \"timeRange\": \"m15\", \"timeParticleEnum\": 15, \"tradeInflow\": \"460.63\", \"tradeAmount\": \"3213.51\" },\r\n            { \"timeRange\": \"m30\", \"timeParticleEnum\": 30, \"tradeInflow\": \"-338.10\", \"tradeAmount\": \"4455.51\" },\r\n            { \"timeRange\": \"H4\", \"timeParticleEnum\": 104, \"tradeInflow\": \"-5145.62\", \"tradeAmount\": \"37250.34\" }\r\n          ],\r\n          \"updateTime\": 1773016500000,\r\n          \"pushPrice\": \"0.2621\",\r\n          \"pushMaxPrice\": \"0.2806\",\r\n          \"gains\": 0.0,\r\n          \"pushMinPrice\": \"0.2587\",\r\n          \"declines\": 1.30,\r\n          \"score\": 45.0,\r\n          \"scoreChange\": 10.0,\r\n          \"grade\": 2,\r\n          \"alpha\": false,\r\n          \"fomo\": false,\r\n          \"fomoEscalation\": false,\r\n          \"bullishRatio\": 1.0,\r\n          \"bearishRatio\": 0.0\r\n        }\r\n      ]\r\n    }\r\n  }\r\n}\n\nFile v1.0.4:references/ai/chance-coin-messages.json\n\n{\r\n  \"name\": \"机会代币消息列表\",\r\n  \"endpoint\": \"POST /ai/getChanceCoinMessageList\",\r\n  \"description\": \"获取AI通过多数据维度，对当前行情下具有上涨潜力的代币的\n\nArchive v1.0.3: 30 files, 41122 bytes\n\nFiles: _meta.json (135b), references/ai/chance-coin-list.json (8993b), references/ai/chance-coin-messages.json (2358b), references/ai/funds-coin-list.json (4643b), references/ai/funds-coin-messages.json (2495b), references/ai/risk-coin-list.json (5592b), references/ai/risk-coin-messages.json (2387b), references/base/kline.json (2729b), references/base/token-detail.json (4881b), references/base/token-list.json (1388b), references/category/category-list.json (2406b), references/category/category-tokens.json (2360b), references/chain/balance-trend.json (2004b), references/chain/hold-trend.json (2131b), references/chain/holders.json (3459b), references/chain/large-trade.json (2591b), references/chain/profit-loss-trend.json (2016b), references/chain/trade-count-trend.json (2408b), references/enums.json (8104b), references/fund/coin-flow.json (2668b), references/fund/cost.json (2171b), references/fund/fund-snapshot.json (3878b), references/fund/marketcap-ratio.json (2233b), references/fund/realtime-fund.json (4990b), references/indicator/dense-area.json (1408b), references/indicator/price-market.json (1508b), references/indicator/sentiment.json (2982b), script/sdk/README.md (881b), script/sdk/vs_api_sign.js (3916b), SKILL.md (15401b)\n\nArchive v1.0.2: 30 files, 41173 bytes\n\nFiles: _meta.json (135b), references/ai/chance-coin-list.json (8993b), references/ai/chance-coin-messages.json (2358b), references/ai/funds-coin-list.json (4643b), references/ai/funds-coin-messages.json (2495b), references/ai/risk-coin-list.json (5592b), references/ai/risk-coin-messages.json (2387b), references/base/kline.json (2729b), references/base/token-detail.json (4887b), references/base/token-list.json (1388b), references/category/category-list.json (2418b), references/category/category-tokens.json (2390b), references/chain/balance-trend.json (2022b), references/chain/hold-trend.json (2149b), references/chain/holders.json (3471b), references/chain/large-trade.json (2603b), references/chain/profit-loss-trend.json (2040b), references/chain/trade-count-trend.json (2426b), references/enums.json (8104b), references/fund/coin-flow.json (2674b), references/fund/cost.json (2177b), references/fund/fund-snapshot.json (3899b), references/fund/marketcap-ratio.json (2245b), references/fund/realtime-fund.json (5014b), references/indicator/dense-area.json (1426b), references/indicator/price-market.json (1508b), references/indicator/sentiment.json (2982b), script/sdk/README.md (881b), script/sdk/vs_api_sign.js (3916b), SKILL.md (14852b)\n\nArchive v1.0.1: 31 files, 39871 bytes\n\nFiles: _meta.json (135b), references/ai/chance-coin-list.json (8965b), references/ai/chance-coin-messages.json (2340b), references/ai/funds-coin-list.json (4614b), references/ai/funds-coin-messages.json (2476b), references/ai/risk-coin-list.json (5564b), references/ai/risk-coin-messages.json (2369b), references/base/kline.json (2703b), references/base/token-detail.json (4871b), references/base/token-list.json (1372b), references/category/category-list.json (2390b), references/category/category-tokens.json (2374b), references/chain/balance-trend.json (1996b), references/chain/hold-trend.json (2123b), references/chain/holders.json (3455b), references/chain/large-trade.json (2587b), references/chain/profit-loss-trend.json (2014b), references/chain/trade-count-trend.json (2400b), references/enums.json (8104b), references/fund/coin-flow.json (2648b), references/fund/cost.json (2149b), references/fund/fund-snapshot.json (3872b), references/fund/marketcap-ratio.json (2219b), references/fund/realtime-fund.json (4985b), references/indicator/dense-area.json (1410b), references/indicator/price-market.json (1482b), references/indicator/sentiment.json (2955b), sdk/README.md (1195b), sdk/vs_api_sign.js (3029b), sdk/vs_api_sign.py (2626b), SKILL.md (9047b)\n\nArchive v1.0.0: 31 files, 39072 bytes\n\nFiles: _meta.json (135b), references/ai-chance-coins.json (8965b), references/ai-chance-messages.json (2340b), references/ai-funds-coins.json (4614b), references/ai-funds-messages.json (2476b), references/ai-risk-coins.json (5564b), references/ai-risk-messages.json (2369b), references/balance-trend.json (1996b), references/category-list.json (2390b), references/category-tokens.json (2374b), references/coin-flow.json (2648b), references/cost.json (2149b), references/dense-area.json (1410b), references/enums.json (8104b), references/hold-trend.json (2123b), references/large-trade.json (2587b), references/marketcap-ratio.json (2219b), references/price-market.json (1482b), references/profit-loss-trend.json (2014b), references/realtime-fund-snapshot.json (3872b), references/realtime-fund.json (4985b), references/sentiment.json (2955b), references/token-detail.json (4871b), references/token-holders.json (3455b), references/token-kline.json (2703b), references/token-list.json (1372b), references/trade-count-trend.json (2400b), sdk/README.md (1195b), sdk/vs_api_sign.js (3029b), sdk/vs_api_sign.py (2626b), SKILL.md (6479b)","readmeExcerpt":"Skill: valuescan-skill-beta Owner: majincheng Summary: 测试skill-已废弃 Tags: latest:1.0.7 Version history: v1.0.7 | 2026-03-24T11:18:19.957Z | user ValueScan Skill v1.0.7 is a minor update with documentation adjustments. - Updated documentation wording for installation and API Key registration. - Removed explicit file installation instructions from the main documentation. - No functional or interface changes; all core AP","codeSnippets":[],"executableExamples":[],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\r\nname: valuescan-skill-beta\r\ndescription: ValueScan 加密货币主力资金流分析工具。支持资金异动监控、主力动向追踪、鲸鱼地址分析、板块轮动、机会/风险代币识别、大户成本分析。\r\nversion: 1.0.7\r\nuser-invocable: true\r\ncategory: Data Analysis\r\nlicense: MIT\r\nhomepage: https://beta.valuescan.io\r\ndependencies:\r\n  - node: 16.x\r\ntags:\r\n  - cryptocurrency\r\n  - data analysis\r\n  - blockchain\r\n  - finance\r\ndocumentation: |\r\n  该 Skill 用于对加密货币市场进行分析，帮助用户识别资金流向、主力动向等信息。\r\nsupport_email: support@openclaw.com\r\nwebsite: https://beta.valuescan.io\r\ncredentials:\r\n  api_key:\r\n    description: 用于认证的 API 密钥\r\n    required: true\r\n  secret_key:\r\n    description: 用于认证的 Secret 密钥\r\n    required: true\r\n---\r\n\r\n# ValueScan API\r\n\r\n加密货币主力资金流动向分析 API，追踪大户资金动向，让数据成为你的交易副驾驶。\r\n\r\n## 使用场景示例\r\n\r\n| 场景           | 通过 Skill 实现                                              |\r\n| -------------- | ------------------------------------------------------------ |\r\n| **行情信号**   | 用户问：“最近有哪些币出现主力异动？” →  调用 `资金异动列表` 返回结果。<br>用户问：“BTC主力资金异动信号有哪些？”→ Skill 调用 `资金异动消息` 返回结果。 |\r\n| **行情信号**   | 用户问：“最近有哪些币可能上涨” →  调用 `资金异动列表`和  `机会代币列表`返回结果并说明场景     <br/>用户问：“BTC机会信号有哪些？”→ Skill 调用 `机会代币消息` 返回结果。 |\r\n| **链上监控**   | 用户设置：“当 ETH 出现超过 1000 ETH 的大额转账时通知我。” →  调用 `大额交易` 实现实时监控。 |\r\n| **投资决策**   | 用户问：“BTC 现在的压力位和支撑位在哪？” →  调用 `压力支撑位` 提供数据。 |\r\n| **资金面分析** | 用户问：“过去一周，AI 板块的资金流向如何？” →  调用 `板块资金列表` 获取板块轮动数据。 |\r\n| **地址分析**   | 用户提供地址：“帮我分析这个地址的持仓成本变化。” →  调用 `持仓趋势` 返回建仓成本曲线。 |\r\n\r\n## 接口列表\r\n\r\n### 基础数据\r\n\r\n| 接口         | 用途                                              |\r\n| ------------ | ------------------------------------------------- |\r\n| 代币列表     | 搜索代币，获取对应的 `vsTokenId` 等基础标识信息。 |\r\n| 代币基本信息 | 获取代币的实时价格、市值、`coinKey` 等详细信息。  |\r\n| K线数据      | 支持多时间窗口的 K 线数据查询，用于技术分析。     |\r\n\r\n### AI智选\r\n\r\nAI综合多维度数据，追踪当前行情下的具有上涨机会或有下跌风险的代币，并实时追踪主力行为，提供实时追踪信号，辅助市场判断。\r\n\r\n| 接口         | 用途                                                   |\r\n| ------------ | ------------------------------------------------------ |\r\n| 机会代币列表     | 追踪当前行情下具有上涨潜力的代币                       |\r\n| 机会代币消息     | 上涨潜力币的主力动向实时信号（如吸筹、突破、出逃等）。 |\r\n| 风险代币列表     | 当前行情下具有下跌风险趋势的代币                       |\r\n| 风险代币消息     | 下跌风险币的主力动向实时信号（如派发、破位、反弹等）。 |\r\n| 资金异动列表     | 上涨或震荡行情中资金活跃且具有短期套利潜力的代币       |\r\n| 资金异动消息     | 短线/趋势异动的实时信号（如主力入场、抛压等）。        |\r\n\r\n### 交易所主力资金监控\r\n\r\n监控中心化交易所（现货/合约）的资金流数据，追踪主力动向。\r\n\r\n| 接口           | 用途                                            |\r\n| -------------- | ----------------------------------------------- |\r\n| 实时资金积累       | 当日资金变化监控，反映主力实时流入/流出。       |\r\n| 资金快照           | 最近100天的资金积累趋势，用于中长期资金面分析。 |\r\n| 资金市值比         | 资金流入强度判断，辅助识别资金与市值匹配度。    |\r\n| 板块资金列表       | 板块轮动资金监控，快速定位热点赛道。            |\r\n| 板块代币资金       | 板块内龙头代币的实时资金积累数据。              |\r\n\r\n### 链上主力资金监控\r\n\r\n交易所的充/提资金监控，以及链上大户持仓成本变化监控，辅助主力行为追踪\r\n\r\n| 接口     | 用途                                          |\r\n| -------- | --------------------------------------------- |\r\n| 代币流向     | 链上与交易所之间的资金交互监控（交易所的充提数据） |\r\n| 主力成本变化趋势 | 大户平均持仓成本分析，识别主力建仓/出货位置。 |\r\n\r\n### 市场指标\r\n\r\nvaluescan特色指标数据，对关键位置具有重要参考价值\r\n\r\n| 接口         | 用途                                        |\r\n| -----"},{"path":"script/sdk/README.md","content":"# ValueScan API SDK\r\n\r\n## 使用步骤\r\n\r\n**1. 配置 API Key**\r\n\r\n访问 https://beta.valuescan.io/dev-portal/home/ 注册获取 API Key:\r\n\r\n```json\r\n{\r\n  \"valuescanApiKey\": \"你的API Key\",\r\n  \"valuescanSecretKey\": \"你的Secret Key\"\r\n}\r\n```\r\n##  凭证说明\r\n\r\n本技能需要 ValueScan API 凭证用于请求签名：\r\n\r\n- 存储路径：`~/.openclaw/credentials/valuescan.json`\r\n- 签名方式：HMAC-SHA256\r\n- 数据用途：仅用于访问 ValueScan API，不会外传\r\n\r\n本技能不会收集或上传用户敏感信息。\r\n\r\n**2. SDK 调用**\r\n\r\n| 场景 | 方法 |\r\n|------|------|\r\n| 发送请求 | `vsPost(path, data)` |\r\n| 仅生成签名头 | `buildSignHeader(rawBody)` |\r\n\r\n**3. 调用示例**\r\n\r\n```javascript\r\nconst { vsPost } = require('./vs_api_sign');\r\nconst result = await vsPost('/api/open/v1/vs-token/list', {search: 'BTC'});\r\n```\r\n\r\n## 签名规范\r\n\r\n- **timestamp**: 13位毫秒时间戳（有效期5分钟）\r\n- **算法**: HMAC-SHA256(secret=Secret Key, message=timestamp + body_json)\r\n- **请求头**: `X-API-KEY`, `X-TIMESTAMP`, `X-SIGN`\r\n- **约束**: Raw Body 禁止格式化修改"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn77r2vst0yn44kwc81rt8hz9s839z8m\",\n  \"slug\": \"mjc-test-destory\",\n  \"version\": \"1.0.7\",\n  \"publishedAt\": 1774351099957\n}"},{"path":"references/ai/chance-coin-list.json","content":"{\r\n  \"name\": \"机会代币列表\",\r\n  \"endpoint\": \"POST /ai/getChanceCoinList\",\r\n  \"description\": \"获取AI通过多维度数据，追踪当前行情下具有上涨潜力的代币列表\",\r\n  \"credits_cost\": 3,\r\n  \"needToken\": false,\r\n  \"use_case\": \"适用于当前行情下存在上涨行情机会的代币筛选和查询，适用于中短线交易者寻找具有上涨潜力的代币标的，适用于趋势跟踪策略中识别潜在上涨机会\",\r\n  \"update_frequency\": \"每 5 分钟更新一次\",\r\n  \"typeNote\": \"部分数值字段实际返回为字符串类型，使用时请注意类型转换\",\r\n  \"params\": {},\r\n  \"response\": {\r\n    \"vsTokenId\": { \"type\": \"long\", \"actualType\": \"string\", \"desc\": \"代币ID\" },\r\n    \"symbol\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"币种符号\" },\r\n    \"price\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"当前价格(USD)\" },\r\n    \"maxPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"历史最高价格(USD)\" },\r\n    \"minPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"历史最低价格(USD)\" },\r\n    \"percentChange1h\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"1小时价格变化百分比\" },\r\n    \"percentChange24h\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"24小时价格变化百分比\" },\r\n    \"percentChange7d\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"7天价格变化百分比\" },\r\n    \"percentChange30d\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"30天价格变化百分比\" },\r\n    \"percentChange60d\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"60天价格变化百分比\" },\r\n    \"percentChange90d\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"90天价格变化百分比\" },\r\n    \"cost\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"主力成本价格(USD)\" },\r\n    \"costChange\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"成本变化率\" },\r\n    \"deviation\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"价格偏离度(%)\" },\r\n    \"marketCap\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"市值(USD)\" },\r\n    \"marketCapRanking\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"市值排名\" },\r\n    \"circulatingSupply\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"流通供应量\" },\r\n    \"circulationRate\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"流通率(%)\" },\r\n    \"active\": { \"type\": \"integer\", \"actualType\": \"string\", \"desc\": \"24h活跃地址数\" },\r\n    \"newly\": { \"type\": \"integer\", \"actualType\": \"string\", \"desc\": \"24h新增地址数\" },\r\n    \"tradeType\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"交易类型（1:现货 2:合约 3:交割合约）\" },\r\n    \"chanceCoinTradeDataV1Vos\": {\r\n      \"type\": \"array\",\r\n      \"desc\": \"交易时间数据列表\",\r\n      \"item\": {\r\n        \"timeRange\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"时间范围标识（如m15, H4）\" },\r\n        \"timeParticleEnum\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"时间粒度枚举值\" },\r\n        \"tradeInflow\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"交易净流入金额(USD)\" },\r\n        \"tradeAmount\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"交易总金额(USD)\" }\r\n      }\r\n    },\r\n    \"updateTime\": { \"type\": \"long\", \"actualType\": \"long\", \"desc\": \"更新时间（毫秒时间戳）\" },\r\n    \"pushPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"入场推送价格(USD)\" },\r\n    \"pushMaxPrice\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"推送后最高价(USD)\" },\r\n    \"gains\": { \"type\": \"number\", \"actualType\": \"nu"},{"path":"references/ai/chance-coin-messages.json","content":"{\r\n  \"name\": \"机会代币消息列表\",\r\n  \"endpoint\": \"POST /ai/getChanceCoinMessageList\",\r\n  \"description\": \"获取AI通过多数据维度，对当前行情下具有上涨潜力的代币的追踪消息数据\",\r\n  \"credits_cost\": 3,\r\n  \"needToken\": true,\r\n  \"use_case\": \"适用于当前行情下，对有上涨行情机会的代币，进行AI实时追踪的消息查询，适用于了解主力动作（入场、增持、减持、出逃等）\",\r\n  \"params\": {\r\n    \"vsTokenId\": { \"type\": \"long\", \"req\": true, \"desc\": \"代币ID\" }\r\n  },\r\n  \"response\": {\r\n    \"updateTime\": { \"type\": \"long\", \"actualType\": \"long\", \"desc\": \"更新时间\" },\r\n    \"vsTokenId\": { \"type\": \"long\", \"actualType\": \"string\", \"desc\": \"代币ID\" },\r\n    \"symbol\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"代币符号\" },\r\n    \"name\": { \"type\": \"string\", \"actualType\": \"string\", \"desc\": \"代币名称\" },\r\n    \"chanceMessageType\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"预测类型\" },\r\n    \"scoring\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"得分\" },\r\n    \"grade\": { \"type\": \"integer\", \"actualType\": \"integer\", \"desc\": \"等级\" },\r\n    \"price\": { \"type\": \"number\", \"actualType\": \"string\", \"desc\": \"币价\" },\r\n    \"percentChange24h\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"24小时涨跌幅\" },\r\n    \"gains\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"涨幅\" },\r\n    \"decline\": { \"type\": \"number\", \"actualType\": \"number\", \"desc\": \"跌幅\" }\r\n  },\r\n  \"field_meta\": {\r\n    \"chanceMessageType\": { \"meaning\": \"机会消息类型\", \"advice\": \"标识主力动作类型，如入场、增持、减持、出逃等\" },\r\n    \"scoring\": { \"meaning\": \"机会得分\", \"advice\": \"该信号的综合评分，分数越高信号越强\" },\r\n    \"grade\": { \"meaning\": \"机会等级\", \"advice\": \"信号等级划分，用于筛选重要信号\" }\r\n  },\r\n  \"example\": {\r\n    \"req\": { \"vsTokenId\": 23335 },\r\n    \"res\": {\r\n      \"code\": 200,\r\n      \"data\": [\r\n        {\r\n          \"updateTime\": 1773071700000,\r\n          \"vsTokenId\": \"23335\",\r\n          \"symbol\": \"THE\",\r\n          \"name\": \"THENA\",\r\n          \"chanceMessageType\": 30,\r\n          \"scoring\": 0.0,\r\n          \"grade\": 2,\r\n          \"price\": \"0.2742\",\r\n          \"percentChange24h\": 6.18,\r\n          \"gains\": 5.07,\r\n          \"decline\": 0.36\r\n        }\r\n      ]\r\n    }\r\n  }\r\n}"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"测试skill-已废弃 Skill: valuescan-skill-beta Owner: majincheng Summary: 测试skill-已废弃 Tags: latest:1.0.7 Version history: v1.0.7 | 2026-03-24T11:18:19.957Z | user ValueScan Skill v1.0.7 is a minor update with documentation adjustments. - Updated documentation wording for installation and API Key registration. - Removed explicit file installation instructions from the main documentation. - No functional or interface changes; all core AP","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1127,"uniquenessScore":46,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-11T14:35:06.719Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-11T14:35:06.719Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-11T17:45:13.919Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}