Get the caller's complete role-filtered audit timeline
Reads the existing owner journal for a live auction or the existing shared kairos_execution projection for completed history. Completeness is verified before returning. Raw authority sequence numbers, event IDs, owner/session identifiers, hidden execution identities, and every competing-maker quote event are omitted so gaps cannot disclose private participation.
curl --request GET \
--url https://agora.kairos.trade/v1/auctions/{auctionID}/events \
--header 'Authorization: Bearer <token>'import requests
url = "https://agora.kairos.trade/v1/auctions/{auctionID}/events"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://agora.kairos.trade/v1/auctions/{auctionID}/events', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://agora.kairos.trade/v1/auctions/{auctionID}/events",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://agora.kairos.trade/v1/auctions/{auctionID}/events"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://agora.kairos.trade/v1/auctions/{auctionID}/events")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://agora.kairos.trade/v1/auctions/{auctionID}/events")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"auction_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"as_of": "2023-11-07T05:31:56Z",
"complete": true,
"events": [
{
"type": "<string>",
"occurred_at": "2023-11-07T05:31:56Z",
"state_before": "<string>",
"state_after": "<string>",
"reason": "<string>",
"actor_scope": "SYSTEM",
"quote_revision": "<string>",
"quote_price_atoms": 5000,
"quote_quantity_atoms": 2,
"cancellation_reason_code": "UNSPECIFIED",
"operator_note": "<string>"
}
]
}{
"error": "invalid_auction_id"
}{
"error": "unauthorized",
"message": "authentication required"
}{
"error": "internal_routing_headers_forbidden"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Canonical UUID whose first character is the owner shard (0, 1, or 2).
Response
Complete ordered timeline visible to this principal
True only after the selected durable history is verified contiguous through its authoritative snapshot.
true Ordered caller-visible events. Hidden events do not leave sequence gaps because raw authority coordinates are never exposed.
4096Show child attributes
Show child attributes
Was this page helpful?
curl --request GET \
--url https://agora.kairos.trade/v1/auctions/{auctionID}/events \
--header 'Authorization: Bearer <token>'import requests
url = "https://agora.kairos.trade/v1/auctions/{auctionID}/events"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://agora.kairos.trade/v1/auctions/{auctionID}/events', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://agora.kairos.trade/v1/auctions/{auctionID}/events",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://agora.kairos.trade/v1/auctions/{auctionID}/events"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://agora.kairos.trade/v1/auctions/{auctionID}/events")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://agora.kairos.trade/v1/auctions/{auctionID}/events")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"auction_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"as_of": "2023-11-07T05:31:56Z",
"complete": true,
"events": [
{
"type": "<string>",
"occurred_at": "2023-11-07T05:31:56Z",
"state_before": "<string>",
"state_after": "<string>",
"reason": "<string>",
"actor_scope": "SYSTEM",
"quote_revision": "<string>",
"quote_price_atoms": 5000,
"quote_quantity_atoms": 2,
"cancellation_reason_code": "UNSPECIFIED",
"operator_note": "<string>"
}
]
}{
"error": "invalid_auction_id"
}{
"error": "unauthorized",
"message": "authentication required"
}{
"error": "internal_routing_headers_forbidden"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}
