Circle's native USDC
Chainhook watches 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913, the USDC Circle issues on Base, with 6 decimals. The older bridged USDbC is a different token and is not detected.
Base USDC transfer notifications, delivered as webhooks
Get a signed webhook when a Base address sends or receives USDC. Chainhook waits 20 blocks, about 40 seconds, then posts the transfer to your endpoint.
USDC on Base 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
- Base
- Issuer
- Circle
- Contract
0x833589fcd6edb6e08f4c7c32d4f71b54bda02913- Decimals
- 6
- Confirmations
- 20
- Time to webhook
- About 40 seconds
How USDC ERC-20 webhooks work
Base blocks arrive every 2 seconds. A poller per address adds up quickly, and missed polls mean missed payments. Chainhook scans every block, waits 20 confirmations, and sends you one event per matching transfer.
Register the address
Create a webhook with
network: "base",type: "token"and the address you want to watch. The signing secret is returned once.Chainhook waits for confirmations
Every Base block is scanned. A matching USDC transfer is held until it is 20 blocks deep, about 40 seconds.
Your endpoint gets a signed POST
A
transfer.detectedevent arrives with anX-Webhook-Signatureheader. Failed attempts are retried automatically, up to 3 attempts in total, waiting 1 minute, then 5 minutes between attempts.
POST /v1/webhooks
{
"network": "base",
"type": "token",
"direction": "in",
"address": "0xddb90d64602398318efec9fceec9f972dd270198",
"webhook_url": "https://api.example.com/webhooks/chainhook"
}Sample webhook payload
What your endpoint receives for an incoming USDC transfer on Base. amount is already scaled by decimals; amount_raw is the on-chain integer.
USDC on Base
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": "base", "direction": "in", "type": "token", "transaction_hash": "0x6e0b7f2a91c4d83e5f1a0b9c27d6e4f38a5c1d9b7e2f0a64c8d3b1e5f9a7c2d4", "transfer_index": 18, "block_number": 52887172, "block_hash": "0x2b9e4d7a1c6f0e3b8d5a2c9f7e1b4d0a6c3f8e5b2d9a7c4f1e0b6d3a8c5f2e9b", "block_timestamp": "2026-10-02T09:41:05Z", "confirmations": 20, "from": "0x2481cd93a232aba0785cf50ac6c22cc2da2ac30d", "to": "0xddb90d64602398318efec9fceec9f972dd270198", "currency": "USDC", "amount": "120", "amount_raw": "120000000", "decimals": 6, "contract_address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913" } }
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
The stablecoin of Base
There's no USDT on Base, so USDC carries most stablecoin payments there, including withdrawals from Coinbase.
Credit once per transfer
Store the event id, or transaction_hash with transfer_index, and skip duplicates. Delivery is at least once.
More on Base and USDC
Base20 confirmations, about 40 seconds
USDC on EthereumUSDC ERC-20, about 2 minutes
USDC on BNB Smart ChainUSDC BEP-20, about 7 seconds
USDC on PolygonUSDC ERC-20, about 2 minutes
USDC on Arbitrum OneUSDC ERC-20, about 6 seconds
USDC on OP MainnetUSDC ERC-20, about 40 seconds
USDC on Avalanche C-ChainUSDC ERC-20, about 20 seconds
USDC on TRONUSDC TRC-20, about 57 seconds- DAI on BaseDAI ERC-20, about 40 seconds
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
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
- 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
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
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.
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.
USDC on Base questions
Can't find your answer? Contact support.
What is the USDC contract address on Base?
0x833589fcd6edb6e08f4c7c32d4f71b54bda02913, issued by Circle, with 6 decimals.
How fast are Base USDC webhooks?
Chainhook waits 20 blocks of 2 seconds, about 40 seconds.
How do I detect an incoming USDC payment on Base?
Create a webhook with network: "base", type: "token", direction: "in" and the receiving address.
Watch your first wallet
Create an account and start with 100 trial detections for 1 month.