---
title: "Get portfolio stats"
method: GET
path: "/v1/portfolio/stats"
tags: ["Portfolio"]
---

# Get portfolio stats

`GET /v1/portfolio/stats`

Get trading performance and analytics metrics for a given period. Performance metrics (max drawdown, win rate, sharpe, profit factor) and analytics (win streak, trade duration) are scoped to closed positions within the window.

## Query parameters

- `account` string
- `period` string

## Response `200`

A successful response.

- ApiGetPortfolioStatsResponse — GetPortfolioStatsResponse returns performance and analytics metrics.
  - `account` string
  - `period` string
  - `performance` GetPortfolioStatsResponsePortfolioPerformance — PortfolioPerformance contains risk/return metrics over the period.
    - `max_drawdown` string — Largest peak-to-trough equity decline as a fraction (e.g. "0.1234" = 12.34%). Computed on daily equity. Zero if equity never declined in the period.
    - `win_rate` string — Fraction of closed positions with PnL > 0 (e.g. "0.65" = 65%). Zero if no positions were closed in the window.
    - `sharpe_ratio` string — Annualised Sharpe ratio: (Mean(R) / StdDev(R)) * sqrt(365), where R = daily equity returns. Empty string if fewer than 2 data points (insufficient data).
    - `profit_factor` string — Ratio of total winning PnL to total losing PnL across closed positions. "0" if no winning positions. "Infinity" if wins exist but no losing positions.
  - `analytics` GetPortfolioStatsResponsePortfolioAnalytics — PortfolioAnalytics contains position-lifecycle metrics over the period.
    - `longest_win_streak` string, int64 — Longest consecutive run of closed positions (ordered by close time) with PnL > 0.
    - `avg_trade_duration_seconds` string, int64 — Mean duration from position open to close, in seconds. Zero if no closed positions.
    - `median_trade_duration_seconds` string, int64 — Median duration from position open to close, in seconds. Zero if no closed positions.

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/rise/apis/risex-rest-api.md) · [All operations](https://skmtc.net/rise/apis/risex-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rise/risex-rest-api/versions/194af8339c0d/schema)