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

核心工作流

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
```

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

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

默认使用固定链接命令：

```
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

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

参考资料

Usage patterns:
```
references/usage-patterns.md
```
Curated OpenAPI schema:
```
references/bitget-v2.openapi.json
```
Official Bitget API intro: https://www.bitget.com/api-doc/common/intro

使用模式：
```
references/usage-patterns.md
```
经过筛选的OpenAPI schema：
```
references/bitget-v2.openapi.json
```
Bitget官方API介绍：https://www.bitget.com/api-doc/common/intro