---
title: "Handler Get Balance Series"
method: GET
path: "/money/balances/series"
---

# Handler Get Balance Series

`GET /money/balances/series`

## Request

- Base URL: `https://api.stablesea.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.stablesea.com/money/balances/series`
- Auth: none declared

## Query parameters

- `symbols` string[]
- `start_ts` string, date-time, required
- `end_ts` string, date-time, required
- `interval_seconds` integer, required
- `category` 'all' | 'cashflow' | 'trade' | 'yield'

## Response `200`

OK

- BalancesGetBalanceSeriesOutput
  - `aggregated` BalancesAggregatedBalancePoint[], nullable
    - `amount_usd` MoneyfmtMoneyAmountView
      - `float` number, double, required
      - `formatted` MoneyfmtFormattedMoneyAmountView, required
        - `compact` string, required
        - `currency_sign` string, required
        - `currency_sign_position` string, required
        - `full` string, required
      - `precise` string, required
      - `symbol` string, required
      - `zero` boolean, required
    - `sampled_ts` string, date-time
  - `rich` BalancesRichBalanceSeries[], nullable
    - `points` BalancesRichBalancePoint[], nullable
      - `amount_native` MoneyfmtMoneyAmountView
        - `float` number, double, required
        - `formatted` MoneyfmtFormattedMoneyAmountView, required
          - `compact` string, required
          - `currency_sign` string, required
          - `currency_sign_position` string, required
          - `full` string, required
        - `precise` string, required
        - `symbol` string, required
        - `zero` boolean, required
      - `amount_usd` MoneyfmtMoneyAmountView
        - `float` number, double, required
        - `formatted` MoneyfmtFormattedMoneyAmountView, required
          - `compact` string, required
          - `currency_sign` string, required
          - `currency_sign_position` string, required
          - `full` string, required
        - `precise` string, required
        - `symbol` string, required
        - `zero` boolean, required
      - `sampled_ts` string, date-time
    - `symbol` string
  - `series` BalancesGroupBalanceSeries[], nullable
    - `points` BalancesGroupBalancePoint[], nullable
      - `balance_native` string
      - `balance_usd` string
      - `pending_incoming_native` string
      - `pending_incoming_usd` string
      - `pending_outgoing_native` string
      - `pending_outgoing_usd` string
      - `priced` boolean
      - `sampled_ts` string, date-time
      - `usd_rate` string
    - `symbol` string
  - `unpriced` string[], nullable: Holdings missing a USD rate in at least one bucket. Their USD projections and the aggregated series are incomplete valuations, not complete balances.

## Other responses

- `default`: Error response.

## Changes

- **2026-10-29** `e003c8a67b62`: 1 info
  - added the optional property `error/authorization` to the response with the `default` status
- **2026-09-11** `5ba4838f5cf7`: 1 info
  - added the optional property `unpriced` to the response with the `200` status
- **2026-09-01** `f2d9f80610d9`: 1 info
  - added the optional property `error/api_client_id` to the response with the `default` status
- **2026-08-26** `533de842b808`: 4 info
  - added the optional property `series/items/points/items/pending_incoming_native` to the response with the `200` status
  - added the optional property `series/items/points/items/pending_incoming_usd` to the response with the `200` status
  - added the optional property `series/items/points/items/pending_outgoing_native` to the response with the `200` status
  - added the optional property `series/items/points/items/pending_outgoing_usd` to the response with the `200` status

[Operation history](https://skmtc.dev/stablesea/apis/stable-sea-backend/changes/money/balances/series/get.md)

---

[API](https://skmtc.dev/stablesea/apis/stable-sea-backend.md) - [All operations](https://skmtc.dev/stablesea/apis/stable-sea-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/stablesea/apis/stable-sea-backend/revisions/772c80d83658?raw)