Skip to main content
This guide covers the middle part of the wealth management flow: assessing risk, defining financial goals, and generating a plan that ties everything together.

​
Step 1: Risk assessment

​
Present the questionnaire

Build a UI that collects the investor’s answers to these questions:
QuestionFieldOptions
What is your primary investment goal?investment_goalpreservation, income, balanced, growth, aggressive_growth
How many years until you need this money?time_horizon_yearsNumber
How would you describe your risk tolerance?risk_toleranceconservative, moderate, aggressive
If your portfolio dropped 20%, what would you do?reaction_to_losssell_immediately, wait_and_see, hold_and_wait, buy_more
Do you need regular income from investments?income_needsnone, some, significant
How would you describe your investment knowledge?investment_knowledgebeginner, intermediate, advanced
Have you experienced a major market decline?experienced_major_declineBoolean
What did you do during that decline?action_during_declinesold_everything, sold_some, held_positions, bought_more
What’s the maximum portfolio loss you can accept?largest_acceptable_loss_percentNumber (e.g., 25 for 25%)

​
Submit the assessment

curl -X POST "$BASE_URL/wealth/accounts/$ACCOUNT_ID/risk-assessments" \
  -H "Authorization: Basic $AUTH" \
  -H "Content-Type: application/json" \
  -d '{
    "questionnaire_id": "default-risk-v1",
    "responses": [
      { "question_id": "investment_goal", "answer_id": "growth" },
      { "question_id": "time_horizon", "answer_id": "20_years" },
      { "question_id": "risk_tolerance", "answer_id": "moderate" },
      { "question_id": "reaction_to_loss", "answer_id": "hold_and_wait" },
      { "question_id": "income_needs", "answer_id": "none" },
      { "question_id": "investment_knowledge", "answer_id": "intermediate" }
    ]
  }'

​
Interpret the result

{
  "risk_score": 65,
  "risk_category": "moderate_growth",
  "recommended_equity_allocation": 70,
  "recommended_fixed_income_allocation": 25,
  "recommended_alternatives_allocation": 5
}
Display the risk category and recommended allocation to the user. Allow them to retake the assessment if they disagree.

​
Step 2: Define goals

Create financial goals that anchor the plan: 
# Retirement goal
curl -X POST "$BASE_URL/wealth/accounts/$ACCOUNT_ID/goals" \
  -H "Authorization: Basic $AUTH" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Retirement",
    "type": "retirement",
    "target_amount": "2000000.00",
    "target_date": "2050-01-01",
    "priority": "high",
    "current_savings": "150000.00",
    "monthly_contribution": "2000.00"
  }'

# Education goal
curl -X POST "$BASE_URL/wealth/accounts/$ACCOUNT_ID/goals" \
  -H "Authorization: Basic $AUTH" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "College Fund",
    "type": "education",
    "target_amount": "250000.00",
    "target_date": "2040-09-01",
    "priority": "medium",
    "current_savings": "25000.00",
    "monthly_contribution": "500.00"
  }'

​
Record life events

Life events provide context for plan adjustments: 
curl -X POST "$BASE_URL/wealth/accounts/$ACCOUNT_ID/life-events" \
  -H "Authorization: Basic $AUTH" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "marriage",
    "date": "2025-09-15",
    "financial_impact": "positive"
  }'

​
Step 3: Generate the financial plan

curl -X POST "$BASE_URL/wealth/accounts/$ACCOUNT_ID/financial-plan" \
  -H "Authorization: Basic $AUTH" \
  -H "Content-Type: application/json" \
  -d '{
    "include_goals": true,
    "include_tax_optimization": true,
    "planning_horizon_years": 25
  }'

​
View the plan summary

curl -X GET "$BASE_URL/wealth/accounts/$ACCOUNT_ID/financial-plan/summary" \
  -H "Authorization: Basic $AUTH"
The summary shows projected outcomes for each goal, recommended adjustments, and overall financial health.

​
Presenting results to users

A good wealth management UI shows:
  1. Risk profile — Score, category, and recommended allocation (pie chart)
  2. Goals dashboard — Each goal with progress bar (current savings vs target)
  3. Plan summary — Projected outcomes, confidence levels, recommended actions
  4. Action items — “Increase monthly contribution by $500 to stay on track for retirement”

​
Next steps