Search…
Tx Lifecycle Service
Overview
Tx Lifecycle Service (or TLS for short) is a service that allows the user to monitor if the transaction of interest is mined or if it is reached the certain number of confirmations.
This service is available for users with paid accounts. IQ subscription included.
How To Use
To use TLS, you need to make a POST request to our public API on this address
1
https://api.parsiq.net/v1/transaction-lifecycle
Copied!
And you need to add a payload with your parameters with it. After that the service will send you a webhook callback when the condition is met.
Payload Description
A payload must have this specific structure
1
{
2
"tx_hash": string,
3
"callback_url": string,
4
"confirmations": integer,
5
"chain_id": string
6
}
Copied!
where
- tx_hash: a transaction you want to monitor
- callback_url: an URL of your webhook server
- confirmations: the number of confirmation you want to have before sending the info
- chain_id: on what blockchain does this transaction happen
Supported blockchains
Right now, TLS supports these blockchains:
Blockchain
ID
Ethereum main net
eip155:1Ethereum Rinkeby
eip155:4Binance main net
eip155:56Binance testnet
eip155:97Request Sample
This is an example of a TLS request to our API. We want to get the notification on our webhook server when a transaction hash on Ethereum main net gets six confirmations.
1
curl --location --request POST 'https://api.parsiq.net/v1/transaction-lifecycle' \
2
--header 'Authorization: Bearer YOUR_API_KEY' \
3
--header 'Content-Type: application/json' \
4
--data-raw '{
5
"tx_hash": "0xa7d75798006872348b36ce914a82baf8441fe8067c8cf05dda723135cb6aeea1",
6
"callback_url": "YOUR_WEBHOOK_URL",
7
"confirmations": 6,
8
"chain_id": "eip155:1"
9
}'
Copied!
And when the transaction will be confirmed at least 6 times, you will receive a webhook callback that look like this:
1
{
2
"transaction_hash": "0xa7d75798006872348b36ce914a82baf8441fe8067c8cf05dda723135cb6aeea1",
3
"block_number": 10133814,
4
"block_hash": "0x4b08ee14c890e40d6bbc8b5f622fd0935c790e9307c62c0061d420a0fd97987a",
5
"block_timestamp": 1644329642,
6
"status": 1,
7
"from": "0x10c01D6B0396D9F3B2F06Fc5D3F60bc6Dc9cB1F6",
8
"to": "0xAd03D2BD7D70058DCA058b684Db3A7Ce1BC2f367",
9
"gas_used": 149501,
10
"gas_limit": 4712388,
11
"gas_price": "1886557248",
12
"fee": "282042195133248",
13
"confirmations": 6
14
}
Copied!
Last modified 2mo ago