How-To
Simple Investment Forecast How To
Request
- Bob has £125,000 currently invested in a Stocks & Shares ISA.
- He contributes £800 per month to his ISA.
- He expects to increase his contributions each year, broadly in line with price inflation increases.
- The ISA he holds has an annual charge of: 0.45% pa for balances up to £50k; and 0.25% for funds above that. There are no other charges on the ISA (apart from fund charges).
- His funds are invested: £100,000 in CF Woodford Equity Income A Acc GBP (Citicode KEBA), with a fund charge of 0.1%; £25,000 in BlackRock -Emerging Markets Equity Tracker D Acc (Citicode G6HZ), with a fund charge of 0.25%.
- Future contributions are split 80%/20% into the two funds specified.
- From 01/01/2022 Bob wants to withdraw £5000 a year, increasing in line with RPI
- The tool Bob accesses provides results over 5, 10 and 15 year periods, for 5th, 50th and 95th percentiles.
- Results are in future (ie nominal) values.
{
"contributions": {
"amount": 800,
"frequency": "MONTHLY",
"increase": {
"basis": "RPI",
"rate": 0
}
},
"initialCharges": {
"percentage": 0,
"amount": 0,
"contributionPercentage": 0
},
"annualCharges": {
"amount": 0,
"tieredCharges": [
{
"percentage": 0.45,
"upperLimit": 50000
},
{
"percentage": 0.25
}
]
},
"accumulationTaxationBasis": "NONE",
"funds": [
{
"code": "KEBA",
"balance": 100000,
"contributionPercentage": 80,
"adjustment": 0.1
},
{
"code": "G6HZ",
"balance": 25000,
"contributionPercentage": 20,
"adjustment": 0.25
}
],
"withdrawals": {
"percentage": false,
"amount": 5000,
"increase": {
"basis": "RPI",
"rate": 0
},
"startDate": "2022-01-01"
},
"forecastOptions": {
"terms": [
5,
10,
15
],
"todaysPrices": false,
"percentiles": [
5,
50,
95
]
}
}
Result
- There is a 5% chance that Bob's ISA (including contributions and withdrawals) will be worth less than £123,210.91 in 5 years, £149,394.23 in 10 years and £175,299.02 in 15 years.
- There is a 50% chance that Bob's ISA (including contributions and withdrawals) will be worth less than £205,149.88 in 5 years, £298,888.38 in 10 years and £452,570.94 in 15 years.
- There is a 95% chance that Bob's ISA (including contributions and withdrawals) will be worth less than £334,953.03 in 5 years, £631,593.06 in 10 years and £1,195,719.13 in 15 years.
Please note that this example response is provided to show you the fields and format provided; the numbers do not reflect the results you would receive from the example request above.
{
"results": [{
"percentile": 5,
"terms": [{
"value": 123210.91,
"term": 5
}, {
"value": 149394.23,
"term": 10
}, {
"value": 175299.02,
"term": 15
}]
}, {
"percentile": 50,
"terms": [{
"value": 205149.88,
"term": 5
}, {
"value": 298888.38,
"term": 10
}, {
"value": 452570.94,
"term": 15
}]
}, {
"percentile": 95,
"terms": [{
"value": 334953.03,
"term": 5
}, {
"value": 631593.06,
"term": 10
}, {
"value": 1195719.13,
"term": 15
}]
}]
}
Asset classes
Where fund codes are required as input, you can instead refer to asset classes. See list of codes you can use for assets below.
| Code | Description |
|---|---|
| Returns_File_Cash | Cash |
| Returns_File_Government_Bonds | UK Government Bonds |
| Returns_File_Index_Linked_Bonds | UK Index Linked Bonds |
| Returns_File_Corporate_Bonds_Inv_Grade | Corporate Bonds - Investment Grade |
| Returns_File_Corporate_Bonds_High_Yield | Global High Yield Bonds |
| Returns_File_Global_government_bonds | Global Bonds |
| Returns_File_UK_Equity | UK Equity |
| Returns_File_US_Equity | US Equity |
| Returns_File_Europe_Equity | European Equity |
| Returns_File_Japan_Equity | Japanese Equity |
| Returns_File_Asia_ex_Japan_Equity | Asia ex Japan Equity |
| Returns_File_Global_Emerging_Market_Equity | Emerging Markets Equity |
| Returns_File_Small_cap_UK | UK Small Cap Equity |
| Returns_File_Property | UK Property |
| Returns_File_International_property | International Property |
| Returns_File_Alpha_Strategies | Alternative Investments |
| Returns_File_Commodities | Commodities |
| Returns_File_Inflation | Price Inflation |
| Returns_File_Nil_return | Nil return |