---
title: "Get Backtest Trades"
method: GET
path: "/v1/backtests/{job_id}/trades"
tags: ["backtests"]
---

# Get Backtest Trades

`GET /v1/backtests/{job_id}/trades`

## Request

- Base URL: `https://api.usekeel.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.usekeel.io/v1/backtests/{job_id}/trades`
- Auth: none declared

A completed run's closed positions, bounded (Q-1893; ``utils.backtest_trades``).

The stored trade rows (one per order that reduced or closed a position)
grouped into positions, entry to exit. No ``asset``/``start``/``end``: a
summary only (counts, win rate, P&L by asset, the best and worst
positions). With a scope: that scope's summary plus one page of
positions and a cursor. ``run_trades`` and ``run_positions`` are the
run's own counts, each null when the run did not record it. One
``results.json`` read, same access rule and 409 as ``/curve``.

## Path parameters

- `job_id` string, required

## Query parameters

- `asset` string, nullable: One asset's positions.
- `start` string, nullable: Entry on/after (YYYY-MM-DD or ISO).
- `end` string, nullable: Entry before (YYYY-MM-DD or ISO).
- `limit` integer
- `cursor` string, nullable: Opaque cursor from a previous page.
- `sort` string

## Headers

- `Authorization` string, nullable
- `X-Org-Id` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/usekeel/apis/keel-api.md) · [All operations](https://skmtc.dev/usekeel/apis/keel-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usekeel/apis/keel-api/revisions/3191ca10b0ab?raw)