unified_confirmed_tx

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

FieldTypeDescription
block_hashstringThe block hash.
block_numberintegerThe block number.
block_timestampintegerThe UNIX timestamp when the block was mined/validated.
tx_idstringThe transaction identifier, such as the transaction hash or other unique identifier.
tx_hashstringThe transaction hash. This only applies to Bitcoin, where transactions have an ID and a hash that might not always be the same value.
statusstringThe status of the transaction when available. The default status for successful transactions is completed and failed for failed transactions.
transfersarray of transferAn array of transfers took place during the transaction. See the Transfer schema for reference.
feeobjectThe 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:

TypeDescriptionProtocol/Network
TransferRepresents transfers of assets.bitcoin/mainnet
bitcoin/testnet
polkadot/mainnet
polkadot/westend
EVMFeeRepresents fees on EVM based chains.ethereum/mainnet
ethereum/holesky
polygon/mainnet
polygon/testnet

➡️ Transfer Schema

FieldTypeDescription
assetstringThe 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.
valueintegerThe 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.
fromstringThe sender's account address.
tostringThe recipient's account address.
event_namestringA 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

FieldTypeDescription
gas_usedintegerThe amount of gas used for the transaction.
gas_priceintegerThe gas price.
gas_limitintegerThe gas limit.
valueintegerThe 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_gasintegerThe maximum fee per gas set for this transaction.
max_priority_fee_per_gasintegerThe 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.