---
title: "Reserve breakdown by type"
method: GET
path: "/reserves/breakdown"
tags: ["reserve"]
---

# Reserve breakdown by type

`GET /reserves/breakdown`

Returns total value (USD cents), per-type value sums, value-weighted average APY per type, and each type’s allocation as a percent of the total. Uses the same optional filters as the list endpoint.

## Query parameters

- `type` 1 | 2 | 3
- `startDate` string, date-time
- `endDate` string, date-time

## Response `200`

Aggregated reserve metrics

- ReservesBreakdownResponseDto
  - `totalValueUsdCents` string, required — Total value of all included reserves in USD cents (sum of reserve.value)
  - `byReserveType` ReserveTypeBreakdownItemDto[], required
    - `type` 1 | 2 | 3, required
    - `valueUsdCents` string, required — Sum of reserve values of this type in USD cents
    - `allocationPercent` number, required — Share of total reserve value (0–100), four decimal places
    - `apyPercent` number, required — Value-weighted average APY for this type as a percent (0–100), e.g. 5.25 for 5.25%

## Other responses

- `400` — Invalid query parameters
- `401` — Unauthorized
- `403` — Forbidden — Admin role required

---

[API](https://skmtc.dev/dre/apis/dre-api.md) · [All operations](https://skmtc.dev/dre/apis/dre-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dre/dre-api/revisions/5d14beb9482b/schema)