UPBIT市场数据获取技能是一个基于OpenClaw框架的命令行工具，专为从Upbit交易所实时抓取各类市场数据而设计。该工具通过调用Upbit开放API接口，以JSON格式输出结构化数据，支持交易对列表、K线图、最新成交记录、行情快照、订单簿以及自选币种等多种数据类型。其核心优势在于完全脱离图形界面，仅依赖Node.js运行环境即可执行，非常适合自动化脚本、量化策略回测或数据分析流程中集成使用。所有响应均遵循统一的成功与错误格式：成功时标准输出包含`ok: true`及结果数据；失败时则写入标准错误流并附带`ok: false`和详细错误信息，同时退出码为1，便于上游系统精准识别处理状态。
核心功能特点
- 支持多种数据类型获取：包括交易对列表、多周期K线（秒/分/日/周/月/年）、最近成交记录、实时行情、深度订单簿及用户自定义自选列表
- 全JSON输出格式：所有命令返回标准化JSON结构，成功响应含ok字段和result对象，错误响应含ok字段和error详情，兼容性强
- 严格模式防误用：启用–strict=true后强制固定命令结构，避免LLM或自动化工具因参数重排导致调用失败，提升可靠性
- 灵活配置管理：支持通过config/config.json文件设置API密钥、基础URL及自选币种列表，也允许运行时动态覆盖配置路径
- 完善的错误处理：自动透传Upbit API的HTTP状态码（如429限流、400非法请求），并在error对象中保留原始错误内容供排查
适用场景
该工具特别适合需要高频、自动化获取Upbit市场数据的开发者与量化团队。例如，在构建个人投资组合监控系统时，可通过定时任务调用`watchlist`命令持续追踪预设币种的价格变动；对于高频交易策略开发者而言，利用`candles minutes –unit=5`可快速拉取5分钟K线用于技术指标计算，而`orderbook`命令则能提供当前买卖档位深度信息辅助下单决策。此外，若需批量分析多个交易对的流动性状况，`tickers –markets=KRW-BTC,KRW-ETH`能一次性返回各币种的24小时涨跌幅、成交量等关键指标。由于所有操作均为无状态CLI调用且输出纯净JSON，它还可无缝嵌入CI/CD流水线、监控告警系统或第三方金融数据平台的数据源模块中，实现端到端的无人值守数据采集流程。