Skip to main content
Once portfolios are running, the monitoring layer provides ongoing intelligence — performance tracking, actionable insights, tax optimization opportunities, and formal reports.

​
Portfolio performance

curl -X GET "$BASE_URL/wealth/accounts/$ACCOUNT_ID/portfolios/$PORTFOLIO_ID/performance" \
  -H "Authorization: Basic $AUTH"
Display key metrics:
  • Time-weighted return
  • Dollar gain/loss
  • Benchmark comparison
  • Allocation drift from IPS targets

​
Insights

System-generated observations about the investor’s portfolio: 
curl -X GET "$BASE_URL/wealth/accounts/$ACCOUNT_ID/insights" \
  -H "Authorization: Basic $AUTH"
Insight types:
  • Allocation drift — Portfolio has drifted beyond IPS threshold
  • Performance outlier — A holding is significantly under/overperforming
  • Contribution reminder — Monthly auto-invest approaching, wallet balance low
  • Goal progress — On track / behind schedule for a goal
  • Risk exposure — Concentration risk in a sector or asset

​
Recommendations

Actionable suggestions based on the investor’s situation: 
curl -X GET "$BASE_URL/wealth/accounts/$ACCOUNT_ID/recommendations" \
  -H "Authorization: Basic $AUTH"

​
Tax optimization

Identify tax-loss harvesting and other tax-efficient strategies: 
curl -X GET "$BASE_URL/wealth/accounts/$ACCOUNT_ID/tax-optimization" \
  -H "Authorization: Basic $AUTH"
Show unrealized losses that could be harvested, wash sale considerations, and estimated tax savings.

​
AI assistant

Interactive investment Q&A: 
curl -X POST "$BASE_URL/wealth/accounts/$ACCOUNT_ID/assistant/chat" \
  -H "Authorization: Basic $AUTH" \
  -H "Content-Type: application/json" \
  -d '{ "message": "Should I increase my retirement contribution?" }'

​
Reports

​
Account statements

curl -X GET "$BASE_URL/wealth/accounts/$ACCOUNT_ID/statements?period=2025-Q1" \
  -H "Authorization: Basic $AUTH"

​
Profit & Loss

curl -X GET "$BASE_URL/wealth/accounts/$ACCOUNT_ID/reports/pnl?start=2025-01-01&end=2025-06-30" \
  -H "Authorization: Basic $AUTH"

​
Benchmark comparison

curl -X GET "$BASE_URL/wealth/accounts/$ACCOUNT_ID/reports/benchmark?benchmark=SPY" \
  -H "Authorization: Basic $AUTH"

​
Building a monitoring dashboard

A good monitoring UI includes:
SectionData source
Portfolio value chart/portfolios/{id}/performance
Holdings table/portfolios/{id}/holdings
Insights feed/insights
Goal progress bars/goals
Rebalancing status/portfolios/{id}/rebalancing
Tax optimization alerts/tax-optimization
Refresh performance and holdings data periodically. Insights and recommendations can be fetched less frequently (e.g., on page load).