SuperAPI AI 工具集

upbit-openapi-skill

数据与分析

查看项目

更新于 10-15 23:59

技能介绍

用途:该技能用于通过 uxc + OpenAPI 执行 Upbit 公开市场数据操作,复用 uxc 技能提供的执行、认证与错误处理指引。

主要能力:覆盖精选的 Upbit 公开接口,包括市场发现、ticker 读取、分钟K线、订单簿快照。v1 不覆盖私有账户或订单接口,也不覆盖区域特定的账户/交易认证流程。

前置条件:uxc 已安装并在 PATH 中;可访问所选 Upbit 区域 API 主机;可访问精选 OpenAPI schema:https://raw.githubusercontent.com/holon-run/uxc/main/skills/upbit-openapi-skill/references/upbit-public.openapi.json

使用方式:Upbit 使用区域主机,需先按目标市场选择正确主机,例如 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/market/all -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。支持的操作有 get:/v1/market/all、get:/v1/ticker、get:/v1/candles/minutes/{unit}、get:/v1/orderbook。

限制与注意:公开市场接口无需凭证;Upbit 私有 API 使用提供商特定的 bearer JWT 生成与请求特定声明,在 uxc 中存在可复用的 Upbit 签名流程前,本 v1 技能仅限公开数据。自动化应保持 JSON 输出封装,不要使用 --text;优先解析稳定字段 ok、kind、protocol、data、error;本 v1 技能视为只读;执行前确认正确的区域主机与报价市场;在区域 Upbit 主机上,实时市场代码为报价在前,例如 SGD-BTC、USDT-BTC。upbit-openapi-cli <operation> ... 等价于 uxc <upbit_region_host> --schema-url <upbit_public_openapi_schema> <operation> ...。参考:references/usage-patterns.md、references/upbit-public.openapi.json,官方概览 https://global-docs.upbit.com/reference/api-overview。