---
title: "Get PnL calendar"
method: GET
path: "/v1/portfolio/pnl-calendar"
tags: ["Portfolio"]
---

# Get PnL calendar

`GET /v1/portfolio/pnl-calendar`

## Request

- Base URL: `https://api.testnet.rise.trade`
- URL: `https://api.testnet.rise.trade/v1/portfolio/pnl-calendar`
- Auth: none required
- TypeScript: <https://skmtc.dev/rise/apis/risex-rest-api/docs/v1/portfolio/pnl-calendar/get.ts> (a function with typed inputs; its response is checked against the schema)

Get daily PnL data for a calendar month. daily_pnl = trade equity delta (transfers excluded). Returns per-day values, month total, win days count, and best day.

## Query parameters

- `account` string
- `period` string
- `utc_offset_minutes` integer
- `year` integer
- `month` integer

## Response `200`

A successful response.

- ApiGetPnLCalendarResponse: GetPnLCalendarResponse returns daily PnL data for a range.
  - `account` string
  - `days` GetPnLCalendarResponsePnLCalendarDay[]
    - `date` string, int64: Local-day midnight as Unix timestamp (nanoseconds). When utc_offset_minutes != 0, this is local midnight expressed as a UTC epoch (not actual UTC midnight).
    - `pnl` string
  - `months` GetPnLCalendarResponsePnLCalendarMonthSummary[]
    - `month` string, int64
    - `month_pnl` string
    - `win_days` integer
    - `best_day` GetPnLCalendarResponsePnLCalendarDay: PnLCalendarDay represents PnL for a single day.
      - `date` string, int64: Local-day midnight as Unix timestamp (nanoseconds). When utc_offset_minutes != 0, this is local midnight expressed as a UTC epoch (not actual UTC midnight).
      - `pnl` string
  - `win_days` integer
  - `best_day` GetPnLCalendarResponsePnLCalendarDay: PnLCalendarDay represents PnL for a single day.
    - `date` string, int64: Local-day midnight as Unix timestamp (nanoseconds). When utc_offset_minutes != 0, this is local midnight expressed as a UTC epoch (not actual UTC midnight).
    - `pnl` string

## Other responses

- `default`: An unexpected error response.

---

[API](https://skmtc.dev/rise/apis/risex-rest-api.md) - [All operations](https://skmtc.dev/rise/apis/risex-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rise/apis/risex-rest-api/revisions/98eabcd6a6ad?raw)