Frequently asked questions about the Notify API
What does the capacity limit error mean?
The capacity limit error means you've exceeded your total monthly compute units. To upgrade your capacity limits go to your Alchemy dashboard. Below is an example capacity limit error.
{
"webhookId": "wh_127lzhz0dfwwimwe",
"id": "whevt_55i2al4sc2ivp1m8",
"createdAt": "2022-12-05T23:43:16.379Z",
"type": "ADDRESS_ACTIVITY",
"event": {
"error": "Monthly capacity limit exceeded. Visit https://dashboard.alchemy.com/settings/billing to upgrade your scaling policy for continued service."
}
}
What is the x-alchemy-signature?
The x-alchemy-signature is an Alchemy authentication token used to verify the source of your webhook requests and responses. The x-alchemy-signature ensures you’re getting responses from Alchemy and no other malicious source.
Where do I find my Alchemy auth token?
Find your Alchemy auth token in the upper-right corner of your Webhook dashboard by clicking the AUTH TOKEN button.
Alchemy dashboard showing where to copy the Auth Token for the Webhooks API.
How many webhooks can I create?
These are the number of webhooks you can create per tier!
| Tier | # of Webhooks |
|---|---|
| Free | 5 |
| Pay As You Go | 100 |
| Enterprise | Unlimited |
How many addresses can you add to a single webhook?
For Address Activity webhooks, we reliably support up to 100,000 addresses per single webhook.
For Custom webhooks, with variables, we support a maximum of 10M addresses.
Why am I missing transactions in the response?
Double check that you're parsing the response payload correctly. Remember, transactions are returned in a list. Transactions that are mined within the same block will be returned within the same activity list.
Why are address activity events for the same transaction split across multiple response?
You may notice activity entries from the same transaction being split across multiple requests when using the Address Activity webhooks. This is expected behavior because webhook streams are currently separated by block and type. This means that if there are external, internal and token transfers all within the same transaction that occurred in block 49, you will still receive 3 separate webhook payloads, one for each of them.
What are some best practices when using webhooks with a large number of addresses?
When working with large address lists, we suggest that users assign no more than 100,000 addresses to each webhook. If you find yourself using many addresses, spin up a new webhook to ensure that you have a reliable and scalable system.
How are reorgs handled?
When a chain reorganization occurs, block logs on the old chain will be emitted again with the property removed set to true.
Why am I getting 5xx errors repeatedly setting up a webhook?
You may be seeing repeated 5xx errors because of automatic webhook-retry-logic where requests are retried for non-200 response codes and upon failures to reach your server.
One common mistake we see is users not responding with 2xx status codes on a successful response which will trigger a retry. To resolve, set-up a webhook listener.
How does reaching my CU limit impact my webhook's activity?
If you hit your CU limit and don't have autoscaling activated, all your active webhooks will be set to the 'paused' state. This means they'll temporarily stop operating until you manually unpause them or acquire more CUs.
What happens when my webhooks are in a 'paused' state?
When your webhooks are 'paused', they won't operate or trigger any notifications. You'll need to either wait for more CUs or upgrade to unpause them.
Why won't my paused webhooks automatically unpause after I upgrade or when I acquire more CUs?
We've noticed that many of our users use up all their CUs quickly at the month's start. To ensure these webhooks don't consume resources without proving their value, we ask that you manually unpause them, even after an upgrade.