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

设置 API 凭证

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

2. 点击“创建API”，根据您的交易范围选择标准API或统一交易API。

3. 分配描述性名称并启用 IP 白名单以增强安全性 — 只有受信任的服务器才能发起请求。

4. 通过电子邮件和 2FA 确认创建，然后安全存储 API Key 和 Secret Key——页面刷新后无法再次检索。

5. 禁用未使用的权限，例如“提款”或“保证金转账”，以最大程度地减少凭证泄露时的风险。

了解身份验证流程

1. 每个专用端点都需要使用您的密钥和规范请求字符串生成 HMAC-SHA256 签名。

2. 时间戳参数必须在 Binance 服务器时间的 1000 毫秒内同步 - 在签名之前使用/api/v3/time端点获取准确的服务器时间。

3. 在 GET 请求的查询字符串或 POST 请求的请求正文中包含签名以及 X-MBX-APIKEY 标头中的 API 密钥。

4. Nonce 值必须是严格递增的整数或毫秒时间戳——重复使用或跳过值会触发拒绝。

5. 每个 IP 和 API 密钥都有速率限制 — 超过这些限制将返回带有 Retry-After 标头的 HTTP 429；在您的机器人中实现指数退避逻辑。

执行现货订单操作

1. 使用POST /api/v3/order下限价单、市价单、止损单或止盈单，并具有精确的参数（如交易品种、边、类型、数量和价格）。

2. 通过设置test=true启用测试模式，以验证订单结构而无需实际执行 - 非常适合集成测试。

3. 使用 clientOrderId 或 orderId 通过GET /api/v3/order获取实时订单状态，返回成交数量、平均价格和当前状态。

4. 使用DELETE /api/v3/order取消挂单，并提供交易品种和 orderId 或 origClientOrderId。

5. 使用带有符号和可选限制的GET /api/v3/myTrades获取最近的交易历史记录 — 交易按时间降序返回。

管理账户数据和余额

1. 调用GET /api/v3/account查询所有资产余额，包括现货钱包的免费、锁定和总金额。

2. 在启动买入/卖出逻辑之前，通过检查余额数组并验证free > 0 来动态过滤资产。

3. 如果利用交叉或逐仓保证金模式，请使用GET /sapi/v1/margin/account监控保证金水平变化。

4. 解析updateTime字段以检测过时的余额快照 - 刷新间隔应与机器人的决策延迟保持一致。

5. 通过将myTrades中的tradeId与已执行的订单 ID 相关联，根据订单执行情况交叉检查余额更新。

常见问题解答

问：我可以在多个机器人中使用相同的 API 密钥吗？答：是的，但它会增加风险面 - 如果一个机器人受到威胁，所有链接的操作都会暴露。更喜欢每个机器人拥有最小权限的专用密钥。

问：为什么我的签名请求返回“无效签名”？答：最常见的原因是签名生成期间的字符串连接不正确、时钟偏差超过 ±1000ms，或者签名本身在传输之前意外进行 URL 编码。

问：WebSocket 流是否支持实时订单簿更新？答：是的——连接到wss://stream.binance.com:9443/ws/{symbol}@depth获取原始 L2 订单簿数据，或在一个连接下对多个交易品种使用组合流。

问：如何处理 API 停机或 503 响应？答：实施断路器模式 - 跟踪连续故障，在可配置的持续时间内暂停请求，并仅在通过GET /api/v3/ping成功检查健康状况后恢复。