# TRON USDT 到账 Webhook 接入

更新: 2026-10-19. https://tronhooks.com/docs/zh/use-cases/usdt-deposits/

用 tronhooks.com 在 TRON 主网 USDT 到账并固化后接收签名 HTTP 回调，不必为每个地址维护轮询程序。免费账户支持三个活跃监控，没有每日事件上限。

## 从地址到回调

注册后生成主网 API key，选择 USDT 与 incoming，提供要监控的地址和自己控制的公网接收端。地址不是通知目标，还需要 Webhook URL。

```sh
# Review the inputs first. Running this POST creates a real watch.
# Set TRONHOOKS_API_KEY in your local secret environment, never in a URL.
curl --disable --fail-with-body https://tronhooks.com/v1/watches \
  -H "Authorization: Bearer $TRONHOOKS_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"address":"YOUR_TRON_ADDRESS","asset_filter":"USDT","direction":"incoming","webhook_url":"https://YOUR_RECEIVER.example/webhook"}'
```

一次性保存返回的签名密钥；每条回调先用原始 body 验签，持久化按 `event_id` 去重，可靠接收后返回 2xx。[AI 接入指南](/docs/zh/ai/)与[离线示例](/docs/ai/examples/)提供具体步骤。

## 已确认与时效

事件来自 solidity 节点的已固化数据。广播到固化的等待在投递之前，接收端故障或限流也会增加延迟；不能把它理解为广播后亚秒到账提醒。新建监控不回补之前的交易。

## 收不到通知时

接收端需要公网可达；内网和保留地址会被拒绝，实际投递时还会重新核验 DNS。控制台可以查看响应码与重试。DEAD 表示通知重试耗尽，用事件 API 对账，不要误以为链上转账消失。

## 适用边界

这是通知服务，不生成充值地址、不托管或归集资金。只支持 USDT 和原生 TRX；余额需求请先看[余额与转账的区别](/docs/zh/use-cases/balance-alerts/)。

在[控制台](/app?intent=deposit-webhook)开始，或让 AI 阅读接入指南。当前计费关闭。