Skip to content
Chainhook
Sign in

TRON USDT transfer notifications, delivered as webhooks

Get a signed webhook when a TRON address sends or receives USDT TRC-20. Chainhook waits 19 blocks, about 57 seconds, then posts the transfer to your endpoint. No node, no TronGrid polling.

Start for freeAPI reference

USDT on TRON at a glance

The contract Chainhook watches, how amounts are scaled, and how long USDT takes to reach your endpoint.

Token
Tether USD (USDT)
Network
TRON
Issuer
Tether
Contract
TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t
Decimals
6
Confirmations
19
Time to webhook
About 57 seconds

How USDT TRC-20 webhooks work

TronGrid and most public TRON APIs are pull-based: you ask for an address's recent TRC-20 transfers and diff the result. That means one request per address per poll, rate limits that grow with your address count, and gaps when a poll fails. Chainhook reads every block once, waits 19 blocks, and pushes only the transfers that touch your addresses.

  1. Register the address

    Create a webhook with network: "tron", type: "token" and the address you want to watch. The signing secret is returned once.

  2. Chainhook waits for confirmations

    Every TRON block is scanned. A matching USDT transfer is held until it is 19 blocks deep, about 57 seconds.

  3. Your endpoint gets a signed POST

    A transfer.detected event arrives with an X-Webhook-Signature header. Failed attempts are retried automatically, up to 3 attempts in total, waiting 1 minute, then 5 minutes between attempts.

POST /v1/webhooks

{
  "network": "tron",
  "type": "token",
  "direction": "in",
  "address": "TYbZiebZG1GhL7bAFWzCCjp5jcNuFRQjx8",
  "webhook_url": "https://api.example.com/webhooks/chainhook"
}

Sample webhook payload

What your endpoint receives for an incoming USDT transfer on TRON. amount is already scaled by decimals; amount_raw is the on-chain integer.

USDT on TRON

POST /webhooks/chainhook HTTP/1.1
Host: api.example.com
Content-Type: application/json
User-Agent: chainhook/1.x
X-Webhook-Id: 01a0fbfd-4fe4-7a3c-8f21-6b9d0e4c7a15
X-Webhook-Signature: 7a12d02673420517279805cf8188a1a62c6f69706161ba5cf0a8ec91ea66b8e3

{
  "id": "01a0fbfd-4fe4-7a3c-8f21-6b9d0e4c7a15",
  "event": "transfer.detected",
  "created_at": "2026-10-02T09:41:17Z",
  "webhook_id": "01a0fbf2-fadc-7c3e-9b1a-4d6f2e8a5c71",
  "data": {
    "network": "tron",
    "direction": "in",
    "type": "token",
    "transaction_hash": "4525d163eff3bf0e5c28ded2bb25b284d6402ec5b2efffe36339bdd7aeb3a6f4",
    "transfer_index": 0,
    "block_number": 87296870,
    "block_hash": "0000000005340b661f9cf244e075d50226b877c61df82ac6701496fd162af35d",
    "block_timestamp": "2026-10-02T09:41:05Z",
    "confirmations": 19,
    "from": "TKiKQyreyrt8oFnryNib3TizZxhw2KMxkm",
    "to": "TYbZiebZG1GhL7bAFWzCCjp5jcNuFRQjx8",
    "currency": "USDT",
    "amount": "49",
    "amount_raw": "49000000",
    "decimals": 6,
    "contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"
  }
}

Verify the signature

X-Webhook-Signature is a hex HMAC-SHA256 of the raw body, keyed with your webhook's secret. Reject any request where it doesn't match.

import crypto from 'node:crypto';
import express from 'express';

const app = express();

app.post(
  '/webhooks/chainhook',
  express.raw({ type: 'application/json' }),
  (req, res) => {
    const signature = req.get('X-Webhook-Signature') ?? '';
    const expected = crypto
      .createHmac('sha256', process.env.CHAINHOOK_SIGNING_SECRET)
      .update(req.body)
      .digest('hex');

    const valid =
      signature.length === expected.length &&
      crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected));

    if (!valid) {
      return res.sendStatus(401);
    }

    const event = JSON.parse(req.body);
    // Skip event.id if you've already processed it.

    res.sendStatus(200);
  },
);

Crediting USDT deposits safely

Only the real USDT contract

Anyone can deploy a TRC-20 called "Tether USD". Chainhook only reports transfers from Tether's contract, TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t, and contract_address is in every event so you can check it yourself.

Six decimals

USDT on TRON has 6 decimals, so 49 USDT is an amount_raw of 49000000. Use the amount string or amount_raw with an integer or decimal type, never a float.

Credit once per transfer

Delivery is at least once, so the same event can arrive twice. Store the event id, or the pair transaction_hash and transfer_index, and ignore repeats. One transaction can contain several USDT transfers, which is why both values matter.

Sweeping needs energy, receiving does not

Receiving USDT costs the receiver nothing. Moving it out later burns TRX for energy unless the address has staked or rented energy, so budget for that if you sweep deposit addresses.

Pay per detection

Start with 100 trial detections for 1 month and pay only for what you use. Paid plans add detections, webhooks, and per-detection overage.

  • Pay as you go

    $0/month

    Card required, no monthly fee

    • 100 trial detections for 1 month
    • 3 active webhooks
    • $0.001 per detection after the trial
    • Decoded transfers, delivered once confirmed
    Start for free

  • Starter

    $9/month

    or $90/year billed yearly

    • 25,000 detections a month
    • 25 active webhooks
    • $0.0006 per extra detection
    • Decoded transfers, delivered once confirmed
    Subscribe
  • Recommended

    Growth

    $29/month

    or $290/year billed yearly

    • 100,000 detections a month
    • 100 active webhooks
    • $0.0003 per extra detection
    • Decoded transfers, delivered once confirmed
    Subscribe

  • Scale

    $99/month

    or $990/year billed yearly

    • 400,000 detections a month
    • 200 active webhooks
    • $0.0002 per extra detection
    • Decoded transfers, delivered once confirmed
    Subscribe

Enterprise

Custom limits for teams that need more than 400,000 detections a month or more than 200 active webhooks. Contact us and we'll set up a plan around your volume.

Contact support

Prices in USD, plus applicable tax. Billed monthly or yearly, and paid allowances reset monthly. Cancel any time and keep your plan until the period ends.

Compare plans and estimate your bill

USDT on TRON questions

Can't find your answer? Contact support.

How do I detect an incoming USDT TRC-20 payment?

Create a webhook with network: "tron", type: "token", direction: "in" and the receiving address. When USDT arrives and reaches 19 confirmations, Chainhook posts a transfer.detected event with the amount, sender and transaction hash.

How many confirmations does USDT TRC-20 need?

Chainhook waits 19 blocks, about 57 seconds. At that depth a TRON block has been confirmed by enough Super Representatives to be irreversible.

What is the USDT TRC-20 contract address?

TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t, issued by Tether, with 6 decimals.

Can I get a Telegram message for each USDT deposit?

Yes, through a small bridge: point the webhook at your own endpoint, verify the signature, then call the Telegram Bot API. Chainhook sends JSON, not chat messages.

Does Chainhook need my private key?

No. Chainhook only reads public blockchain data. You register a public address and receive events about it.

Can I get notified when USDT leaves my address?

Yes. Use direction: "out" for withdrawals only, or "any" for both directions on one webhook.

Watch your first wallet

Create an account and start with 100 trial detections for 1 month.

Start for free