Aggregated P&L performance series, equity curve and statistics.

GET

/api/performance

const url = 'https://api.tradr.cloud/api/performance?granularity=day&start=2026-04-15T12%3A00%3A00Z&end=2026-04-15T12%3A00%3A00Z&tz=UTC';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

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

Authed. Computes bucketed P&L series, equity curve and statistics per currency over the requested [start, end) window. Query validation (minimum start date, date order, bucket-count cap) always runs on the REQUESTED window on every tier. When feature gating is enabled and the user is a non-admin Free user, the window is clamped to the last 6 calendar months (plan-tiers L3, REQ-7.1) — never an error: the response is computed over the clamped window and marked with the additive tierWindow field. History metadata (per-currency earliest/most-recent closed timestamps and totals) is never clamped.

Parameters

Query Parameters

granularity

required

string

Allowed values: day week month year

start

required

string format: date-time

end

required

string format: date-time

string

default: UTC

currency

string

Responses

200

The performance response. When the free-tier lookback floor clamped the requested window it carries the additive optional tierWindow: { clamped: true, effectiveStart: ISO date-time, lookbackMonths: integer } field; a window entirely before the floor yields empty series, still marked.

400

Validation error (invalid timezone

401

Not authenticated.

503

TIMEOUT or CLIENT_ABORT.