Create a subscription (V4)

50 credits per sent Notification + 50 credits per day per subscription

📘

Tip:

When creating notifications on mainnet or testnet, use your API keys from the Dashboard.

Notifications are formatted using Templates.
The recommended template is enriched.
Learn more at: Templates


Supported Notification Types

We support a wide range of notification types, Address Event being the most used :
ADDRESS_EVENT - Triggered for any address-level event or transaction.
INCOMING / OUTGOING_FUNGIBLE_TX - Detects ERC20 or equivalent token transfers.
INCOMING / OUTGOING_NATIVE_TX - Detects native currency transfers (ETH, MATIC, etc.).

For a full explanation of each subscription type, see the Subscriptions Overview.


Webhook Response Format

(Recommended Default: templateId = "enriched")

If you do not specify a custom template you get the response in legacy format, but we recommend using the built-in enriched template.
It provides clean, human-readable fields and token metadata.

To learn about legacy format, custom templates, or enriched_with_raw_data, visit:
👉 Templates Page


Example: Enriched Template Webhook (Recommended)

This is what you will receive in your webhook listener if you set:

json
{
  "data": {
    "kind": "transfer",
    "blockHash": "0x1234567890abcdef...",
    "blockNumber": 18500000,
    "blockTimestamp": 1699123456,
    "txId": "0xabcdef1234567890...",
    "currency": "ETH",
    "txTimestamp": 1699123456,
    "from": "0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6",
    "to": "0x8ba1f109551bD432803012645Hac136c",
    "value": "1000000000000000000",

    "contractAddress": "0xA0b86a33E6441b8c4C8C0C8C0C8C0C8C0C8C0C8C",
    "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": "..."
}
Language
Credentials
Header
Click Try It! to start a request and see the response here!