SuperAPI AI 工具集

bitget-openapi-skill

数据与分析

查看项目

更新于 10-15 22:14

技能介绍

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

前提条件:uxc 已安装并在 PATH 中可用;可访问 https://api.bitget.com;可访问精选 OpenAPI schema:https://raw.githubusercontent.com/holon-run/uxc/main/skills/bitget-openapi-skill/references/bitget-v2.openapi.json。

覆盖范围:现货交易对与元数据、ticker 读取、K 线读取、订单簿快照。不覆盖:v1 私有账户端点、v1 私有下单或撤单、跟单交易或 P2P 流程。

认证:本技能中的公共市场端点无需凭证。Bitget 私有 API 使用供应商特定的请求头签名与时间戳头;在 uxc 中存在可复用的 Bitget 签名流程之前,本 v1 技能保持仅公开数据。

核心工作流:默认使用固定链接命令 command -v bitget-openapi-cli;若缺失则创建:uxc link bitget-openapi-cli https://api.bitget.com --schema-url https://raw.githubusercontent.com/holon-run/uxc/main/skills/bitget-openapi-skill/references/bitget-v2.openapi.json,然后运行 bitget-openapi-cli -h。执行前查看操作帮助,例如 bitget-openapi-cli get:/api/v2/spot/public/symbols -h 与 bitget-openapi-cli get:/api/v2/spot/market/tickers -h。优先进行窄范围现货读取,例如 bitget-openapi-cli get:/api/v2/spot/market/tickers symbol=BTCUSDT 与 bitget-openapi-cli get:/api/v2/spot/market/orderbook symbol=BTCUSDT limit=20。

操作:get:/api/v2/spot/public/symbols、get:/api/v2/spot/market/tickers、get:/api/v2/spot/market/candles、get:/api/v2/spot/market/orderbook。

护栏:自动化保持使用 JSON 输出封装,不要使用 --text;优先解析稳定字段 ok、kind、protocol、data、error;将本 v1 技能视为只读;除非用户明确要求更大范围,否则保持 symbol 与 K 线区间狭窄。bitget-openapi-cli <operation> ... 等价于 uxc https://api.bitget.com --schema-url <bitget_v2_openapi_schema> <operation> ...。

参考:使用模式见 references/usage-patterns.md;精选 OpenAPI schema 见 references/bitget-v2.openapi.json;官方 Bitget API 介绍见 https://www.bitget.com/api-doc/common/intro。