---
title: "Get Portfolio State"
method: POST
path: "/portfolio/state"
tags: ["Portfolio"]
---

# Get Portfolio State

`POST /portfolio/state`

Get the current state of all or filtered accounts portfolio.

Retrieves real-time portfolio balances across all configured accounts and connectors.
By default, returns cached state for fast responses. Use the `refresh` parameter to
fetch live balances from exchanges (slower but more accurate).

Use this endpoint to:
- View current holdings across all accounts and exchanges
- Monitor portfolio value in real-time
- Filter by specific accounts or connectors for focused analysis
- Get CEX-only balances quickly by skipping Gateway wallet lookups

## Request body

- PortfolioStateFilterRequest — Request model for filtering and controlling portfolio state retrieval. Controls which accounts and connectors to include in the portfolio state, and whether to return cached data or fetch fresh balances from exchanges. Example: ```json { "account_names": ["main_account"], "connector_names": ["binance", "bybit"], "skip_gateway": false, "refresh": true } ```
  - `account_names` string[], nullable — Filter to specific accounts. If null/empty, returns all accounts.
  - `connector_names` string[], nullable — Filter to specific connectors/exchanges. If null/empty, returns all connectors.
  - `skip_gateway` boolean — If true, skip Gateway (DEX) wallet balance updates. Significantly faster for CEX-only queries.
  - `refresh` boolean — If true, fetch fresh balances from exchanges (slower but accurate). If false, return cached state (faster).

## Response `200`

Successful Response

- object

## Other responses

- `422` — Validation Error

## Changes

- **2026-01-17** `daa29248aacc` — 2 info
  - added the new optional request property `refresh`
  - added the new optional request property `skip_gateway`
- **2025-12-20** `1005bcd47280` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/hummingbot/apis/hummingbot-api/changes/portfolio/state/post.md)

---

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