---
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.

Args:
    filter_request: JSON payload with filtering criteria including:
        - account_names: Optional list of account names to filter by
        - connector_names: Optional list of connector names to filter by
        - skip_gateway: If True, skip Gateway wallet balance updates for faster CEX-only queries
        - refresh: If True, refresh balances before returning. If False (default), return cached state

Returns:
    Dict containing account states with connector balances and token information

## Request body

- PortfolioStateFilterRequest — Request model for filtering portfolio state
  - `account_names` string[], nullable — List of account names to filter by
  - `connector_names` string[], nullable — List of connector names to filter by
  - `skip_gateway` boolean — Skip Gateway wallet balance updates for faster CEX-only queries
  - `refresh` boolean — If True, refresh balances before returning. If False, return cached state

## Response `200`

Successful Response

- object

## Other responses

- `422` — Validation Error

## Changes

- **2026-04-08** `92703f48a69e` — 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **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/5347fe79537f/schema)