---
title: "Run history (filterable, sortable, paginated)"
method: GET
path: "/v1/backtests"
---

# Run history (filterable, sortable, paginated)

`GET /v1/backtests`

## Request

- Base URL: `https://app.texttoquant.com/api`
- URL: `https://app.texttoquant.com/api/v1/backtests`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

## Query parameters

- `limit` integer
- `offset` integer
- `sort` 'created_at' | 'total_return' | 'win_rate' | 'total_trades' | 'sharpe_ratio' | 'max_drawdown' | 'profit_factor' | 'execution_time_ms'
- `order` 'asc' | 'desc'
- `search` string
- `asset` string
- `timeframe` string
- `tag` string
- `status` 'completed' | 'failed' | 'running' | 'pending'
- `from` string, date
- `to` string, date

## Response `200`

Success

- object
  - `success` true, required
  - `data` object, required

---

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