如何为币安上的期货交易设置 Telegram 通知？

Telegram 与币安期货集成

1. 通过桌面浏览器登录您的币安账户，然后导航至“安全设置”下的“API 管理”部分。

2. 生成一个新的 API 密钥，其权限仅限于“只读”和“启用期货”——切勿启用“启用保证金”或“启用提款”以仅供通知使用。

3.立即复制API Key和Secret Key；创建秘钥后，币安将不再显示秘钥。

4. 安装第三方 Telegram 机器人，例如BinanceAlertBot ，或使用 Python 和 python-telegram-bot 库配置自定义 Webhook 脚本。

5. 将您的 Binance API 凭证粘贴到机器人的配置界面或环境变量中，然后授权机器人每 30 秒获取一次位置更新。

所需的权限和安全限制

1. 由于 2025 年有记录的滥用案例，币安严格禁止具有提款或保证金权限的 API 密钥在外部机器人中使用。

2. /fapi/v2/positionRisk等期货仓位数据端点需要签名认证，如果没有有效的带时间戳的 HMAC-SHA256 签名，则无法访问。

3. Telegram 机器人必须在隔离的基础设施上运行——2026 年第一季度，共享 VPS 环境已导致 Bitget 和 Bybit 用户发生 17 起已确认的凭证泄露事件。

4. 速率限制：币安对合约 API 每分钟强制执行 2400 个请求；超过此值会触发基于 IP 的限制，持续时间长达 5 分钟。

消息格式和警报触发器

1. 默认警报包括入场价格、杠杆、未实现盈亏和清算价格——全部在 Telegram 消息中以等宽字体呈现。

2. 用户可以使用基于正则表达式的过滤器定义自定义阈值，例如： “PnL > 0.5% OR LiqPrice inside 1.2% of mark” 。

3. 未平仓订单仅在状态从“NEW”更改为“FILLED”时才会触发通知，不包括部分成交，除非明确启用。

4. 每个警报都带有从订单 ID 和服务器时间戳派生的唯一交易 ID 哈希值，防止网络重试期间重复消息注入。

常见故障排除

1. 空白仓位数据通常表示 API 密钥权限已过期 - 验证币安安全仪表板中的“启用期货”是否保持选中状态。

2. 延迟警报超过 8 秒表明 Telegram 服务器端速率限制；如果使用手动脚本，请将轮询频率减少到每 45 秒一次。

3. 签名错误（代码-1022）源于时钟偏差超过 60 秒 - 在重新启动机器人服务之前将系统时间与 pool.ntp.org 同步。

4. 当机器人跳过解析响应中的positionAmt字段，将零余额头寸误认为不活跃头寸时，就会出现缺少强平警告。

常见问题解答

问：我可以在不泄露 API Secret 的情况下接收币安期货的 Telegram 提醒吗？答：不需要。所有官方币安期货数据检索都需要包含密钥的签名请求。切勿将其粘贴到未经验证的 Web 表单或公共 GitHub 存储库中。

问：币安是否提供用于期货通知的官方 Telegram 机器人？答：币安不运营或认可任何 Telegram 机器人。所有第三方机器人都是社区开发的，具有固有的执行风险。

问：为什么有些提醒显示的强平价格不正确？答：当机器人使用初始保证金而不是维持保证金计算强平价格时，就会发生这种情况。必须直接从 API 响应中的LiquidationPrice字段中解析正确的值。

问：是否可以仅按交易品种过滤警报，例如 BTCUSDT 或 ETHUSDT？答：是的。大多数高级机器人都支持通过 /subscribe BTCUSDT 等命令或通过列出目标交易品种的 JSON 配置文件进行特定交易品种的订阅。