Run dataset: trades (run_id comes from GET /v1/backtests/{id})

The numbers behind a finished run. Requires the resultsHistory plan feature. The same data is served to the app at /api/runs/{runId}/trades under a session JWT; this is the key-authed mirror. Page with offset+limit, or ask for maxPoints to get an even downsample of the WHOLE range in one call. Each element is one closed trade. Runs saved since 2026-09-14 also carry entryRegimePostHoc / exitRegimePostHoc: the price action block at the entry / exit bar (1 Trend Up, -1 Trend Down, 0 Quiet Range, 2 Volatile Chop). POST HOC: classified with confirmed pivots, i.e. with bars after the trade opened; not knowable at entry; attribution and display only; never a signal. null = the classifier saw the bar and left it unlabelled; a missing key = never computed (older run): fall back to metrics.regimeBreakdown.segments, never read a missing key as "unclassified".

get/v1/runs/{runId}/trades

Request

  • Base URL: https://app.texttoquant.com/api
  • URL: https://app.texttoquant.com/api/v1/runs/{runId}/trades
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Path parameters

runIdstring uuid required

Query parameters

startstring date-time

ISO 8601 — clip the range

endstring date-time

ISO 8601 — clip the range

limitinteger

First N rows (truncates a long run to its beginning)

maxPointsinteger

Even downsample to at most N rows across the whole range

offsetinteger
raw'1'

Gzip passthrough opt-in; only the literal "1" enables it

Response

Success

successtrue required
dataobject required

Changes

No recorded changes to this operation across all 1 revision of this API.