Skip to content
Chainhook
Sign in

Arbitrum USDC transfer notifications, delivered as webhooks

Get a signed webhook when an Arbitrum One address sends or receives Circle's native USDC, about 6 seconds after the transfer.

Start for freeAPI reference

USDC on Arbitrum One 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
Arbitrum One
Issuer
Circle
Contract
0xaf88d065e77c8cc2239327c5edb3a432268e5831
Decimals
6
Confirmations
20
Time to webhook
About 6 seconds

How USDC ERC-20 webhooks work

Arbitrum produces several blocks per second. Polling an RPC per address burns through rate limits, and log queries have to be paged without gaps. Chainhook scans each block once, waits 20 blocks, and pushes only your transfers.

  1. Register the address

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

  2. Chainhook waits for confirmations

    Every Arbitrum One block is scanned. A matching USDC transfer is held until it is 20 blocks deep, about 6 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": "arbitrum",
  "type": "token",
  "direction": "in",
  "address": "0x865658a2269a5c9333110fd34ea6e143631feffd",
  "webhook_url": "https://api.example.com/webhooks/chainhook"
}

Sample webhook payload

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

USDC on Arbitrum One

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": "arbitrum",
    "direction": "in",
    "type": "token",
    "transaction_hash": "0x5a1e8c3f7d0b4a9e2c6f1d8b3a7e5c0f9d2b6a4e8c1f7d3b0a5e9c2f6d8b4a1e",
    "transfer_index": 11,
    "block_number": 516832801,
    "block_hash": "0x8c3f0a6e2d9b5f1c7a4e0d8b3f6c2a9e5d1b7f4a0c8e3d6b9f2a5c1e7d4b0f8a",
    "block_timestamp": "2026-10-02T09:41:05Z",
    "confirmations": 20,
    "from": "0x2cd4fa2207e4483ecef691fda178f1b6401a8055",
    "to": "0x865658a2269a5c9333110fd34ea6e143631feffd",
    "currency": "USDC",
    "amount": "89.9",
    "amount_raw": "89900000",
    "decimals": 6,
    "contract_address": "0xaf88d065e77c8cc2239327c5edb3a432268e5831"
  }
}

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

Native USDC, not USDC.e

Chainhook watches 0xaf88d065e77c8cc2239327c5edb3a432268e5831, the USDC Circle issues on Arbitrum. The older bridged USDC.e is a different token and is not detected.

Six decimals

USDC on Arbitrum uses 6 decimals. Use the amount string or scale amount_raw by decimals.

One webhook for both stablecoins

A token webhook on an Arbitrum address reports USDC and USDT alike. Filter on currency if you only accept one.

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 Arbitrum One questions

Can't find your answer? Contact support.

What is the USDC contract address on Arbitrum?

0xaf88d065e77c8cc2239327c5edb3a432268e5831, issued by Circle, with 6 decimals.

Is bridged USDC.e detected?

No. Only native USDC is detected on Arbitrum. Contact us if you need USDC.e.

Watch your first wallet

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

Start for free