如何使用带单 API？

【预计阅读时间：4分钟】

本文介绍了如何在 Bitget 上为带单项目创建和使用带单 API，包括功能入口、支持的操作范围，以及当前的权限设置与使用限制。

 

概览

带单项目现已支持通过 API 进行跟单交易。您可以在 Bitget App 或网页端创建专属的带单 API，更高效地管理合约跟单交易。

本功能适用于已创建带单项目的用户。

开始之前

请确认您已完成以下准备工作：

• 已创建带单项目

• 已登录正确的主账户或子账户

• 已完成必要的安全验证设置

如何访问带单 API？

您可以在 App 端和网页端创建及管理带单交易 API。

Bitget App 端

前往带单中心 → 带单项目 → API 设置

也可打开快捷面板，找到 API 设置。

要求：您必须已创建带单项目。

Bitget 网页端

前往用户中心→ API 密钥→ 带单 API 密钥

要求：您必须已创建带单项目，并选择正确的主账户或子账户。

如何创建带单交易 API？

创建带单 API 共分三步。

第一步：进入带单 API 管理页面

1.在 App 端或网页端，进入带单 API 管理页面。

2.点击创建带单 API 开始操作。

第二步：完成安全验证

1.请输入密码并完成所需的安全验证。

2.验证成功后：

3.系统会自动生成API 密钥

• 系统自动分配默认 API 名称，例如带单交易01。

第三步：查看并保存 API 凭证

1.API 创建成功后，页面将显示：

• API 密钥

• HMAC 密钥（私钥）

2.请在创建后妥善保管上述凭证。

API 限制与重要规则

请在集成前仔细了解当前范围。

每个带单项目的 API 密钥数量上限

每个带单项目最多可创建2个 API 密钥。

支持的功能

带单 API 目前支持以下操作：

• 为合约带单交易币对下单

• 撤销订单

• 修改订单

• 查询带单交易持仓

• 查询当前委托订单

• 查询历史持仓

• 查询订单历史记录

• 访问统一账户（UTA）交易 API，与标准 API 相同

不支持的功能

带单 API 目前不支持以下操作：

• 现货交易

• 非带单币对的合约交易

• 逐仓保证金模式

• 单向持仓模式

• 账户模式切换

以下功能仍在开发中：

• 调整币对杠杆

• 资金划转

API 权限

新创建的带单 API 默认包含以下权限：

• 带单交易持仓读写 — 查看和修改带单交易持仓

• 带单交易订单读写 — 下单、撤单和修改订单

• UTA 交易读写 — 访问标准交易 API

您也可以将 API 权限模式切换为只读。

删除带单 API 前的注意事项

您可以随时删除 API 密钥，请注意以下影响。

删除单个 API

删除某个 API 密钥后：

• 该 API 密钥立即失效

• 无法再用于任何请求

关闭带单项目

关闭带单项目后：

• 该项目下的所有 API 密钥都将自动删除。

技术集成参考

带单项目使用的交易 API 与 UTA 交易 API 相同。

这意味着您可以直接使用现有的 UTA 交易接口进行集成，支持的操作包括：

• 下单

• 修改止盈止损设置

• 撤销订单

• 查询订单历史记录

本功能无需单独搭建交易 API 框架。

如需详细的接口级开发指引，请参阅官方 API 文档。

API 安全使用建议

为保护您的账户和交易安全，建议您：

• 将 API 密钥和私钥存储在安全的环境中

• 仅限受信任的系统访问

• 在不需要交易权限时，使用只读模式

• 及时删除不再使用的 API 密钥

• 定期审查项目层级的 API 使用情况

 

 

常见问题

1.谁可以创建带单 API？

仅已创建带单项目的用户可以创建带单 API。

2.可以在 App 端和网页端同时创建带单 API 吗？

可以。您可以在 Bitget App 端和网页端创建及管理带单 API。

3.每个带单项目可以创建多少个 API 密钥？

每个带单项目最多可创建2个 API 密钥。

4.带单 API 支持现货交易吗？

不支持。带单 API 目前不支持现货交易。

5.如果我关闭带单项目会发生什么？

关闭带单项目后项目下的所有 API 密钥将被自动删除。