This event is sent when:
- A new transaction is mined.
- A customer has a rule with the
address
variable type and the variable contains the address of the transaction as its value. The address could be the sender or the recipient of any transfers during the transaction.
Schema
{
"data": {
"block_number": "integer",
"block_hash": "string",
"tx_id": "string",
"tx_hash": "string",
"timestamp": "integer",
"status": "string",
"transfers": [
"array"
],
"multi_sig_transfers": [
"array"
],
"fee": {}
}
}
The table below shows the schema breakdown:
Field | Type | Description |
---|---|---|
block_hash | string | (Required) The block hash. |
block_number | integer | (Required) The block number. |
timestamp | integer | (Required) The UNIX timestamp when the block was mined/validated. |
tx_id | string | (Required) The transaction identifier, such as the transaction hash or other unique identifier. |
tx_hash | string | The transaction hash. This only applies to Bitcoin, where transactions have an ID and a hash that might not always be the same value. |
status | string | (Required) The transaction status when available. The default status for successful transactions is success and failed for failed transactions. |
transfers | array of transfers | An array of transfers took place during the transaction. See the Transfer schema for reference. |
multi_sig_transfers | array of transfers | Applies to DOGE and LTC only. Contains transfers requiring multiple signatures. See the Multi Transfer schema for reference. |
fee | object | The fee paid for this transaction. The default value is Transfer , but some protocols like Ethereum use their object to represent the fee.See the EVMFee schema for reference. |
Each protocol can use its fee object to denote the fee paid for a transaction. See below for more details:
1. Transfer Schema
Represents transfers of assets.
bitcoin/mainnet
bitcoin/testnet
ethereum/mainnet
ethereum/holesky
polkadot/mainnet
polkadot/westend
The table below shows the schema breakdown:
Field | Type | Description |
---|---|---|
asset | string | The asset type of the balance. - For native tokens like Ethereum, the asset will be set to "native". - For non-native tokens will have their denomination. |
value | integer | The value transferred. The value is in the lowest denomination of the asset. For example: - For ETH, the value is in wei .- For BTC, the value is in satoshi . |
from | string | The sender's account address. |
to | string | The recipient's account address. |
event_name | string | A protocol-specific name for the transfer (if applicable). This field can provide more information on the type of transfer. For example, Bitcoin will set this to vin for inputs and vout for outputs. |
Bitcoin Example
{
"protocol": "bitcoin",
"network": "mainnet",
"event_type": "unified_confirmed_tx",
"chain_id": "bip122:000000000019d6689c085ae165831e93",
"data": {
"block_number": 831386,
"block_hash": "0000000000000000000157bdde026859b310ba79f905f1514f022d1dd6129a00",
"tx_id": "77d80eb55bc1e99db7617c5b508452306e7049a54e7ec398a25a293339077763",
"tx_hash": "8dc10b4e32f1d0900e8786cd81875190533c2dc4310a360116409e26a700f19e",
"timestamp": 1233321795,
"status": "success",
"transfers": [
{
"asset": "native",
"from": "bc1qm34lsc65zpw79lxes69zkqmk6ee3ewf0j77s3h",
"value": 22349655,
"event_name": "vin"
},
{
"asset": "native",
"from": "bc1qu3aazsa92k2ws4mu5yzym0gwvdxvdqjmznmjgz",
"value": 582900,
"event_name": "vout"
},
{
"asset": "native",
"from": "bc1qm34lsc65zpw79lxes69zkqmk6ee3ewf0j77s3h",
"value": 4215594,
"event_name": "vout"
},
{
"asset": "native",
"from": "bc1qmwjjeestzkl260sf0zaxcylrjh3krjxmcatst7",
"value": 1376000,
"event_name": "vout"
},
{
"asset": "native",
"from": "bc1qpm3ptrup3lme3dqj30zq3sy54mxuwgta8r5f99",
"value": 174060,
"event_name": "vout"
},
{
"asset": "native",
"from": "bc1qagfwr2yl47ja4gmcu8yqqwx7cppmspdh3tjjaj",
"value": 589630,
"event_name": "vout"
},
{
"asset": "native",
"from": "bc1qgzyta95e4tjkks900j3nzydp732ya6r8z4quv3",
"value": 7680000,
"event_name": "vout"
},
{
"asset": "native",
"from": "bc1qzvkgdx0uma7dkcu4uull5sufm2lnmqf4dgyylf",
"value": 407180,
"event_name": "vout"
},
{
"asset": "native",
"from": "bc1qp6qe3c7sgr9tzx6vjpjjln9hnanlsmxduazgwl",
"value": 374100,
"event_name": "vout"
},
{
"asset": "native",
"from": "bc1pf687nsnhxkynfzs2yt0ertedpjnj6enuqgufyc8qfymcgl8fzn5qdxvg0y",
"value": 980000,
"event_name": "vout"
},
{
"asset": "native",
"from": "bc1qlv7kt6x44xp3xqsyx9896mr68sfs6zvq9ctq70",
"value": 1939139,
"event_name": "vout"
},
{
"asset": "native",
"from": "3GWcpDTJshR9jq9uBufz3ka42pZHgZKe6v",
"value": 1080000,
"event_name": "vout"
},
{
"asset": "native",
"from": "bc1qxrzs7r49zhg6nhpxntzl0u4en2svksw4ynfp8h",
"value": 497411,
"event_name": "vout"
},
{
"asset": "native",
"from": "bc1qzxcunle4hems53uehszlq84fn5cm6ejekd7f0e",
"value": 2288371,
"event_name": "vout"
},
{
"asset": "native",
"from": "bc1qjc0cejltt57te78akwsc5ckuz250czp20r8y52",
"value": 77420,
"event_name": "vout"
},
{
"asset": "native",
"from": "bc1qe8l0s5ktdhpnys388xtt5vd0em8j38h7ktse4q",
"value": 60000,
"event_name": "vout"
}
],
"fee": {
"asset":"native",
"value": 27850
}
}
}
Bitcoin Cash Example
Note:
Bitcoin Cash (BCH) address events use the Cash Address format with the "
bitcoincash
: prefix". To convert between formats, you can use this Cash Address Converter.
{
"protocol": "bitcoincash",
"network": "mainnet",
"event_type": "unified_confirmed_tx",
"chain_id": "bip122:000000000000000000651ef99cb9fcbe",
"data": {
"block_number": 865753,
"block_hash": "000000000000000000a4f070c9f055a00b775657e3a21dc3bdc42438c1ad6c51",
"tx_id": "fabf43c596810f75c68f908c6934751ea1bd66cf93460bedd0ce3c4c1260c04e",
"tx_hash": "fabf43c596810f75c68f908c6934751ea1bd66cf93460bedd0ce3c4c1260c04e",
"timestamp": 1727725093,
"status": "success",
"transfers": [
{
"asset": "native",
"from": "bitcoincash:qp028nlln35nwnv5a9dssw9w57z5n765rgenr3suw6",
"value": 38361552,
"event_name": "vin"
},
{
"asset": "native",
"from": "bitcoincash:qpjpryl2ksq4rwwu00n59wsjc5wksfz4a5su5tud89",
"value": 3169300,
"event_name": "vout"
},
{
"asset": "native",
"from": "bitcoincash:qp028nlln35nwnv5a9dssw9w57z5n765rgenr3suw6",
"value": 35192026,
"event_name": "vout"
}
],
"fee": {
"asset": "native",
"value": 226
}
}
}
USDT Example
Note:
ERC20 token webhooks events use
confirmed_tx_log
instead ofconfirmed_tx
.
{
"protocol": "ethereum",
"network": "mainnet",
"event_type": "unified_confirmed_tx_log",
"chain_id": "eip155:1",
"data": {
"block_number": 19639919,
"block_hash": "0x3160a4d48293477f4b1b156700efb626a34373953f43220f68cba7c97a983e0f",
"tx_id": "0xdd984b4e5e06cf9bccda14f216cf9c546d7ac7468650f5207d07fc03682525a2",
"tx_hash": "0xdd984b4e5e06cf9bccda14f216cf9c546d7ac7468650f5207d07fc03682525a2",
"timestamp": 1712929631,
"status": "success",
"transfers": [
{
"asset": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
"from": "0x8b7b59Ee336c076cd85bC43cD402B5b0526a69e4",
"to": "0xf89d7b9c864f589bbF53a82105107622B35EaA40",
"value": 2500000000
}
]
}
}
2. EVMFee Schema
Represents fees on EVM-based chains.
ethereum/mainnet
ethereum/holesky
optimism/mainnet
polygon/mainnet
polygon/amoy
The table below shows the schema breakdown:
Field | Type | Description |
---|---|---|
gas_used | integer | The amount of gas used for the transaction. |
gas_price | integer | The gas price. |
gas_limit | integer | The gas limit. |
value | integer | The fee value. The value is in the lowest denomination of the asset. For example: - For ETH, the value is in wei .- For BTC, the value is in satoshi . |
max_fee_per_gas | integer | The maximum fee per gas set for this transaction. |
max_priority_fee_per_gas | integer | The maximum priority fee per gas set for this transaction. |
Ethereum Example
{
"protocol": "ethereum",
"network": "mainnet",
"event_type": "unified_confirmed_tx",
"chain_id":"eip155:1",
"data": {
"block_number": 19162260,
"block_hash": "0xc678db39a15056113499816d38820477397ebe68b949eaf986e2db36ca0aeb75",
"tx_id": "0xbc0d1ed22d11cec0f274f2033d5df4166debbdf0396513842c0717e5a70d72ae",
"timestamp": 1707138395,
"status": "success",
"transfers": [
{
"asset": "native",
"from": "0x3A024581D57D017453a67CF961771829B7F608F8",
"to": "0x50E9198221E96b5aBF61159d892837587721549D",
"value": 7000000000000000
}
],
"fee": {
"gas_used": 21000,
"gas_price": 14528344136,
"gas_limit": 21000,
"value": 305095226856000,
"max_fee_per_gas": 15000000000,
"max_priority_fee_per_gas": 1
}
}
}
Optimism Example
{
"protocol": "optimism",
"network": "mainnet",
"event_type": "unified_confirmed_tx",
"chain_id": "eip155:1",
"data": {
"block_number": 126441614,
"block_hash": "0x8ec67a7b960389dda7a8be49066ed72a8468e49d7ae0c8bbbb0ac61788a1d82d",
"tx_id": "0x0362ab493db498d244e83d89249bf93c2945f21d86aaa43fab57db60cceb88bd",
"timestamp": 1728482005,
"status": "success",
"transfers": [
{
"asset": "native",
"from": "0xacD03D601e5bB1B275Bb94076fF46ED9D753435A",
"to": "0x94b008aA00579c1307B0EF2c499aD98a8ce58e58",
"value": 0
}
],
"fee": {
"gas_used": 51838,
"gas_price": 2415506,
"gas_limit": 52232,
"value": 125215000028,
"max_fee_per_gas": 309914500,
"max_priority_fee_per_gas": 309915
}
}
}
3. Multi Transfer Schema
Represents multiple transfers that require signatures.
dogecoin/mainnet
litecoin/mainnet
The table below shows the schema breakdown:
Field | Type | Description |
---|---|---|
asset | string | The asset type of the balance. - For native tokens like Ethereum, the asset will be set to "native". - For non-native tokens will have their denomination. |
from | array of strings | The sender's account address. |
value | integer | The value transferred. The value is in the lowest denomination of the asset. |
event_name | string | A protocol-specific name for the transfer (if applicable). This field can provide more information on the type of transfer. |
Dogecoin Example
This example also applies to Litecoin (LTC).
Note:
DOGE & LTC use the
multi_sig_transfers
property with an array in thefrom
field to include transfers that require multiple signatures.
{
"event_type": "unified_confirmed_tx",
"protocol": "dogecoin",
"network": "mainnet",
"chain_id": "bip122:1a91e3dace36e2be3bf030a65679fe82",
"data": {
"block_number": 5365974,
"block_hash": "a5f8021d1a92710abab7c59b8346748843876abcb21366aac5245313b68f7920",
"tx_id": "d7a5629397ab980b6c542ff6f3536cf72fdeb1551bab6952bc1a0399b22b37d9",
"tx_hash": "d7a5629397ab980b6c542ff6f3536cf72fdeb1551bab6952bc1a0399b22b37d9",
"timestamp": 1725553175,
"status": "success",
"transfers": [
{
"asset": "native",
"from": "DHduiEL2zcf6Xi7QirCdwBnaZqapdMwugr",
"value": 197459530046,
"event_name": "vin"
}
],
"multi_sig_transfers": [
{
"asset": "native",
"from": [
"DU55Nw2hBbHsZHQAXa9jTR6p9c1YfPiYpC",
"DGLjxM6RbGKLZzFhxo9Z6D4aSK5af4YnyX",
"DCV1PZcx3KwCARYZUJUnvyz5SLbzAUeX7o"
],
"value": 973612900000,
"event_name": "vout"
}
],
"fee": {
"asset": "native",
"value": 27850
}
}
}
👋 Need Help?
Contact us through email or our support page for any issues, bugs, or assistance you may need.