Skip to main content
GET
/
insights
/
future-performance-monte-carlo
cURL
curl --request GET \
  --url 'https://api.wealthyhood.com/insights/future-performance-monte-carlo?initial=10000&monthly=150&equities_uk=50&equities_eu=50' \
  --header 'Authorization: Bearer <token>' \
  --header 'x-user-id: <x-user-id>'
{
  "futurePerformanceBest": {
    "1y": [
      {
        "date": "2025-01-01T00:00:00.000Z",
        "value": 10000
      },
      {
        "date": "2026-01-01T00:00:00.000Z",
        "value": 12000
      }
    ],
    "10y": [
      {
        "date": "2025-01-01T00:00:00.000Z",
        "value": 10000
      },
      {
        "date": "2035-01-01T00:00:00.000Z",
        "value": 31200
      }
    ]
  },
  "futurePerformanceWorse": {
    "1y": [
      {
        "date": "2025-01-01T00:00:00.000Z",
        "value": 10000
      },
      {
        "date": "2026-01-01T00:00:00.000Z",
        "value": 7800
      }
    ],
    "10y": [
      {
        "date": "2025-01-01T00:00:00.000Z",
        "value": 10000
      },
      {
        "date": "2035-01-01T00:00:00.000Z",
        "value": 12400
      }
    ]
  }
}

Authorizations

​
Authorization
string
header
required

Auth0-issued access token that includes the scopes listed for the route.

Headers

​
x-user-id
string
required

MongoDB identifier of the user (B2B acting investor).

Pattern: ^[a-f0-9]{24}$

Query Parameters

​
initial
string

Initial investment amount. Defaults apply when omitted.

Example:

"10000"

​
monthly
string

Monthly contribution amount. Defaults apply when omitted.

Example:

"150"

Response

Monte Carlo best and worse performance series.

​
futurePerformanceBest
object
required

Map of performance tenor (e.g. 1m, 6m, 1y, 5y, 10y) to arrays of portfolio value points over time. Tenor keys come from the statistics service; a response includes multiple tenors in practice. See the 200 example for the exact shape.

​
futurePerformanceWorse
object
required

Map of performance tenor (e.g. 1m, 6m, 1y, 5y, 10y) to arrays of portfolio value points over time. Tenor keys come from the statistics service; a response includes multiple tenors in practice. See the 200 example for the exact shape.