Get Order Info

Use this endpoint to trace a transaction/bundle based on a UUID.

A UUID is returned in the response when a transaction/bundle is submitted. This UUID can then be used to query detailed information about the specific submission.

Sample Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "timeboost_getOrderInfo",
  "params": [
      // String
      // UUID that was returned to you when you send the submission.
      "123e4567-e89b-12d3-a456-426614174000",           
  ]
}

CURL Example

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "timeboost_getOrderInfo",
    "params": ["123e4567-e89b-12d3-a456-426614174000"],
    "id": 1
  }' \
  https://rpc.kairos-timeboost.xyz/stats

Response Fields

uuid: uuid of the tx
payload_type: 1 for bundle, 0 for tx
tx_hash: hash of the tx
sender: address of the sender
recv_ts: timestamp when the tx was received
round: round number
seq: sequence number of tx on the express lane
success: true if the tx was successful
seq_ts: timestamp when the tx was send to sequencer

sim_status: is true if the simulation was successful
sim_result: shows the error message on sim failure
sim_tx_hash: the tx that failed the sim
reverted: if the bundle reverted or not

sent_to_sequencer: true if the order was sent to the express lane
seq: seq num of the tx or first tx in case of bundle sent to express lane
seq_ts: send ts of the tx or first tx in case of a bundle sent to the express lane
express_lane_controller: true if at that time kairos is the lane controller
payment: string representation of the payment amount from simulation (in wei)
sim_type: simulation type (e.g., "tob" for top-of-block, "seq" for sequence sim)

Sample Response

Successfully Sent to Express Lane

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "uuid": "fcf51321-8725-478a-bdf7-66fb53a13c7d",
    "payload_type": 1,
    "tx_hash": "",
    "sender": "038c6585b89f9eb7aa1a6215aeec70d80fa68010",
    "recv_ts": "2025-06-17T18:07:08.836Z",
    "round": 371893,
    "sim_status": true,
    "sim_result": "",
    "sim_tx_hash": "",
    "reverted": false,
    "sent_to_sequencer": true,
    "seq": 0,
    "seq_ts": "2025-06-17T18:07:08.850Z",
    "express_lane_controller": true
  }
}

Failed Bundle Simulation

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "uuid": "b8edb6f9-49fb-48f2-8a1b-500819f74d8a",
    "payload_type": 1,
    "tx_hash": "",
    "sender": "038c6585b89f9eb7aa1a6215aeec70d80fa68010",
    "recv_ts": "2025-06-18T10:39:19.390Z",
    "round": null,
    "sim_status": false,
    "sim_result": "nonce too high: address 0x038c6585B89f9eb7aa1A6215aeeC70d80FA68010, tx: 1166 state: 1165",
    "sim_tx_hash": "14238daaa2e9626d58c75a644da4f91c84196773691f4624a811433afeb2acf6",
    "reverted": false,
    "sent_to_sequencer": false,
    "seq": 0,
    "seq_ts": "2025-06-18T10:39:19.390Z",
    "express_lane_controller": false
  }
}

If the uuid is not found, response will be: {"jsonrpc":"2.0","id":1,"result":null}.

Last updated