---
title: "Get Portfolio Distribution"
method: POST
path: "/portfolio/distribution"
tags: ["Portfolio"]
---

# Get Portfolio Distribution

`POST /portfolio/distribution`

Get portfolio distribution by token with percentage breakdowns.

Analyzes the portfolio and groups holdings by token symbol across all accounts
and connectors. Each token shows its total value, percentage of portfolio,
and detailed breakdown by account and connector.

Use this endpoint to:
- Understand asset allocation across your portfolio
- Identify token concentration risks
- View where each token is held (which accounts/exchanges)
- Generate portfolio composition reports

## Request body

- PortfolioDistributionFilterRequest — Request model for filtering portfolio distribution by token. Used to query how the portfolio is distributed across different tokens, with optional filtering by account and connector. Example: ```json { "account_names": ["main_account", "trading_account"], "connector_names": ["binance", "bybit"] } ```
  - `account_names` string[], nullable — Filter to specific accounts. If null/empty, includes all accounts in distribution.
  - `connector_names` string[], nullable — Filter to specific connectors. If null/empty, includes all connectors in distribution.

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## Changes

- **2025-12-20** `1005bcd47280` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/hummingbot/apis/hummingbot-api/changes/portfolio/distribution/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)