Event Trigger
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.
Bitcoin Example
{
"protocol": "bitcoin",
"network": "mainnet",
"event_type": "unified_confirmed_tx",
"data": {
"block_number": 831386,
"block_hash": "0000000000000000000157bdde026859b310ba79f905f1514f022d1dd6129a00",
"tx_id": "77d80eb55bc1e99db7617c5b508452306e7049a54e7ec398a25a293339077763",
"txn_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": 27850
}
}
Polkadot Example
{
"protocol": "polkadot",
"network": "mainnet",
"event_type": "unified_confirmed_tx",
"data": {
"block_number": 19580318,
"block_hash": "0xa320e7455e6738a39d8f2bbb4c4903812ebc0be9204beb28aefb30144bc1cbc9",
"tx_id": "19580318-2",
"timestamp": 1708513350,
"status": "completed",
"transfers": [
{
"asset": "native",
"from": "16hwDjDruadQUBZv2G5RT9mL4MBbgvX5FUJpRo6gEMuzCnos",
"value": 157174437,
"event_name": "Balances.Withdraw"
},
{
"asset": "native",
"from": "14bgTMx4gojTVw4YjXLVUaWMPLTgUPLqQrbtY3EKRSbwDXZa",
"value": 35000000000,
"event_name": "Balances.Endowed"
},
{
"asset": "native",
"from": "16hwDjDruadQUBZv2G5RT9mL4MBbgvX5FUJpRo6gEMuzCnos",
"to": "14bgTMx4gojTVw4YjXLVUaWMPLTgUPLqQrbtY3EKRSbwDXZa",
"value": 35000000000,
"event_name": "Balances.Transfer"
},
{
"asset": "native",
"from": "13UVJyLnbVp9RBZYFwFGyDvVd1y27Tt8tkntv6Q7JVPhFsTB",
"value": 125739549,
"event_name": "Balances.Deposit"
},
{
"asset": "native",
"to": "treasury",
"value": 125739549,
"event_name": "Treasury.Deposit"
},
{
"asset": "native",
"from": "14axX6XFbjCeYcCgcYBPHHX8qKXCcdUde8SqG9WbyKyUFjZT",
"value": 31434888,
"event_name": "Balances.Deposit"
}
],
"fee": {
"asset": "native",
"to": "14axX6XFbjCeYcCgcYBPHHX8qKXCcdUde8SqG9WbyKyUFjZT",
"value": 157174437
}
}
}
Schema
Field | Type | Description |
---|---|---|
block_hash | string | The block hash. |
block_number | integer | The block number. |
block_timestamp | integer | The UNIX timestamp when the block was mined/validated. |
tx_id | string | 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 | The status of the transaction when available. The default status for successful transactions is completed and failed for failed transactions. |
transfers | array of transfer | An array of transfers took place during the transaction. See the 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. |
Each protocol can use its fee object to denote the fee paid for a transaction. Currently, we denote two ways to denote the fee:
Type | Description | Protocol/Network |
---|---|---|
Transfer | Represents transfers of assets. | bitcoin/mainnet bitcoin/testnet polkadot/mainnet polkadot/westend |
EVMFee | Represents fees on EVM based chains. | ethereum/mainnet ethereum/holesky polygon/mainnet polygon/testnet |
➡️ Transfer Schema
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. |
➡️ EVMFee Schema
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. |
👋 Need Help?
Contact us through email or our support page for any issues, bugs, or assistance you may need.