timeboost_getAuctionWinnerByRound (Deprecated)

Deprecation Notice

These endpoints are deprecated and is removed. Please migrate to the new Auction Stream API to ensure continued functionality.

View the Auction Stream Documentation

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.
    1234,           
  ]
}

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": 121212,
    "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.