Tx-Trace
The Tx-Trace service allows traders to get an insight on transactions propagation by the BDN. With the Tx-Trace utility you can know if a transaction was private or public, what region received it first, and the timestamp each region saw it. Traders can optimize their trading bot and infrastructure to minimize latency and processing time.
The Tx-Trace utility has a built-in rate limiting defined by the account tier.
For each region, Tx-Trace will return the timestamp the transaction was processed and the time difference from the first region to process it.

REQUEST

curl
browser
1
curl \
2
-X GET \
3
-H "Content-Type: application/json" \
4
-H "Authorization: <YOUR-AUTHORIZATION-HEADER>" \
5
https://tx-trace.blxrbdn.com/txtrace/<TX_HASH>
Copied!
1
https://tx-trace.blxrbdn.com/txtrace/<TX_HASH>?auth_header=<AUTH_HEADER>
Copied!
parameters
Name
Description
Default
auth_header
Allows the user to include the authentication in the URL string directly.
​
If the authentication is provided in both the header and the URL parameter, the one in the header will be used.
None
readable
Shows the time the transaction was received by each region in a neat string format.
false

RESPONSE

Examples
1
{"txTrace":[
2
{"region":"EU United Kingdom","txTime":"2021-11-09 14:55:54.755","diff":"+0ms"},
3
{"region":"EU Germany","txTime":"2021-11-09 14:55:54.762","diff":"+7ms"},
4
.. ...
5
],
6
"txHash":"4a0c243bc1556c665dc5de722fb425a61e446a122f60a5addefaf7c5b13c2dea",
7
"numberOfRegions":10}
Copied!
Tx-Trace data is available only for a few hours. In case the data has been purged, the following will be displayed (this message will also be displayed for private transactions):
1
{"message":"received no info about transaction <TX hash> from relays"}
Copied!
​
​
Rate Limiting
Tx-Trace is limiting requests if they exceed 2 requests per second. In addition, each tier has a limit to how many requests per day are allowed.
Below are the tiers limits:
Account Tier
Requests Per Day
Enterprise-Elite
500
Enterprise
100
Professional
20
Developer
5
Introductory
2
Last modified 9d ago
Copy link