---
title: "Get wallet balance chart"
method: GET
path: "/v1/wallets/{address}/charts/{chart_period}"
tags: ["wallets"]
---

# Get wallet balance chart

`GET /v1/wallets/{address}/charts/{chart_period}`

This endpoint returns a portfolio balance chart for a wallet.
This is over a specified time period, based on the provided start and end timestamps.
Results can be filtered by blockchain and asset type, offering flexible and detailed visualizations of wallet performance, similar to what you see in the Zerion interface.

**Complex positions.** By default the chart counts only simple positions: token and native-coin balances held directly in the wallet. Set `filter[positions]` to `only_complex` or `no_filter` to also include complex DeFi protocol positions. Uniswap V2 LP positions are supported today, and support for more protocols is rolling out over time. Positions from protocols that aren't yet supported are omitted from the chart.

## Path parameters

- `chart_period` 'hour' | 'day' | 'week' | 'month' | '3months' | '6months' | 'year' | '5years' | 'max', required
- `address` union, required — A wallet address, which can be either an EVM or Solana address
  - string — Ethereum-compatible address (EVM).
  - string — Solana address

## Query parameters

- `currency` 'eth' | 'btc' | 'usd' | 'eur' | 'krw' | 'rub' | 'gbp' | 'aud' | 'cad' | 'inr' | 'jpy' | 'nzd' | 'try' | 'zar' | 'cny' | 'chf'
- `filter[chain_ids]` string[]
- `filter[fungible_ids]` string[]
- `filter[exclude_fungible_ids]` string[]
- `filter[pool_addresses]` string[]
- `filter[exclude_pool_addresses]` string[]
- `filter[positions]` 'only_simple' | 'only_complex' | 'no_filter'

## Response `200`

Resource for the requested wallet chart

- Response
  - `links` ResponseLinks, required
    - `self` string, url
  - `data` Container, required
    - `type` 'wallet_chart', required — Resource type
    - `id` string, required — Wallet chart unique identifier
    - `attributes` Attributes
      - `begin_at` string, required — Begin timestamp of the chart
      - `end_at` string, required — End timestamp of the chart
      - `points` array[] — Sorted list of chart points. The spacing between points depends on `chart_period` — see that parameter for the per-period interval.
        - union[] — Chart point - tuple of two items, the first one is timestamp, the second one is a balance in requested currency
          - union
            - integer
            - number

## Other responses

- `400` — Parameters are malformed
- `401` — Unathenticated request
- `429` — Too many requests error

---

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