> ## Documentation Index
> Fetch the complete documentation index at: https://httpscashapplaunchbitcoinzann69yc4dfud2ascom.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Portfolio Breakdown — Coinbase Advanced Trade API

> GET /api/v3/brokerage/portfolios/{portfolio_uuid} — get a detailed breakdown of holdings, spot positions, and balance metrics for a portfolio.

The **Portfolio Breakdown** endpoint returns a comprehensive view of a single portfolio's financial state, including aggregate balance metrics and a per-asset breakdown of all spot positions. You'll find the total portfolio value, how much is held in cash equivalents versus crypto, and for each position the fiat value, crypto quantity, and the amount available to trade. Use the `portfolio_uuid` from the [List Portfolios](https://httpscashapplaunchbitcoinzann69yc4dfud2ascom.mintlify.site/api/portfolios/list-portfolios.md) endpoint to construct the request. This endpoint requires authentication.

## Endpoint

```
GET https://api.coinbase.com/api/v3/brokerage/portfolios/{portfolio_uuid}
```

## Authentication

**Required.** Include a valid JWT in the `Authorization` header:

```
Authorization: Bearer $JWT
```

## Path Parameters

**portfolio\_uuid** `string` *required*

The UUID of the portfolio you want to inspect. You can retrieve a list of your portfolio UUIDs from the [List Portfolios](https://httpscashapplaunchbitcoinzann69yc4dfud2ascom.mintlify.site/api/portfolios/list-portfolios.md) endpoint.

## Response

**breakdown** `object`

Top-level container for all breakdown data.

**Breakdown object fields**

**portfolio** `object`

High-level portfolio metadata.

**Portfolio metadata fields**

**uuid** `string`

Unique identifier of the portfolio.

**name** `string`

Display name of the portfolio.

**type** `string`

Portfolio type: `DEFAULT`, `CONSUMER`, or `INTX`.

**deleted** `boolean`

`true` if the portfolio has been deleted.

**portfolio\_balances** `object`

Aggregate balance figures for the entire portfolio.

**Portfolio balance fields**

**total\_balance** `object`

Total portfolio value. Contains `value` (string) and `currency` (string, e.g. `"USD"`).

**total\_futures\_balance** `object`

Total value attributed to futures positions. Contains `value` and `currency`.

**total\_cash\_equivalent\_balance** `object`

Total value held in cash or stablecoins. Contains `value` and `currency`.

**total\_crypto\_balance** `object`

Total value held in non-stable crypto assets. Contains `value` and `currency`.

**spot\_positions** `array`

Array of individual asset positions held in the portfolio.

**Spot position fields**

**asset** `string`

Currency code of the asset, e.g. `"BTC"` or `"ETH"`.

**account\_uuid** `string`

UUID of the account (wallet) holding this asset within the portfolio.

**total\_balance\_fiat** `number`

Total value of the position denominated in fiat (USD).

**total\_balance\_crypto** `number`

Total quantity of the asset held.

**available\_to\_trade\_fiat** `number`

Amount of the position available for trading, denominated in fiat.

**allocation** `number`

Percentage of the total portfolio value represented by this position, as a decimal (e.g. `0.42` for 42%).

**one\_day\_change** `number`

24-hour change in the fiat value of this position.

**cost\_basis** `object`

Cost basis of the position. Contains `value` (string) and `currency` (string).

**is\_cash** `boolean`

`true` if the asset is a cash equivalent (e.g. USD, USDC).

## Examples

```bash cURL theme={null}
curl https://api.coinbase.com/api/v3/brokerage/portfolios/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "Authorization: Bearer $JWT"
```

```python Python theme={null}
import requests

portfolio_uuid = "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
url = f"https://api.coinbase.com/api/v3/brokerage/portfolios/{portfolio_uuid}"
headers = {"Authorization": "Bearer $JWT"}

response = requests.get(url, headers=headers)
response.raise_for_status()
breakdown = response.json()["breakdown"]

balances = breakdown["portfolio_balances"]
print(f"Total portfolio value: {balances['total_balance']['value']} {balances['total_balance']['currency']}")

for position in breakdown["spot_positions"]:
    print(
        f"{position['asset']:6s}  "
        f"crypto={position['total_balance_crypto']}  "
        f"fiat=${position['total_balance_fiat']:.2f}  "
        f"allocation={position['allocation']*100:.1f}%"
    )
```

### Response

```json theme={null}
{
  "breakdown": {
    "portfolio": {
      "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "Default Portfolio",
      "type": "DEFAULT",
      "deleted": false
    },
    "portfolio_balances": {
      "total_balance": {
        "value": "52341.88",
        "currency": "USD"
      },
      "total_futures_balance": {
        "value": "0.00",
        "currency": "USD"
      },
      "total_cash_equivalent_balance": {
        "value": "4500.00",
        "currency": "USD"
      },
      "total_crypto_balance": {
        "value": "47841.88",
        "currency": "USD"
      }
    },
    "spot_positions": [
      {
        "asset": "BTC",
        "account_uuid": "d4e5f6a7-b8c9-0123-defa-234567890123",
        "total_balance_fiat": 33922.61,
        "total_balance_crypto": 0.5,
        "available_to_trade_fiat": 33922.61,
        "allocation": 0.6482,
        "one_day_change": 724.50,
        "cost_basis": {
          "value": "29500.00",
          "currency": "USD"
        },
        "is_cash": false
      },
      {
        "asset": "ETH",
        "account_uuid": "e5f6a7b8-c9d0-1234-efab-345678901234",
        "total_balance_fiat": 13919.27,
        "total_balance_crypto": 3.95,
        "available_to_trade_fiat": 13919.27,
        "allocation": 0.2660,
        "one_day_change": 256.87,
        "cost_basis": {
          "value": "11000.00",
          "currency": "USD"
        },
        "is_cash": false
      },
      {
        "asset": "USD",
        "account_uuid": "f6a7b8c9-d0e1-2345-fabc-456789012345",
        "total_balance_fiat": 4500.00,
        "total_balance_crypto": 4500.00,
        "available_to_trade_fiat": 4500.00,
        "allocation": 0.0860,
        "one_day_change": 0.00,
        "cost_basis": {
          "value": "4500.00",
          "currency": "USD"
        },
        "is_cash": true
      }
    ]
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.