Skip to main content
GET
/
wealth
/
accounts
/
{account_id}
/
insights
Get personalized insights
curl --request GET \
  --url https://api.bluumfinance.com/v1/wealth/accounts/{account_id}/insights \
  --header 'Authorization: Basic <encoded-value>'
{
  "account_id": "3d0b0e65-35d3-4dcd-8df7-10286ebb4b4b",
  "generated_at": "2025-01-15T16:00:00Z",
  "insights": [
    {
      "insight_id": "ins_001",
      "category": "tax",
      "title": "Tax Optimization Opportunity",
      "summary": "You have $2,500 in unrealized losses that could offset gains",
      "priority": "high",
      "impact_estimate": "$625 tax savings",
      "action": {
        "type": "tax_loss_harvest",
        "description": "Harvest losses in VTI position",
        "cta_label": "View Details"
      },
      "details": {
        "position_symbol": "XLF",
        "unrealized_loss": "-2500.00",
        "wash_sale_eligible": true,
        "replacement_suggestions": [
          "VFH",
          "IYF"
        ]
      },
      "expires_at": "2025-12-31T23:59:59Z",
      "status": "active"
    },
    {
      "insight_id": "ins_002",
      "category": "opportunity",
      "title": "Outperforming Benchmark",
      "summary": "Your portfolio is outperforming the S&P 500 by 2.3% YTD",
      "priority": "informational",
      "details": {
        "portfolio_return_ytd": "12.5",
        "benchmark_return_ytd": "10.2",
        "alpha": "2.3"
      },
      "status": "active"
    },
    {
      "insight_id": "ins_003",
      "category": "rebalancing",
      "title": "Rebalancing Opportunity",
      "summary": "Portfolio has drifted 8% from target allocation",
      "priority": "medium",
      "action": {
        "type": "rebalance",
        "description": "Rebalance to target allocation",
        "cta_label": "Review Trades"
      },
      "status": "active"
    }
  ],
  "summary": {
    "total_insights": 3,
    "high_priority": 1,
    "actionable": 2
  }
}

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

Query Parameters

category
enum<string>
default:all

Filter by insight category

Available options:
all,
opportunity,
risk,
tax,
rebalancing
limit
integer
default:10

Maximum number of insights to return

Required range: 1 <= x <= 50

Response

Insights retrieved successfully

account_id
string<uuid>
generated_at
string<date-time>
insights
object[]
summary
object