Notification: Improved Default Response

We are updating the default webhook notification payload format for accounts created after March 19, 2026.

📘

Note

Existing accounts remain unaffected. All subscriptions for users who created an account before March 19, 2026, will continue using the legacy format unless explicitly updated.

What's Changed

New accounts created after March 19, 2026 will automatically receive a restructured webhook payload with clearer, more explicit fields, including from, to, tokenMetadata, and additional transaction context. This is a non breaking change for existing response as they stay on the old default response.

Why this matters

The new format provides:

• Explicit sender/recipient fields (from, to)
• Structured token metadata
• Additional transaction context (gas usage, timestamps, etc.)

Upgrading existing subscriptions

To switch an existing subscription to the new payload format, use the Update Subscription endpoint:

📘

Update a subscription

POST /v4/subscription/{id}
Configure conditions to trigger notifications only for relevant events.
Explore Docs →

Payload Comparison

Learn more about Templates.

Example: New payload format

{
  "data": {
    "kind": "transfer",
    "blockHash": "0x1234567890abcdef...",
    "blockNumber": 18500000,
    "blockTimestamp": 1699123456,
    "txId": "0xabcdef1234567890...",
    "currency": "ETH",
    "txTimestamp": 1699123456,
    "from": "0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6",
    "to": "0x8ba1f109551bD432803012645Hac136c",
    "value": "1000000000000000000",
    "contractAddress": "0xA0b86a33E6441b8c4C8C0C8C0C8C0C8C0C8C0C8C0C",
    "tokenId": "12345",
    "additionalData": {
      "gasUsed": "21000",
      "gasPrice": "20000000000"
    },
    "tokenMetadata": {
      "type": "nft",
      "decimals": 0,
      "symbol": "NFT",
      "name": "My NFT",
      "uri": "https://api.example.com/metadata/12345"
    },
    "subscriptionId": "64f1a2b3c4d5e6f7g8h9i0j1",
    "subscriptionType": "ADDRESS_EVENT"
  },
  "location": "...",
  "scheme": "..."
}