---
title: "Home balance chart"
method: GET
path: "/home/balance_chart"
tags: ["home"]
---

# Home balance chart

`GET /home/balance_chart`

Returns the USD-equivalent balance series for the authenticated group over the requested duration, optionally filtered to a single asset.

## Query parameters

- `duration` string
- `symbol` 'all' | 'USDC' | 'BTC' | 'WTGXX' | 'WTSIX' | 'FLTTX' | 'STEAKUSDC' | 'XLM'
- `timezone` string

## Response `200`

OK

- HomeBalanceChartOutput
  - `delta_positive` boolean
  - `end_value_usd` string
  - `points` HomeBalanceChartPoint[], nullable
    - `balance_usd` string
    - `label` string
    - `now` boolean
    - `pending_incoming_usd` string
    - `pending_outgoing_usd` string
    - `sampled_ts` string, date-time
    - `settled_usd` string
    - `value` number, double
  - `range_label` string
  - `start_value_usd` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `default` — Error response.

## Changes

- **2026-09-01** `f2d9f80610d9` — 4 info
  - added the optional property `error/api_client_id` to the response with the `400` status
  - added the optional property `error/api_client_id` to the response with the `401` status
  - added the optional property `error/api_client_id` to the response with the `403` status
  - added the optional property `error/api_client_id` to the response with the `default` status
- **2026-08-26** `533de842b808` — 3 info
  - added the optional property `points/items/pending_incoming_usd` to the response with the `200` status
  - added the optional property `points/items/pending_outgoing_usd` to the response with the `200` status
  - added the optional property `points/items/settled_usd` to the response with the `200` status
- **2026-08-24** `19fa7a7499bd` — 4 info
  - added the new optional `query` request parameter `symbol`
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`

[Change history](https://skmtc.dev/stablesea/apis/stable-sea-backend/changes/home/balance_chart/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-service-production.skmtc.workers.dev/v1/apis/stablesea/stable-sea-backend/revisions/f2d9f80610d9/schema)
