Bitget Exchange Skill
Use this skill to run Bitget public market-data operations through uxc + OpenAPI.
Reuse the uxc skill for shared execution, auth, and error-handling guidance.
Prerequisites
- -
uxc is installed and available in PATH. - Network access to
https://api.bitget.com. - Access to the curated OpenAPI schema URL:
- INLINECODE5
Scope
This skill covers a curated Bitget public market surface for:
- - spot symbols and metadata
- ticker reads
- candlestick reads
- order book snapshots
This skill does not cover:
- - private account endpoints in v1
- private order placement or cancellation in v1
- copy trading or P2P workflows
Authentication
Public market endpoints in this skill do not require credentials.
Bitget private APIs use provider-specific header signing and timestamp headers. Keep this v1 skill public-data-only until a reusable Bitget signer flow exists in uxc.
Core Workflow
- 1. Use the fixed link command by default:
-
command -v bitget-openapi-cli
- If missing, create it:
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
- INLINECODE9
- 2. Inspect operation help before execution:
-
bitget-openapi-cli get:/api/v2/spot/public/symbols -h
- INLINECODE11
- 3. Prefer narrow spot reads first:
-
bitget-openapi-cli get:/api/v2/spot/market/tickers symbol=BTCUSDT
- INLINECODE13
Operations
- - INLINECODE14
- INLINECODE15
- INLINECODE16
- INLINECODE17
Guardrails
- - Keep automation on the JSON output envelope; do not use
--text. - Parse stable fields first:
ok, kind, protocol, data, error. - Treat this v1 skill as read-only.
- Keep symbol and candle ranges narrow unless the user explicitly wants a broader pull.
- INLINECODE24 is equivalent to
uxc https://api.bitget.com --schema-url <bitget_v2_openapi_schema> <operation> ....
References
- - Usage patterns: INLINECODE26
- Curated OpenAPI schema: INLINECODE27
- Official Bitget API intro: https://www.bitget.com/api-doc/common/intro
技能名称: bitget-openapi-skill
详细描述:
Bitget 交易所技能
使用此技能通过 uxc + OpenAPI 运行 Bitget 公开市场数据操作。
复用 uxc 技能以获取共享的执行、认证和错误处理指导。
前提条件
- - uxc 已安装并可在 PATH 中使用。
- 可访问 https://api.bitget.com 的网络连接。
- 可访问精选的 OpenAPI 模式 URL：
- https://raw.githubusercontent.com/holon-run/uxc/main/skills/bitget-openapi-skill/references/bitget-v2.openapi.json
范围
此技能涵盖精选的 Bitget 公开市场数据面，包括：
- - 现货交易对及元数据
- 行情数据读取
- K线数据读取
- 订单簿快照
此技能不涵盖：
- - v1 中的私有账户端点
- v1 中的私有订单下达或取消
- 跟单交易或 P2P 工作流
认证
此技能中的公开市场端点无需凭证。
Bitget 私有 API 使用特定于提供商的标头签名和时间戳标头。在 uxc 中存在可复用的 Bitget 签名器流程之前，请将此 v1 技能保持为仅公开数据。
核心工作流
- 1. 默认使用固定链接命令：
- 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
- 2. 在执行前检查操作帮助：
- bitget-openapi-cli get:/api/v2/spot/public/symbols -h
- bitget-openapi-cli get:/api/v2/spot/market/tickers -h
- 3. 优先进行窄范围的现货数据读取：
- 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 技能视为只读。
- 保持交易对和 K线范围狭窄，除非用户明确要求更广泛的拉取。
- bitget-openapi-cli <操作> ... 等同于 uxc https://api.bitget.com --schema-url v2openapi_schema> <操作> ...。
参考资料
- - 使用模式：references/usage-patterns.md
- 精选的 OpenAPI 模式：references/bitget-v2.openapi.json
- 官方 Bitget API 介绍：https://www.bitget.com/api-doc/common/intro
