带单 API 介绍
带单 API 介绍
本文介绍了如何在 Bitget 上为带单项目创建和使用带单 API，包括功能入口、支持的操作范围，以及当前的权限设置与使用限制。
概览
带单项目现已支持通过 API 进行跟单交易。您可以在 Bitget App 或网页端创建专属的带单 API，更高效地管理合约跟单交易。
本功能适用于已创建带单项目的用户。
开始之前
请确认您已完成以下准备工作：
- 已创建带单项目
- 已登录正确的主账户或子账户
- 已完成必要的安全验证设置
如何访问带单 API？
您可以在 App 端和网页端创建及管理带单交易 API。
Bitget App 端
前往：带单中心 → 带单项目 → API 设置
也可打开快捷面板，找到 API 设置。
要求: 您必须已创建带单项目。
Bitget 网页端
前往：用户中心 → API 密钥 → 带单 API 密钥
要求: 您必须已创建带单项目，并选择正确的主账户或子账户。
如何创建带单交易 API？
创建带单 API 共分三步。
第一步：进入带单 API 管理页面
- 在 App 端或网页端，进入带单 API管理页面。
- 点击创建带单 API开始操作。
第二步：完成安全验证
- 请输入密码并完成所需的安全验证。
- 验证成功后：
- 系统会自动生成API 密钥
- 系统自动分配默认 API 名称，例如：带单交易01
第三步：查看并保存 API 凭证
- API 创建成功后，页面将显示：
- API 密钥
- HMAC 密钥（私钥）
- 请在创建后妥善保管上述凭证。
API 限制与重要规则
请在集成前仔细了解当前范围。
每个带单项目的 API 密钥数量上限
每个带单项目最多可创建2 个 API 密钥。
支持的功能
带单 API 目前支持以下操作：
- 为合约带单交易币对下单
- 撤销订单
- 修改订单
- 查询带单交易持仓
- 查询当前委托订单
- 查询历史持仓
- 查询订单历史记录
- 访问统一账户交易 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 密钥将被自动删除。