Get real-time state changes when an address sends/receives ETH or tokens that you track using the Address Activity webhook.
Chain | Mainnet |
---|---|
Ethereum | ✅ |
Introduction
The Address Activity webhook allows you to track any address like EOA or smart contracts. This provides your app with real-time state changes when a token is transferred between addresses, like ETH, ERC20, ERC721 or ERC1155 transfers.
Types of transfers
There are four main types of transfers that occur on the chain between addresses.
Transfer type | Description |
---|---|
external native coin(ETH) | Top-level transaction transfers. |
internal native coin(ETH) | Internal Transfers between addresses. |
token | Event logs for ERC20. |
erc721 or erc1155 | Event logs for ERC721 and ERC1155 transfers. |
Example Response
When a provided address (EOA or smart contracts) exists in a transaction, and you may get its assert transfers or relatived transaction, you receive a response from the webhook that looks like this:
{
"id": "64a636ed247148b19b4ac1d4937b19ba",
"webhookId": "804ad91e-3400-4462-b9f5-afe8b78ea706",
"type": "ADDRESS",
"createdAt": "2023-08-30T11:57:50Z",
"event": {
"network": "eth-mainnet",
"activity": [
{
"category": "internal",
"fromAddress": "0xb67cb505324830dd181498b5b1c8ff7ffe6a49c44f1f02eda1a5214dce56f538",
"toAddress": "0x1635d18f20c9a6e302931faf61643fed57fbcce3",
"internalTransaction": {
"blockNumber": 18027262,
"blockHash": "0x8ab7fa9f37fb3cb19bc6fe43cbc288d64430543fac0325788f3f9638a4982049",
"hash": "0xb67cb505324830dd181498b5b1c8ff7ffe6a49c44f1f02eda1a5214dce56f538",
"from": "0x3fc91a3afd70395cd496c647d5a6cc9d4b2b7fad",
"to": "0x1635d18f20c9a6e302931faf61643fed57fbcce3",
"input": "0x0902f1ac",
"output": "0x0000000000000000000000000000000000000000011b0698ff86e0cecbd5f79100000000000000000000000000000000000000000000000ab82aa8fdac122db10000000000000000000000000000000000000000000000000000000064ef2e07",
"gas": "0x1cfb2",
"gasUsed": "0x9c8",
"type": "STATICCALL",
"value": null,
"error": null,
"revertReason": null,
"callLayer": 6,
"callStack": 2,
"success": true,
"revert": false
}
},
{
"category": "internal",
"fromAddress": "0xb67cb505324830dd181498b5b1c8ff7ffe6a49c44f1f02eda1a5214dce56f538",
"toAddress": "0x1635d18f20c9a6e302931faf61643fed57fbcce3",
"internalTransaction": {
"blockNumber": 18027262,
"blockHash": "0x8ab7fa9f37fb3cb19bc6fe43cbc288d64430543fac0325788f3f9638a4982049",
"hash": "0xb67cb505324830dd181498b5b1c8ff7ffe6a49c44f1f02eda1a5214dce56f538",
"from": "0x3fc91a3afd70395cd496c647d5a6cc9d4b2b7fad",
"to": "0x1635d18f20c9a6e302931faf61643fed57fbcce3",
"input": "0x022c0d9f000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000cca430ef8fb80b0000000000000000000000003fc91a3afd70395cd496c647d5a6cc9d4b2b7fad00000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000000",
"output": null,
"gas": "0x1bb3b",
"gasUsed": "0xece2",
"type": "CALL",
"value": "0x0",
"error": null,
"revertReason": null,
"callLayer": 9,
"callStack": 2,
"success": true,
"revert": false
}
}
]
}
}
Field Definitions
Below you can find descriptions for each field of the response.
Field | Description | Value |
---|---|---|
id | ID of the event. | 64a636ed247148b19b4ac1d4937b19ba |
webhookId | Unique ID of the webhook destination. | 804ad91e-3400-4462-b9f5-afe8b78ea706 |
type | Webhook event type. | ADDRESS |
createdAt | Timestamp when the event notification was created. | 2023-08-30T11:57:50Z |
event | Activity object. | N/A |
network | The default network for the webhook. | eth-mainnet |
activity | List of transfer events whose from or to address matches the address configured in the Address Activity webhook. | N/A |
category | The data standard. | internal |
fromAddress | Transfer from address. | 0xb67cb505324830dd181498b5b1c8ff7ffe6a49c44f1f02eda1a5214dce56f538 |
toAddress | Transfer to address. | 0x1635d18f20c9a6e302931faf61643fed57fbcce3 |
internalTransaction | Internal Transactions that coin transfers between addresses. | N/A |
blockNumber | The number of the block including this transaction. | 18027262 |
blockHash | A hash of the block including this transaction. | 0x8ab7fa9f37fb3cb19bc6fe43cbc288d64430543fac0325788f3f9638a4982049 |
hash | Transaction hash. | 0xb67cb505324830dd181498b5b1c8ff7ffe6a49c44f1f02eda1a5214dce56f538 |
from | The address of the sender. | 0x3fc91a3afd70395cd496c647d5a6cc9d4b2b7fad |
to | The address of the receiver. | 0x1635d18f20c9a6e302931faf61643fed57fbcce3 |
input | The data is sent along with the transaction. | 0x022c0d9f000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000cca430ef8fb80b0000000000000000000000003fc91a3afd70395cd496c647d5a6cc9d4b2b7fad00000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000000 |
output | The transaction output. | null |
gas | Gas provided by the sender. | 0x1bb3b |
gasUsed | The amount of gas used by this specific transaction alone. | 0xece2 |
type | Call type of the transaction. | CALL |
value | Asset transfer value. | 0x0 |
error | Error message. | null |
revertReason | The revert reas |