check_exclusive_bundle_bulk

Query your bundles in bulk.

Request Body

{ 
  "start_time": "2025-08-20T17:00:00Z", // ISO8601 formated datatime, query from this time
  "end_time": "2025-08-20T23:59:59Z",   // ISO8601 formated datatime, query to this time
  "limit": 100,                         // (Optional) Limit response to first N number
  "pending_payment": true               // (Optional) If true, will only return bundles that have landed, but pending refund. Default false which returns all bundles from timespan
}

Responses are limited to a maximum of 100,000 bundles, and a timespan of 7 days. Response will include a "last_bundle_time" indicating the timestamp of the last bundle returned, allowing querying from that timestamp if you hit the maximum bundle returned number.

Example Request

curl -X POST https://boost.quasar.win/check_exclusive_bundle_bulk \
     -H "Content-Type: application/json" \
     -H 'Authorization: your-api-key' \
     -d '{
           "start_time": "2025-08-20T17:00:00Z",
           "end_time": "2025-08-20T23:59:59Z", 
           "limit": 10,
         }'

Example Response

{
    "limit": 3,
    "bundles":
    [
        {
            "status": "landed",
            "block_number": 23220513,
            "tx_hashes":
            [
                "0x00cda..."
            ],
            "bundle_hash": "0x8aab...",
            "is_rebroadcast":false,
            "is_quasar_mined":true,            
            "sim_failure_reason": null,
            "kickbacks": [
                {
                   "kickback_amount": "23981209213",
                   "kickback_recipient": "0x1Bs2...",
                   "kickback_percent": 50.0,
                   "kickback_tx_hash": "0x9a3f..."
                }
             ]
        },    
        {
            "status": "includedInBlock",
            "block_number": 23220513,
            "tx_hashes":
            [
                "0x0832..."
            ],
            "bundle_hash": "0xf75e...",
            "is_rebroadcast":true,
            "is_quasar_mined":false,
            "sim_failure_reason": null,
            "kickbacks": []
        },
        {
            "status": "simulationFail",
            "block_number": 23220513,
            "tx_hashes":
            [
                "0x1234..."
            ],
            "bundle_hash": "0xe734...",
            "is_rebroadcast":false,
            "is_quasar_mined":false,
            "sim_failure_reason": "TransactionReverted",
            "kickbacks": []
        }
    ],
    "last_bundle_time": "2025-08-25T20:28:22Z",
    "total_bundles": 3
}

Authentication

To authenticate your requests, include your API key in the Authorization header of each request.

Authorization: <your-api-key>