Skip to main content
GET
/
wealth
/
accounts
/
{account_id}
/
insights
Get personalized insights
curl --request GET \
  --url https://service.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
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.bluumfinance.com/llms.txt

Use this file to discover all available pages before exploring further.

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