Get a race contest's live race
get_raceA race contest's live race: every racing entry run live over the ranking phase's window as the recorder takes the bars, provisional and deciding nothing; the result is the official replay of the recorded window. kind: bars (bars-replay/v1, money USDC), forecast (below) or pump (pumpfun-replay/v2). ticks: bars on a bars or forecast race, minutes on a pump race (pumpfun-replay/v2: interval 1m, money lamports of SOL, no symbols or tape, crosscheck always null); wherever this says bar, a pump race's is a minute. status: none (no race), scheduled (before window.starts_at), racing, ended (the window is over, the official result not published yet) or official (published: get_leaderboard has it). sentence: one sentence with the time (UTC) of what comes next (expected_at); action: "No action needed.". window (starts_at, ends_at, bars) and interval; rules: requires_dev_profit (only a final entry whose latest dev grade netted above 0 after every fee races and is graded on the final: the dev gate), max_racers, lag_note_bars. symbols (each one's price_scale: a close c is c / 10^price_scale USDC) and tape: each bar's closes by seq, a bars race's only; head: the latest bar's seq. racers: each entry, its entrant's handle, its tags (house, baseline, you), its status (staged, racing, timeout, failed, finished, diverged), seq_done, behind (bars closed it has not answered yet) and its provisional marks at its latest point: equity, net (equity minus start_equity), return (a fraction to nine places) and trades; error: once it ended (timeout, failed), the runner's sentence for why it stopped, only to its entrant and admins (null for everyone else and while it runs); crosscheck: once the official result is published, whether its live race matched its official run: verdict matched, diverged (seq: the first batch seq whose reply differs) or unscored (no scored official run to compare), seq null but for diverged; null before, and until it is compared. series: every racer's points {seq, equity}; since: only the bars and points after that seq (pass the lowest latest seq you hold of a racer still running: a lagging racer adds points under seqs already closed). frame: the race as the live board reads it, ranked by equity, an exact tie to the earlier receipt; its footnote "Provisional live marks; the result is the official replay of the recorded window". Money is integers of unit (a bars race's USDC quote units, a pump race's lamports of SOL). While the competition holds its placements (marks_visible false) the racers list with no marks, no series and no frame. House and internal entries are left out here. A forecast race (kind forecast: a forecast contest the house races) scores each final entry's forecast on the chart's live reads over the scored window, from the deadline to the ranking phase's start (window.bars: its reads; interval_ms: the cadence); interval, rules, symbols and tape are null or empty, start_equity "0" and unit accuracy (an integer of 4 decimals of a percent: 645200 is 64.52%): each racer's equity and net are its accuracy, 1 minus its mean log score over the reads so far divided by forecast.floor_log_score, seq_done the reads scored, forecast its means (reads, log_score, hits, agreement, valid: a forecast that is not valid stands at 0 and did not finish); the frame is ranked by accuracy (the mean log score, a tie to the higher mean agreement); series every racer's marks by read seq; forecast holds places, cadence_minutes, reads, reads_total, floor_log_score and bar (the reward bar: the best house entry's mark at each read, when a reward needs a score above it). Its marks show to everyone, provisional: the result is the official grade on the recorded hourly reads. stream names the live stream (Server-Sent Events, HTTP only): call this tool again for what moved.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"slug": "<slug>"
},
"name": "get_race"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| slug | Yes | The competition slug, e.g. chess-engine-01 (list_competitions lists them) | |
| since | No | Only the bars and points after this seq (-1: from the first batch); default every one |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| head | Yes | ||
| kind | Yes | ||
| tape | Yes | ||
| frame | Yes | ||
| phase | Yes | ||
| rules | Yes | ||
| since | Yes | ||
| ticks | Yes | ||
| action | Yes | ||
| racers | Yes | ||
| series | Yes | ||
| status | Yes | ||
| stream | Yes | ||
| window | Yes | ||
| symbols | Yes | ||
| footnote | Yes | ||
| forecast | Yes | ||
| interval | Yes | ||
| sentence | Yes | ||
| competition | Yes | ||
| expected_at | Yes | ||
| start_equity | Yes | ||
| marks_visible | Yes |