SuperAPI AI 工具集

upbit-openapi-skill

数据与分析

查看项目

更新于 11-02 01:30

技能介绍

用途:该技能用于通过 uxc + OpenAPI 方式执行 Upbit 交易所的公开市场数据操作,属于只读行情工具,定位为 v1 公开数据范围。

主要能力:覆盖市场发现、ticker 行情读取、分钟级 K 线(candles/minutes/{unit})与订单簿快照四类操作,对应接口为 get:/v1/market/all、get:/v1/ticker、get:/v1/candles/minutes/{unit}、get:/v1/orderbook。不支持 v1 中的私有账户或订单端点,也不处理各区域的账户/交易认证流程。

使用方式:前提是 uxc 已安装并位于 PATH,且能访问所选 Upbit 区域 API 主机。先确认目标市场对应的区域主机,例如 https://sg-api.upbit.com、https://id-api.upbit.com、https://th-api.upbit.com。默认使用固定链接命令:先执行 command -v upbit-openapi-cli 检查是否已存在;若缺失则创建:uxc link upbit-openapi-cli https://sg-api.upbit.com --schema-url https://raw.githubusercontent.com/holon-run/uxc/main/skills/upbit-openapi-skill/references/upbit-public.openapi.json,随后用 upbit-openapi-cli -h 查看帮助,并可通过 upbit-openapi-cli get:/v1/ticker -h 等查看具体操作说明。执行示例包括 upbit-openapi-cli get:/v1/ticker markets=SGD-BTC 与 upbit-openapi-cli get:/v1/orderbook markets=SGD-BTC。命令形式等价于 uxc <upbit_region_host> --schema-url <upbit_public_openapi_schema> <operation> ...。

适用场景:适合需要以命令行方式获取 Upbit 公开行情数据、做市场代码发现、价格查询、分钟 K 线与盘口快照读取的自动化或脚本场景。

限制与注意事项:公开市场端点无需凭证;Upbit 私有 API 使用与请求声明相关的 bearer JWT 认证,因此该 v1 技能仅限公开数据,直到 uxc 具备可复用的 Upbit 签名流程。自动化应保持 JSON 输出信封,不要使用 --text,并优先解析稳定字段 ok、kind、protocol、data、error。技能为只读;执行前需确认正确的区域主机与报价市场,区域内 Upbit 主机上的市场代码为报价在前,例如 SGD-BTC、USDT-BTC。参考材料包括 references/usage-patterns.md 与 references/upbit-public.openapi.json,官方 Open API 概览见 https://global-docs.upbit.com/reference/api-overview。