核心用法
Upbit Market Data Skill 是一款基于 Node.js 的 CLI 工具，专为 OpenClaw 执行环境设计，通过调用 Upbit 官方 REST API 获取韩国最大加密货币交易所的市场数据。支持一次性执行模式 (exec)，所有输出均为标准化 JSON 格式，成功返回 {"ok": true, "result": ...}，失败返回 {"ok": false, "error": ...} 并伴随退出码 1。
主要功能模块：
- 交易对列表：获取全市场或详细交易对信息
- K线数据：支持秒/分/日/周/月/年级别的蜡烛图，分钟级支持 1/3/5/10/15/30/60/240 分钟粒度
- 实时行情：单币种或多币种 tickers、按计价货币筛选
- 订单簿深度：可配置档位级别与数量
- 最近成交：历史交易流水查询
- 配置 watchlist：从配置文件批量监控自选币种
严格模式 (Strict Mode)：专为 LLM/Agent 调用设计，强制固定命令结构，防止参数重排导致的解析歧义。例如 K 线命令要求 candles <type> 必须紧跟命令，禁止 --type= 选项传参。
显著优点
1. 官方数据源：直接对接 Upbit 官方 API，数据实时性与权威性有保障
2. 标准化输出：统一 JSON 格式，便于程序化解析和错误处理
3. Agent 友好：严格模式消除 LLM 生成命令的结构不确定性
4. 轻量依赖：仅需 Node.js 18+，零外部 HTTP 库依赖（原生 fetch）
5. 配置灵活：支持运行时配置文件路径覆盖，便于多环境部署
潜在缺点与局限性
1. 地域限制：Upbit 主要服务韩国市场，非韩元交易对深度有限
2. 认证门槛：部分接口需 API Key，且 Upbit 对非韩国用户注册有限制
3. 速率限制：未内置请求队列或缓存，高频调用易触发 429/418 限制
4. 无 WebSocket：仅 REST 轮询，实时性不及 WebSocket 流式推送
5. 功能单一：纯数据获取，无交易执行、资产管理等高级功能
适合人群
- 量化交易策略开发者（需历史/实时行情数据）
- 自动化监控系统（价格预警、流动性分析）
- OpenClaw/LLM Agent 集成场景（结构化数据交互）
- 韩国加密货币市场研究者
常规风险
- API 变更风险：Upbit 接口调整可能导致命令失效
- 网络稳定性：跨境调用存在延迟与连通性问题
- 数据延迟：免费档位可能存在秒级延迟，非撮合级实时
- 配置泄露：
config.json含 API 密钥，需严格权限管理（当前报告未评估实际安全扫描）