Skip to content
Chainhook
Sign in

TRON USDC transfer notifications, delivered as webhooks

Get a signed webhook when a TRON address sends or receives USD Coin (USDC). Chainhook waits 19 blocks, about 57 seconds, then posts the transfer to your endpoint.

Start for freeAPI reference

USDC on TRON at a glance

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

Token
USD Coin (USDC)
Network
TRON
Contract
TEkxiTehnzSmSe2XqrBj4w32RUN966rdz8
Decimals
6
Confirmations
19
Time to webhook
About 57 seconds

How USDC 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 USDC 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 USDC transfer on TRON. amount is already scaled by decimals; amount_raw is the on-chain integer.

USDC 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": "8df16a291b9fca26a319b2a95989e693a4f8710ca3fe114d0d0306f19d524eef",
    "transfer_index": 0,
    "block_number": 87297066,
    "block_hash": "0000000005340c2a7f484059db2f0bb060a5272b399cc72a19b540f7c6d81531",
    "block_timestamp": "2026-10-02T09:41:05Z",
    "confirmations": 19,
    "from": "TKiKQyreyrt8oFnryNib3TizZxhw2KMxkm",
    "to": "TYbZiebZG1GhL7bAFWzCCjp5jcNuFRQjx8",
    "currency": "USDC",
    "amount": "250",
    "amount_raw": "250000000",
    "decimals": 6,
    "contract_address": "TEkxiTehnzSmSe2XqrBj4w32RUN966rdz8"
  }
}

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 USDC deposits safely

Only this contract

Chainhook reports USDC transfers from TEkxiTehnzSmSe2XqrBj4w32RUN966rdz8 only. Tokens on TRON that copy the USDC name or symbol are ignored, so a spoofed deposit never reaches your endpoint.

6 decimals

USDC on TRON uses 6 decimals. Credit the amount string, or scale amount_raw by decimals; never parse amounts as floating-point numbers.

One webhook for every stablecoin

A webhook with type: "token" reports every listed token on the address. Filter on currency and contract_address if you only accept USDC.

Credit once per transfer

Delivery is at least once. Store the event id, or transaction_hash with transfer_index, and skip events you have already processed.

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

USDC on TRON questions

Can't find your answer? Contact support.

What is the USDC contract address on TRON?

TEkxiTehnzSmSe2XqrBj4w32RUN966rdz8, with 6 decimals.

How do I detect an incoming USDC transfer on TRON?

Create a webhook with network: "tron", type: "token", direction: "in" and the receiving address. Each confirmed USDC transfer arrives as a transfer.detected event.

How long until a USDC transfer is reported?

About 57 seconds. Chainhook waits 19 blocks on TRON before it sends the event.

Does Chainhook need my private key?

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

Watch your first wallet

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

Start for free