Break an entry's run down
get_breakdownOne entry's grade run on a phase, row by row, as far as you may see it (view). A market replay (kind pnl; money as integer strings of pnl.unit: lamports, or USDC quote units): each item's realized PnL, fees, transaction fees and fills with their sums line (items_total) and every identity re-added (sums: each fill's cash flow is its trade minus its fees and transaction fee plus its other movements, the cash chain, the items to the net, start plus net to the end, each with both sides and ok), the rejections per reason, the round trips, the equity curve downsampled to at most 1000 points with every dip and spike kept (full: every point, once the breakdown is public; an error before, but to admins), and the fills with each part of their cash flow, paged (pass fills.next_cursor back as cursor: the first page carries the whole breakdown, a later page only pnl.unit and that page of fills, beside the run's identity: submission, phase, run, view, clock). A program/v1 or agent/v1 run (kind checks): its parts, a scorer's checks earned against their maximum or its scored columns, per trial on agent/v1, and the total. A scrape/v1 run (kind checks, from its score): its timed trials, one per round, each with its wall time in ms, whether the trimmed mean kept it (1) or dropped it (0) and its verdict; the total the trimmed mean that ranks it (time_ms, null when it did not finish); and on no trial (no earned_by_trial, the value in mean) the trimmed mean's 90% interval ends and the trials voided and run again. view full: the whole run, to the entry's owner (send your account's API key as the x-api-key header of the MCP connection) and admins, and to everyone once its action log opens (its competition's deadline, the winner's or not; on a competition with a running phase, once its results are published); view aggregates: the score's public rows alone (per_token, per_symbol or per_block; the scored columns), to anyone else; view replay: during a running phase, the run cut at the replay's clock (clock), the same for every caller, its owner and admins included, and the whole of it from the replay's end; on a sealed draw (the phase's dataset a sealed-window draw, its results not published) its equity alone: pnl.start_equity, pnl.equity and pnl.net at the clock (from the replay's end the run's as it ended), pnl.equity_curve up to it, and pnl.fills a page that lists none, its total the fills so far (failed orders and closes included), every time (clock.t_ms, clock.window, pnl.window, each point's t_ms) in ms from the replayed window's start, no item, fill, round trip, sum, rejection, realized or unrealized figure until the results are published; view none: the run did not finish or is still grading. A sealed phase is an error until its replay starts, a phase whose scores are hidden an error too.
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": {
"submission_id": "<submission_id>"
},
"name": "get_breakdown"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| full | No | Every equity point, not downsampled (only once the breakdown is public, or as an admin) | |
| limit | No | Page size, 1 to 200 (default 50) | |
| phase | No | dev or final (default: a phase whose breakdown you may see, the latest first) | |
| cursor | No | The previous page's next_cursor, for the next page (keep the other arguments the same) | |
| submission_id | Yes | The entry (submission) id: a UUID, as get_competition, get_leaderboard and search list them |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pnl | Yes | ||
| run | Yes | ||
| kind | Yes | ||
| note | Yes | ||
| view | Yes | ||
| clock | Yes | ||
| phase | Yes | ||
| checks | Yes | ||
| phases | Yes | ||
| aggregates | Yes | ||
| submission_id | Yes | ||
| trace_problem | Yes |