Bundle Submission — YoorQuezt Docs

Searchers submit bundles to the MEV engine for inclusion in the next block. Bundles are atomically executed -- either all transactions succeed or the entire bundle reverts.

Submit a Bundle

`POST /searcher/bundle`

Request body:

{
  "txs": [
    "0xf86c0a8502540be400...",
    "0xf86c0b8502540be400..."
  ],
  "block_number": "0x129A3E1",
  "min_timestamp": 1710500000,
  "max_timestamp": 1710500060,
  "reverting_tx_hashes": [],
  "replacement_uuid": "550e8400-e29b-41d4-a716-446655440000"
}

Fields:

Field	Type	Required	Description
`txs`	[]string	yes	Signed transaction bytes in execution order.
`block_number`	string	yes	Target block number (hex).
`min_timestamp`	int	no	Earliest Unix timestamp for inclusion.
`max_timestamp`	int	no	Latest Unix timestamp for inclusion.
`reverting_tx_hashes`	[]string	no	Transaction hashes allowed to revert without failing the bundle.
`replacement_uuid`	string	no	UUID for bundle replacement (same UUID replaces previous).

Response:

{
  "bundle_id": "bndl_7f3a2c...",
  "status": "pending",
  "received_at": "2026-03-15T14:30:00Z"
}

Bundle Lifecycle

Bundles are tracked via two boolean fields:

Field	Type	Description
`simulated`	bool	Whether the bundle has been simulated.
`reverted`	bool	Whether the bundle reverted during simulation or execution.

A bundle with simulated: true and reverted: false is eligible for inclusion in the auction.

Query Endpoints

`GET /searcher/bundle/{id}`

Returns the status and metadata for a specific bundle.

Response:

{
  "bundle_id": "bndl_7f3a2c...",
  "bid_wei": "1250000000000000",
  "effective_value": "1250000000000000",
  "simulated": true,
  "reverted": false
}

`GET /searcher/auction`

Returns the current auction pool, including all bundles queued for the next block.

Response:

{
  "pool_size": 14,
  "bundles": [
    {
      "bundle_id": "bndl_7f3a2c...",
      "bid_wei": "2300000000000000",
      "simulated": true,
      "reverted": false
    }
  ]
}

Code Examples

Submit a bundle

curl -X POST https://rpc.yoorquezt.com/searcher/bundle \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $SEARCHER_KEY" \
  -d '{
    "txs": [
      "0xf86c0a8502540be400..."
    ],
    "block_number": "0x129A3E1"
  }'

Check bundle status

curl https://rpc.yoorquezt.com/searcher/bundle/bndl_7f3a2c... \
  -H "Authorization: Bearer $SEARCHER_KEY"

View current auction

curl https://rpc.yoorquezt.com/searcher/auction \
  -H "Authorization: Bearer $SEARCHER_KEY"