Back to Details

bitget-openapi-skill

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Bitget Exchange Skill

Bitget交易平台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.
使用本Skill通过
uxc
+ OpenAPI执行Bitget公开市场数据操作。
复用
uxc
Skill以获取共享的执行、认证和错误处理指引。

Prerequisites

前置条件

  • uxc
    is installed and available in 
    PATH
    .
  • Network access to 
    https://api.bitget.com
    .
  • Access to the curated OpenAPI schema URL: 
    • https://raw.githubusercontent.com/holon-run/uxc/main/skills/bitget-openapi-skill/references/bitget-v2.openapi.json
  • uxc
    已安装并可在
    PATH
    中访问。
  • 可访问
    https://api.bitget.com
    的网络权限。
  • 可访问经过筛选的OpenAPI schema URL: 
    • https://raw.githubusercontent.com/holon-run/uxc/main/skills/bitget-openapi-skill/references/bitget-v2.openapi.json

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
本Skill涵盖经过筛选的Bitget公开市场操作，包括：
  • 现货交易对及元数据
  • 行情报价读取
  • K线数据读取
  • 订单簿快照
本Skill不涵盖：
  • v1版本中的私有账户端点
  • v1版本中的私有订单下单或取消操作
  • 跟单交易或P2P交易流程

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
.
本Skill中的公开市场端点无需凭证。
Bitget私有API使用特定于服务商的头部签名和时间戳头部。在
uxc
中存在可复用的Bitget签名流程之前，本v1版本Skill仅支持公开数据操作。

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
    • bitget-openapi-cli -h
  2. Inspect operation help before execution:
    • bitget-openapi-cli get:/api/v2/spot/public/symbols -h
    • bitget-openapi-cli get:/api/v2/spot/market/tickers -h
  3. Prefer narrow spot reads first:
    • bitget-openapi-cli get:/api/v2/spot/market/tickers symbol=BTCUSDT
    • bitget-openapi-cli get:/api/v2/spot/market/orderbook symbol=BTCUSDT limit=20
  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

Operations

支持的操作

  • get:/api/v2/spot/public/symbols
  • get:/api/v2/spot/market/tickers
  • get:/api/v2/spot/market/candles
  • get:/api/v2/spot/market/orderbook
  • get:/api/v2/spot/public/symbols
  • get:/api/v2/spot/market/tickers
  • get:/api/v2/spot/market/candles
  • get:/api/v2/spot/market/orderbook

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.
  • bitget-openapi-cli <operation> ...
    is equivalent to 
    uxc https://api.bitget.com --schema-url <bitget_v2_openapi_schema> <operation> ...
    .
  • 自动化操作基于JSON输出包，请勿使用
    --text
    参数。
  • 优先解析稳定字段：
    ok
    , 
    kind
    , 
    protocol
    , 
    data
    , 
    error
    。
  • 将本v1版本Skill视为只读工具。
  • 除非用户明确要求获取更广泛的数据，否则请限制交易对和K线的范围。
  • bitget-openapi-cli <operation> ...
    等价于 
    uxc https://api.bitget.com --schema-url <bitget_v2_openapi_schema> <operation> ...
    。

References

参考资料