Bitget中国API接口使用指南
1. API概述
Bitget是全球领先的数字资产交易平台之一，致力于为全球用户提供全面的加密货币交易服务。平台不仅支持现货交易、合约交易等基础交易功能，还包括杠杆交易、期货交易等多种先进交易方式，满足不同交易者的需求。为了帮助开发者和用户实现更高效、便捷的交易自动化操作，Bitget提供了功能强大的API接口，极大地提升了平台的灵活性与可操作性。这些API接口支持开发者通过程序化的方式管理个人账户，提交各类订单，查询市场行情以及获取深度数据等，适用于多种应用场景。
API接口的广泛应用对于实现程序化交易、自动化策略部署、数据分析以及机器人交易等创新功能具有至关重要的作用。开发者可以利用API接口灵活地进行多种操作，如自动化的资金管理、实时行情的监控、快速的订单执行等，从而提升交易效率和响应速度。Bitget的API采用现代化的RESTful风格，提供清晰简洁的接口设计，支持HTTP/HTTPS请求，确保数据传输过程中的安全性和稳定性。API接口还具备高可用性和低延迟，使得在高频交易及市场波动较大的情况下，依旧能保持稳定的性能。
2. API访问权限
要使用Bitget的API接口，用户首先需要在Bitget平台上创建一个API密钥，该密钥在执行API请求时充当身份验证的关键。API密钥是确保API调用来自合法用户的重要工具，防止未经授权的访问。API密钥由两个部分组成：API Key 和 API Secret。API Key用于标识用户，而API Secret则用于加密验证，防止密钥被泄露后被恶意使用。
在创建API密钥时，用户可以根据个人需求和安全要求设置相应的访问权限和操作范围。通过精细的权限控制，用户可以限制API接口的可用功能，避免不必要的安全风险。例如，用户可以选择仅授权API执行交易操作，而不允许访问资金转账功能，或者仅限于查看账户信息而不进行任何交易。
Bitget平台提供了多种权限选项，用户可以根据自己的需求启用不同级别的权限。例如，读取权限 允许用户获取账户的市场数据和用户信息；交易权限 允许用户执行市场订单和管理交易；提币权限 则涉及资金提取的操作。每种权限都具有不同的风险级别，用户在启用权限时需要谨慎评估每个权限对账户安全的影响。
为保障API的安全性，Bitget还允许用户设置IP白名单，以限制只有特定IP地址可以通过API进行访问。这种方法大大降低了API密钥泄露后被滥用的风险。用户可以在API管理页面中添加多个IP地址，确保API请求仅能从受信任的网络环境中发起。
除了API Key和API Secret外，用户还应定期检查和更新API密钥，尤其是在出现任何安全威胁时。Bitget平台为API操作提供了详细的日志记录，帮助用户跟踪和审查每一次API请求的详细信息，进一步提高API的安全性。
2.2 设置API权限
Bitget API密钥支持细粒度的权限控制，包括以下几种权限类型：
- 读权限（Read-only）：仅允许查询账户信息和市场行情。
- 交易权限（Trade）：允许提交订单、撤单等交易操作。
- 资金权限（Withdrawal）：允许进行提现操作。
在创建API时，用户可以选择不同的权限，根据实际需求进行设置。务必妥善保管API密钥，防止泄露。
3. API请求格式
Bitget的API采用RESTful风格，所有请求都需要使用HTTP协议。API支持GET、POST、DELETE等HTTP方法，具体方法取决于不同的接口功能。
请求示例：
- GET请求：用于查询市场行情、账户信息等。
- POST请求：用于提交交易订单、设置止损等操作。
- DELETE请求：用于撤销已提交的订单。
所有请求都需要附带签名，以确保数据的安全性。签名生成的方式是通过API Secret和请求的参数进行加密。
3.1 请求头部
所有API请求都需要设置以下标准请求头部：
- Content-Type：指定请求的内容类型，通常为
application/。 - X-Bitget-API-KEY：传递API Key。
- X-Bitget-SIGN：签名，用于验证请求的合法性。
- X-Bitget-TIMESTAMP：当前时间戳（毫秒）。
3.2 签名生成方式
Bitget的签名机制使用HMAC-SHA256算法生成。具体的签名步骤如下：
- 拼接请求参数字符串。通常情况下，参数是以
key=value的形式进行拼接，多个参数之间用&分隔。 - 在请求字符串前加上API的密钥。
- 使用HMAC-SHA256算法对拼接后的字符串进行加密，得到签名。
签名的具体生成方式可以参考Bitget官方文档的示例。
4.1 获取服务器时间
获取Bitget服务器的当前时间，通常用于计算时间戳差异。
接口地址：GET /api/v1/time
返回示例：
{ "code": "00000", "msg": "success", "data": { "serverTime": 1675032345678 } }
4.2 查询账户信息
查询当前用户的账户余额、资产信息等。
接口地址：GET /api/v1/account
请求示例：
http
GET /api/v1/account
X-Bitget-API-KEY:
返回示例：
{ "code": "00000", "msg": "success", "data": { "totalEquity": "100.5", "availableBalance": "80.0", "inOrderAmount": "20.5" } }
4.3 提交订单
提交市场订单或限价订单。通过此接口可以进行交易操作。
接口地址：POST /api/v1/order
请求示例：
http
POST /api/v1/order
Content-Type: application/
X-Bitget-API-KEY:
{ "symbol": "BTC-USDT", "price": "30000", "quantity": "0.1", "side": "buy", "type": "limit" }
返回示例：
{ "code": "00000", "msg": "success", "data": { "orderId": "123456789" } }
4.4 查询订单
查询指定订单的状态和详细信息。
接口地址：GET /api/v1/order
请求示例：
http
GET /api/v1/order?orderId=123456789
X-Bitget-API-KEY:
返回示例：
{ "code": "00000", "msg": "success", "data": { "orderId": "123456789", "status": "filled", "price": "30000", "quantity": "0.1" } }
4.5 撤销订单
撤销已提交但尚未成交的订单。
接口地址：DELETE /api/v1/order
请求示例：
http
DELETE /api/v1/order?orderId=123456789
X-Bitget-API-KEY:
返回示例：
{ "code": "00000", "msg": "success" }
5. 错误处理
在使用API时，可能会遇到各种错误情况。Bitget的API会返回错误代码和错误信息，帮助开发者快速定位问题。
常见的错误代码如下：
10001：无效的API密钥。10002：签名错误。10003：请求参数错误。10004：权限不足。
在收到错误响应时，可以根据错误信息进行相应的调整和排查。
