如何使用币安 API 进行交易机器人？ （开发者设置）

API 密钥生成和安全协议

1. 登录您的币安账户并导航至“安全设置”下的“API 管理”部分。

2. 单击“创建 API”并选择“限制 IP 访问”将密钥绑定到特定 IPv4 地址以增强保护。

3. 启用“启用交易”但禁用“启用提款”——即使凭证被泄露，这也可以防止资金移动。

4. 将API key和secret存储在加密的环境变量文件中；切勿将它们硬编码到源文件中或将它们提交给版本控制。

5. 每 90 天轮换一次密钥，并立即使用币安仪表板撤销任何涉嫌泄露的密钥。

REST 与 WebSocket 集成策略

1. 当可靠性和保证交付至关重要时，使用/api/v3/account等 REST 端点进行余额检查和下单。

2. 订阅 WebSocket 流，例如!ticker@arr或btcusdt@深度，以获取延迟低于 100 毫秒的实时市场数据。

3. 实现双通道对账：将 REST /api/v3/order中的订单状态与通过WebSocketexecutionReport流接收的执行报告进行比较。

4. 使用指数退避和序列号验证处理 WebSocket 重新连接逻辑，以避免网络分区期间丢失事件。

5. 除非必要，否则避免在同一订单生命周期中混合使用 REST 和 WebSocket — 不一致的时间可能会导致重复提交或过时状态。

订单生命周期管理

1. 使用POST /api/v3/order提交限价订单，并带有强制参数：symbol、side、type、timeInForce、数量、价格和recvWindow。

2. 解析响应字段，包括orderId 、 transactTime和fills数组，以确认部分成交并计算有效平均价格。

3. 通过DELETE /api/v3/order使用 orderId 和符号取消挂单，在假设取消成功之前始终验证响应状态代码是否为 200。

4. 定期使用GET /api/v3/openOrders监控未结订单，按交易品种过滤以减少负载大小和 API 权重消耗。

5. 将 -2010（余额不足）、-2013（未找到订单）和 -2015（无效 API 密钥）等订单拒绝代码视为需要立即记录和警报的可操作异常。

速率限制和请求权重优化

1. 尊重币安的每秒和每分钟限制：大多数端点的默认 REST 权重上限为每分钟 1200 个和每小时 5000 个。

2. 尽可能批量请求 - 使用GET /api/v3/ticker/price?symbols=['BTCUSDT','ETHUSDT']而不是对每个交易品种单独调用。

3. 缓存exchangeInfo、serverTime等静态元数据最多60分钟，避免无价值消耗权重的冗余调用。

4. 在所有签名请求中一致地设置recvWindow=5000 ，以与时钟偏差容差保持一致并防止签名过期错误。

5. 监控响应中的 X-MBX-USED-WEIGHT 标头，并在使用量超过允许窗口的 80% 时限制内部请求队列。

常见问题解答

问：我可以在多个交易机器人中同时使用相同的 API 密钥吗？答：是的，但并发写入操作可能会触发订单状态的速率限制或竞争条件。隔离每个机器人实例的密钥以实现可审核性和控制。

问：为什么我的签名请求返回错误代码 -1021（请求超时）？答：这表明服务器时间戳不匹配。使用 NTP 同步系统时钟，并在后续签名请求中包含从GET /api/v3/time检索到的当前服务器时间。

问：测试网 API 密钥的功能与生产密钥相同吗？答：测试网密钥支持完整的订单流模拟，但不反映实际资产余额或市场深度。订单执行是针对模拟流动性而非真实交易对手进行的。

问：如何验证我的 WebSocket 连接是否正在接收有效的市场数据？答：检查深度流中是否存在lastUpdateId ，并验证连续更新之间的连续性。还要检查E （事件时间）时间戳的单调进展。