bloXroute Documentation
WebsiteBlogTwitterDiscord
  • Welcome to bloXroute
  • Introduction
    • Why Use bloXroute?
    • Products
    • Create An Account
    • Technical Support
  • SOLANA
    • Trader API
      • Introduction
        • Regions
        • Authorization
        • Rate Limits
        • Tip and Tipping Addresses
      • Quick Start
        • Transaction Submission
        • Front-Running Protection & Transaction Bundle
        • Go SDK
        • Python SDK
        • Typescript SDK
        • Rust SDK
      • API Endpoints
        • Core Endpoints
          • submit
          • submit-paladin
          • submit-batch
          • balance
          • rate-limit
          • transaction
          • priority-fee
          • GetPriorityFeeStream
          • GetBundleTipStream
          • submit-snipe
        • Pump.fun
          • quotes
          • swap
          • swap-sol
          • GetPumpFunNewTokensStream
          • GetPumpFunSwapsStream
          • GetPumpFunAMMSwapsStream
        • Raydium
          • quotes
          • pools
          • pool-reserves
          • swap
          • cpmm-swap
          • clmm-swap
          • route-swap
          • GetPoolReservesStream
          • GetSwapsStream
          • GetNewRaydiumPoolsStream
          • GetNewRaydiumPoolsByTransactionStream
        • Jupiter
          • quotes
          • swap
          • swap-instructions
          • route-swap
        • Openbook
          • markets
          • orderbooks/{market}
          • depth/{market}
          • tickers/{market}
          • open-orders/{market}
          • unsettled/{market}
          • place
          • replace
          • cancel
          • settle
          • GetOrderbooksStream
          • GetTickersStream
      • Best Performance for Landing Transactions
      • Support
        • API Health
        • Contact us
        • Suggestions
        • Wiki
          • Terms & Concepts
          • Resources
    • Optimized Feed Relay (OFR)
      • Transaction Streamer
      • Gateway and OFR Requirements
      • Gateway and OFR Setup
      • Gateway Startup Arguments
      • OFR performance
      • Logging
      • Submitting Transaction
      • Upgrading Gateway
      • Troubleshooting
  • BSC & ETH
    • EVM Blockchain Distribution Network (BDN)
      • How to Connect
      • The bloXroute Gateway
        • Local Gateway
          • Installation and Startup
            • Authentication & Certificates
            • Requirements
            • Supported Clients
            • GitHub repository option
            • Docker container option
            • Startup Script
            • Startup Arguments
          • General Connectivity Troubleshooting
          • Logging
          • Upgrading your Gateway
        • Add Your Gateway as a Trusted Peer to Your Execution Layer Client
        • Connecting Your Gateway with the Consensus Layer
      • IPs & Relays
        • Relays IPs
        • Private Relays
        • Cloud-API IPs
          • ⏩Reducing Latencies using the BDN
    • APIs
      • Authorization
      • Check Transaction Quota
      • Submit a Transaction
        • Raw Transaction Construction
        • Tx-Validation
        • Batch Transaction
      • Private Transactions
        • ETH Private Transactions
        • BSC Private Transactions
      • Transaction Bundles
        • Bundle Simulation
        • Bundle Validation
        • Bundle Submission
          • BSC Bundle Submission
            • List of BSC Validators
          • ETH Bundle Submission
          • Bundle Submission with Gateway
        • Bundle Tracking
          • BSC Bundle-Trace
          • ETH Bundle-Trace
          • ETH Bundle Inclusion Status
        • Bundle Refunds
          • Priority Fee Refund
          • Bundle Refund
          • Latest Bundle Refunds
      • Backrun Arbitrage
        • BackRunMe: Bundle Submission
          • BSC submit arbOnly
          • ETH submit arbOnly
            • blxr_info
            • ETH arbOnly Simulation
      • Token Launch Sniping
      • Other Utilities
        • List of bloXroute Builders
        • List of External Builders
        • Tx-Trace
        • Ping
    • Streams
      • Requirements
      • Subscription limits
      • Working With Streams
        • Creating a Subscription
          • Websocket
          • gRPC
        • Handling the Notification
          • Websocket
          • gRPC
        • Cancelling a Subscription
          • Websocket
          • gRPC
        • Local Node Validation
      • newTxs and pendingTxs
        • Filters
        • Raw TX Reconstruction
      • BackRunMe: arbOnlyMEV
        • ETH arbOnlyMEV
        • BSC arbOnlyMEV
      • transactionStatus
      • txReceipts
      • newBlocks
      • bdnBlocks
      • ethOnBlock
      • MEVBlockValue
      • MEVNextProposerInfo
    • Block Builders and Validators
      • Validator Gateway
      • MEV Relay (For Validators)
      • Block Submission
      • Proposer MEV-Protect
      • Compliance Lists
      • Preconfirmations
    • Protect RPCs
      • ETH Protect RPC
      • ETH Gas Protect RPC
      • BSC Protect RPC
      • SOL Protect RPC
  • Base Network
    • Submit Transactions
    • Streams
      • GetBdnBlockStream
  • TON NETWORK
    • TON Trader API
      • Quick Start
      • Fee Schedule
      • Connection
      • Submit Signed Transaction
  • Resources
    • BDN Explorer
    • Block Explorer
    • Guides
      • Algorithmic Trading
      • Setting Up a Local Gateway
      • Gateway as Web3 Bridge
    • Architecture
      • BDN Architecture
        • Network Components
        • Performance Techniques
          • Block Compression
          • Cut-through Routing
          • Optimized Topology
      • bloXroute Protocol
        • Versioning
        • Message Structure
        • Message Types
    • Contact Us
Powered by GitBook
On this page
  • REQUEST
  • RESPONSE
  1. BSC & ETH
  2. APIs
  3. Transaction Bundles
  4. Bundle Tracking

ETH Bundle-Trace

The Bundle-Trace service allows traders to check the status of a submitted bundle - see if it has been included on-chain or see what was it's status in bloXroute blocks.

The Bundle-Trace utility has a built-in rate limiting defined by the account tier.

Bundle-Trace returns the bundle hash and block number the bundle was sent to, together with the bundle's result.

REQUEST

curl \
    -X GET \
    -H "Content-Type: application/json" \
    -H "Authorization: <YOUR-AUTHORIZATION-HEADER>" \
    https://tools.bloxroute.com/ethbundletrace/<BUNDLE_HASH>
https://tools.bloxroute.com/ethbundletrace/<BUNDLE_HASH>?auth_header=<AUTH_HEADER>

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

block_number

Allows the user to specify the block number they sent the bundle to. In case the bundle was sent to multiple blocks - this parameter is mandatory

None

RESPONSE

Examples

Bundle is on chain:

{
    "bundle_hash": "0x7c1f4cca45de6c34781f628667ccf071b1992d00ef74b68c2bfa276af84ae2c7",
    "block_number": 18613219,
    "bloXroute": [
        "Receive time: 2023-11-20 13:12:13.464313 +0000 UTC.",
        "Initial simulation: No errors.",
        "Effective gas price: 0.02 gwei.",
        "Bundle first included in bloXroute blocks at 2023-11-20 13:12:22.275585161 +0000 UTC.",
        "% blocks bundle was included: 16.36%.",
        "Reason for not included: other bundles paid more in 24% of bloXroute blocks",
        "% blocks with final simulation errors: 59.64%."
    ],
    "on_chain_status": "Bundle was included in the on-chain block."
}

Bundle failed initial simulation- tx nonce too low

{
    "bundle_hash": "0x0bbe11bc247305ea65432f53058bff69f7091df478bc999c1d3acd38d732f033",
    "block_number": 18613219,
    "bloXroute": [
        "Receive time: 2023-11-20 13:12:04.893906 +0000 UTC.",
        "Initial simulation: nonce too low: address 0x7225D8708b78772f7ccaDc6dF264c42b2b96C35a"
    ],
    "external_builders": [
        "Bundle received by beaverbuild.org at 2023-11-20 13:12:09.011936",
        "Bundle received by rsync-builder.xyz at 2023-11-20 13:12:09.013720",
        "Bundle received by Titan (titanbuilder.xyz) at 2023-11-20 13:12:09.021511"
    ],
    "on_chain_status": "Bundle was not included in the on-chain block."
}

Potential Response components

  • Time when the bundle was received by bloXroute.

  • Initial simulation status - an error that occurred during initial simulation.

  • Effective gas price of the bundle.

  • Time the bundle was first included in bloXroute block.

  • % of how many blocks the bundle was included in.

  • Reason why the bundle was not included in our block - bundle conflicted/reverted/other bundles paid more.

  • % of how many blocks the bundle had final simulation errors in.

  • External builders - in case you chose to send your bundle to external builders, you can see when these builders received the bundle. Available builders are Titan, beaver and rsync.

  • On-chain status - see if the bundle was included in the on-chain block, some of the bundle's txs are included or the bundle is not included at all.

Rate Limiting

Bundle-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

Ultra

60

Enterprise-Elite

60

Enterprise

20

Professional

4

Introductory

4

PreviousBSC Bundle-TraceNextETH Bundle Inclusion Status