SuperAPI AI 工具集

bybit-openapi-skill

编程与开发

查看项目

更新于 10-16 08:49

技能介绍

用途:该技能用于通过 uxc + OpenAPI 执行 Bybit V5 的公共行情数据操作,并复用 uxc 技能中共享的执行、认证与错误处理指引。

主要能力:覆盖精选的 Bybit V5 公共行情接口,包括服务器时间、交易对元数据、行情(tickers)、订单簿快照与 K 线读取。不覆盖 v1 中的私有账户接口、私有下单或撤单,也不涉及跟单交易、理财、经纪商或资产管理类产品。

使用方式:前置条件为 uxc 已安装并在 PATH 中,可访问 https://api.bybit.com(可选 https://api-testnet.bybit.com),并能访问精选 OpenAPI schema 地址。默认使用固定链接命令,先检查 command -v bybit-openapi-cli;若缺失则创建:uxc link bybit-openapi-cli https://api.bybit.com --schema-url https://raw.githubusercontent.com/holon-run/uxc/main/skills/bybit-openapi-skill/references/bybit-v5.openapi.json。执行前先查看操作帮助,例如 bybit-openapi-cli get:/v5/market/time -h。建议优先进行窄范围现货读取,例如 bybit-openapi-cli get:/v5/market/tickers category=spot symbol=BTCUSDT 与 bybit-openapi-cli get:/v5/market/orderbook category=spot symbol=BTCUSDT limit=20。

限制与注意:公共行情接口无需凭证;Bybit 私有 API 使用供应商特定的请求头签名,尚未封装为通用 uxc 签名流程,因此 v1 仅限公开数据。Bybit 官方文档提到区域与 IP 限制,若请求异常失败,应先确认当前执行环境是否被允许访问 Bybit API。自动化应保持 JSON 输出封装,不要使用 --text,优先解析稳定字段 ok、kind、protocol、data、error;本 v1 技能视为只读,除用户明确需要其他市场类型并已确认符号格式外,使用 category=spot。