Backtest Trades
tt_backtest_tradesWhat a finished backtest actually TRADED — its fills, summarised over the whole run and returned one readable page at a time. AUTH-REQUIRED.
Answers the question tt_backtest_status cannot: that tool returns completion
and a report_url, and on a Tradetron-fleet run the numbers live only on that
web page. A client that cannot open a browser (any of the chat channels, or
pip install ttmcp) could run a backtest and never read it. Call this after tt_backtest_status says the run is done, or on any
bt_id from tt_list_backtests.
Returns:
summary computed over EVERY fill: fills, buys, sells, instruments,
first_fill/last_fill, and net_pnl WHEN the run's fills carry a
P&L column (net_pnl_column names which one). A figure that is
ABSENT was not in the data — say so and point at report_url
rather than deriving one.
trades one page of fill rows (count, offset, has_more,
next_offset). Never ask for everything: one run in the QA set
carried 9,823 fills.
csv_url / report_url when Tradetron returns them.
A run with no fills is a RESULT, not a failure — the entry conditions never
triggered in that window; the response says so in note.
Args: job_id: 'ttbt-...' from tt_backtest_strategy, or a bt_id from tt_list_backtests. A 16-hex btengine job id is rejected with a pointer back to tt_backtest_status, which already carries that engine's own results block and csv_url. limit: trade rows per page (default 25, max 200). offset: trade rows to skip.
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": {
"job_id": "<job_id>"
},
"name": "tt_backtest_trades"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Trade rows to return. Default 25, max 200. | |
| job_id | Yes | The run's job_id from tt_backtest_strategy ('ttbt-...') or its bt_id from tt_list_backtests. | |
| offset | No | Trade rows to skip, for paging. Default 0. |