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

---

[API](https://skmtc.net/hummingbot/apis/hummingbot-api.md) · [All operations](https://skmtc.net/hummingbot/apis/hummingbot-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hummingbot/hummingbot-api/versions/5347fe79537f/schema)