Skip to main content
GET
/
wealth
/
accounts
/
{account_id}
/
portfolios
/
{portfolio_id}
/
summary
Get portfolio summary
curl --request GET \
  --url https://api.bluumfinance.com/v1/wealth/accounts/{account_id}/portfolios/{portfolio_id}/summary \
  --header 'Authorization: Basic <encoded-value>'
{
  "portfolio_id": "port_a1b2c3d4e5f6",
  "account_id": "3d0b0e65-35d3-4dcd-8df7-10286ebb4b4b",
  "name": "Main Portfolio",
  "currency": "USD",
  "valuation": {
    "total_value": "125000.00",
    "cash_value": "10000.00",
    "positions_value": "115000.00",
    "unrealized_gain_loss": "15000.00",
    "unrealized_gain_loss_percent": "13.64",
    "as_of": "2025-01-15T16:00:00Z"
  },
  "allocation": {
    "by_asset_class": [
      {
        "asset_class": "equities",
        "value": "62500.00",
        "percent": "50.00"
      },
      {
        "asset_class": "fixed_income",
        "value": "31250.00",
        "percent": "25.00"
      },
      {
        "asset_class": "treasury",
        "value": "25000.00",
        "percent": "20.00"
      },
      {
        "asset_class": "alternatives",
        "value": "6250.00",
        "percent": "5.00"
      }
    ],
    "by_sector": [
      {
        "sector": "technology",
        "value": "25000.00",
        "percent": "20.00"
      },
      {
        "sector": "healthcare",
        "value": "18750.00",
        "percent": "15.00"
      }
    ]
  },
  "rebalancing_status": {
    "needs_rebalancing": false,
    "last_rebalanced_at": "2024-10-01T10:00:00Z",
    "next_scheduled": "2025-01-15",
    "max_deviation_percent": "3.50"
  },
  "strategy_application": {
    "strategy_id": "strat_123456",
    "strategy_version_id": "sv_789012",
    "applied_at": "2024-01-01T10:00:00Z",
    "status": "active"
  },
  "linked_goals": [
    {
      "goal_id": "goal_1234567890",
      "name": "Retirement Fund"
    }
  ],
  "created_at": "2023-01-15T10:30:00Z",
  "updated_at": "2025-01-15T10:30:00Z"
}

Authorizations

Authorization
string
header
required

HTTP Basic Authentication using the API Key as username and API Secret as password.

Path Parameters

account_id
string<uuid>
required
portfolio_id
string<uuid>
required

Query Parameters

refresh_prices
boolean
default:false

Fetch live market prices (adds latency)

Response

Portfolio summary retrieved successfully

Comprehensive portfolio overview

portfolio_id
string<uuid>
account_id
string<uuid>
name
string
currency
string
valuation
object
allocation
object
rebalancing_status
object
strategy_application
object
linked_goals
object[]
created_at
string<date-time>
updated_at
string<date-time>