Kairos Timeboost
  • Introduction
  • A Quick Overview of Timeboost
  • Our Express Lane Sub-Auction
  • Submission API
    • timeboost_sendTransaction
    • timeboost_sendBundle
  • Stats APIs
    • Express Lane Status Endpoint
    • Get Order Info
    • Round Sequence
    • Auction stream
  • Resources & Endpoints
Powered by GitBook
On this page
  • Sample Request by Round
  • Sample Request by Timestamp
  • CURL Example
  • Response Example
  1. Stats APIs

Express Lane Status Endpoint

This endpoint returns the status of the current or specified Timeboost round, including its start and end timestamps.

Use this endpoint to determine whether Kairos is the express-lane signer for a given round. If Kairos is not the signer, we will not be running a sub-auction for that round, and express-lane access via Kairos will be unavailable.

Sample Request by Round

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "timeboost_getAuctionWinnerByRound",
  "params": [
      // Integer
      // Specific round you want to find out if we are the winner for.
      1212,           
  ]
}

Sample Request by Timestamp

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "timeboost_getAuctionWinnerByTs",
  "params": [
      // Integer
      // UTC timestamp since the epoch.
      1761238476,           
  ]
}

CURL Example

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "timeboost_getAuctionWinnerByRound",
    "params": [121212],
    "id": 1
  }' \
  https://rpc.kairos-timeboost.xyz/stats

Response Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    // Requested round stats
    "current_winner": "",
    "current_round": 55,
    "current_round_start_timestamp": "2025-01-27 19:51:34 UTC",
    "current_round_end_timestamp": "2025-01-27 19:52:34 UTC",
    
    // Optional next round stats
    "next_winner": "",
    "next_round_start_timestamp": "2025-01-27 19:52:53 UTC",
    "next_round_end_timestamp": "2025-01-27 19:53:53 UTC"
  }
}

We will know the next round winner 15 seconds before the round starts as that's when the auction ends. So for the final 15s of a round you will see both current_winner and next_winner added.

PreviousStats APIsNextGet Order Info

Last updated 2 months ago