Skip to content
These docs describe Tradr v0.17.0. Running an older release? Check the release notes for what changed.

Per-dimension performance breakdown for one window.

GET
/api/performance/breakdown
curl --request GET \
--url 'https://api.tradr.cloud/api/performance/breakdown?by=symbol&start=2026-04-15T12%3A00%3A00Z&end=2026-04-15T12%3A00%3A00Z&tz=UTC'

Authed. Segments the closed-in-window position set by one dimension and returns per-currency statistics for each group plus the window total. Query validation (timezone, ISO dates, minimum start date, date order, currency) always runs on the REQUESTED window on every tier; there is no bucket-count cap because the breakdown has no buckets.

by
required
string
Allowed values: symbol weekday hour tag compliance

Dimension to group by. This enum is the extension point later specs add dimensions to; trading-rules adds compliance.

start
required
string format: date-time
end
required
string format: date-time
tz
string
default: UTC
currency
string

The breakdown response: per-currency total and rows, plus the multiValued flag (true only for by=tag, where a position counts once per tag).

Validation error (invalid timezone, invalid dates, start before 2000-01-01, start not before end, end beyond today + 1 day, unsupported currency) — identical on every tier.

Not authenticated.

TIMEOUT or CLIENT_ABORT.