Performance per calendar year endpoints
Performance per calendar year for a single fund
GET
/api/v1/performance-years/ISIN/Params
| Param | Description | Notice |
|---|---|---|
| isin | International Securities Identification Number (ISIN) | Mandatory This is part of the endpoint's URL. |
| format | Format of the response data (
json or
xml) |
Not necessary to provide as URL part. When provided it will overwrite the Accept-Header. |
Response data single fund
| Field | Type | Description |
|---|---|---|
| fund | Object | List of basic fund data (see details) |
| years | Object | List of all performance data per calendar year |
Example response (JSON)
GET
/api/v1/performance-years/DE0005321459/?format=json{
"fund": {
"name": "HANSAsecur",
"isin": "DE0008479023",
"wkn": "847902",
"fund_inception_date": "1970-01-02",
"status_date": "2023-03-16",
"url": "https://fondswelt.hansainvest.com/de/fonds/details/6"
},
"years": {
"2017": 2.45,
"2016": -7.55,
"2015": 12.52,
"2014": -1.33,
"2013": 26.38,
"2012": 26.02,
"2011": -17.3,
"2010": 19.36,
"2009": 24.21,
"2008": -33.35,
"2007": 2.89,
"2006": 28.05,
"2005": 36.84,
"2004": 12.54,
"2003": 41.72,
"2002": -28.34,
"2001": -10.92,
"2000": 9.06,
"1999": 20.11,
"1998": 2.93,
"1997": 22.22,
"1996": 10.87,
"1995": 0.97,
"1994": -11.08,
"1993": 45.86,
"1992": -7.65,
"1991": -11.44,
"1990": -13.22,
"1989": 12.32,
"1988": 29.97,
"1987": -37.5,
"1986": 1.32,
"1985": 56.57,
"1984": 8.41,
"1983": 24.62,
"1982": 8.13,
"1981": 1.9,
"1980": 0.88,
"1979": -6.7,
"1978": 6.55,
"1977": 10.12,
"1976": -6.48,
"1975": 31.81,
"1974": 2.42,
"1973": -13.83,
"1972": 7.87,
"1971": 2.64,
"1970": -3.04
}
}
Example response (XML)
GET
/api/v1/performance-years/DE0005321459/?format=xml<?xml version="1.0"?>
<root>
<fund>
<name>HANSAsecur</name>
<isin>DE0008479023</isin>
<wkn>847902</wkn>
<fund_inception_date>1970-01-02</fund_inception_date>
<status_date>2023-03-16</status_date>
<url>https://fondswelt.hansainvest.com/de/fonds/details/6</url>
</fund>
<years>
<item key="2017">2.45</item>
<item key="2016">-7.55</item>
<item key="2015">12.52</item>
<item key="2014">-1.33</item>
<item key="2013">26.38</item>
<item key="2012">26.02</item>
<item key="2011">-17.3</item>
<item key="2010">19.36</item>
<item key="2009">24.21</item>
<item key="2008">-33.35</item>
<item key="2007">2.89</item>
<item key="2006">28.05</item>
<item key="2005">36.84</item>
<item key="2004">12.54</item>
<item key="2003">41.72</item>
<item key="2002">-28.34</item>
<item key="2001">-10.92</item>
<item key="2000">9.06</item>
<item key="1999">20.11</item>
<item key="1998">2.93</item>
<item key="1997">22.22</item>
<item key="1996">10.87</item>
<item key="1995">0.97</item>
<item key="1994">-11.08</item>
<item key="1993">45.86</item>
<item key="1992">-7.65</item>
<item key="1991">-11.44</item>
<item key="1990">-13.22</item>
<item key="1989">12.32</item>
<item key="1988">29.97</item>
<item key="1987">-37.5</item>
<item key="1986">1.32</item>
<item key="1985">56.57</item>
<item key="1984">8.41</item>
<item key="1983">24.62</item>
<item key="1982">8.13</item>
<item key="1981">1.9</item>
<item key="1980">0.88</item>
<item key="1979">-6.7</item>
<item key="1978">6.55</item>
<item key="1977">10.12</item>
<item key="1976">-6.48</item>
<item key="1975">31.81</item>
<item key="1974">2.42</item>
<item key="1973">-13.83</item>
<item key="1972">7.87</item>
<item key="1971">2.64</item>
<item key="1970">-3.04</item>
</years>
</root>
Performance per calendar year for all funds
GET
/api/v1/performance-years-all/Params
| Param | Description | Notice |
|---|---|---|
| format | Format of the response data (
json or
xml) |
Not necessary to provide as URL part. When provided it will overwrite the Accept-Header. |
Response data all funds
| Field | Type | Description |
|---|---|---|
| funds | Object | List of all funds performance data per calendar year by ISIN (see details) |
Example response (JSON)
GET
/api/v1/performance-years-all/?format=json{
"funds": {
"DE000A1H44G8": {
"fund": {
"name": "3ik-Strategiefonds I Class I",
"isin": "DE000A1H44G8",
"wkn": "A1H44G",
"fund_inception_date": "2011-12-01",
"status_date": "2023-03-16",
"url": "https://fondswelt.hansainvest.com/de/fonds/details/151"
},
"years": {
"2017": -0.69,
"2016": 0.34,
"2015": 0.09,
"2014": 2.87,
"2013": 1.14,
"2012": 5.67,
"2011": -0.04
}
},
"DE0009766212": {
"fund": {
"name": "HANSAgeldmarkt",
"isin": "DE0009766212",
"wkn": "976621",
"fund_inception_date": "1994-11-02",
"url": "https://fondswelt.hansainvest.com/de/fonds/details/1"
},
"years": {
"2017": -0.41,
"2016": 0.23,
"2015": -0.12,
"2014": 0.22,
"2013": 0.32,
"2012": 1.62,
"2011": 1.3,
"2010": 0.78,
"2009": 4.24,
"2008": 1.56,
"2007": 3.08,
"2006": 2.29,
"2005": 1.78,
"2004": 1.68,
"2003": 2.38,
"2002": 2.8,
"2001": 4.08,
"2000": 3.61,
"1999": 2.34,
"1998": 3.02,
"1997": 2.58,
"1996": 2.85,
"1995": 4.35,
"1994": 0.59
}
},
"DE0005321459": {
"fund": {
"name": "HANSAinternational Class I",
"isin": "DE0005321459",
"wkn": "532145",
"fund_inception_date": "2006-12-14",
"url": "https://fondswelt.hansainvest.com/de/fonds/details/41"
},
"years": {
"2017": 2.17,
"2016": 3.91,
"2015": 4.01,
"2014": 10.55,
"2013": -4.75,
"2012": 8.09,
"2011": 3.24,
"2010": 12.57,
"2009": 11.43,
"2008": 1.48,
"2007": -2.19,
"2006": -0.66
}
},
"DE0008479023": {
"fund": {
"name": "HANSAsecur",
"isin": "DE0008479023",
"wkn": "847902",
"fund_inception_date": "1970-01-02",
"url": "https://fondswelt.hansainvest.com/de/fonds/details/6"
},
"years": {
"2017": 2.45,
"2016": -7.55,
"2015": 12.52,
"2014": -1.33,
"2013": 26.38,
"2012": 26.02,
"2011": -17.3,
"2010": 19.36,
"2009": 24.21,
"2008": -33.35,
"2007": 2.89,
"2006": 28.05,
"2005": 36.84,
"2004": 12.54,
"2003": 41.72,
"2002": -28.34,
"2001": -10.92,
"2000": 9.06,
"1999": 20.11,
"1998": 2.93,
"1997": 22.22,
"1996": 10.87,
"1995": 0.97,
"1994": -11.08,
"1993": 45.86,
"1992": -7.65,
"1991": -11.44,
"1990": -13.22,
"1989": 12.32,
"1988": 29.97,
"1987": -37.5,
"1986": 1.32,
"1985": 56.57,
"1984": 8.41,
"1983": 24.62,
"1982": 8.13,
"1981": 1.9,
"1980": 0.88,
"1979": -6.7,
"1978": 6.55,
"1977": 10.12,
"1976": -6.48,
"1975": 31.81,
"1974": 2.42,
"1973": -13.83,
"1972": 7.87,
"1971": 2.64,
"1970": -3.04
}
}
}
}
Example response (XML)
GET
/api/v1/performance-years-all/?format=xml<?xml version="1.0"?>
<root>
<funds>
<DE000A1H44G8>
<fund>
<name>3ik-Strategiefonds I Class I</name>
<isin>DE000A1H44G8</isin>
<wkn>A1H44G</wkn>
<fund_inception_date>2011-12-01</fund_inception_date>
<status_date>2023-03-16</status_date>
<url>https://fondswelt.hansainvest.com/de/fonds/details/151</url>
</fund>
<years>
<item key="2017">-0.69</item>
<item key="2016">0.34</item>
<item key="2015">0.09</item>
<item key="2014">2.87</item>
<item key="2013">1.14</item>
<item key="2012">5.67</item>
<item key="2011">-0.04</item>
</years>
</DE000A1H44G8>
<DE0009766212>
<fund>
<name>HANSAgeldmarkt</name>
<isin>DE0009766212</isin>
<wkn>976621</wkn>
<fund_inception_date>1994-11-02</fund_inception_date>
<url>https://fondswelt.hansainvest.com/de/fonds/details/1</url>
</fund>
<years>
<item key="2017">-0.41</item>
<item key="2016">0.23</item>
<item key="2015">-0.12</item>
<item key="2014">0.22</item>
<item key="2013">0.32</item>
<item key="2012">1.62</item>
<item key="2011">1.3</item>
<item key="2010">0.78</item>
<item key="2009">4.24</item>
<item key="2008">1.56</item>
<item key="2007">3.08</item>
<item key="2006">2.29</item>
<item key="2005">1.78</item>
<item key="2004">1.68</item>
<item key="2003">2.38</item>
<item key="2002">2.8</item>
<item key="2001">4.08</item>
<item key="2000">3.61</item>
<item key="1999">2.34</item>
<item key="1998">3.02</item>
<item key="1997">2.58</item>
<item key="1996">2.85</item>
<item key="1995">4.35</item>
<item key="1994">0.59</item>
</years>
</DE0009766212>
<DE0005321459>
<fund>
<name>HANSAinternational Class I</name>
<isin>DE0005321459</isin>
<wkn>532145</wkn>
<fund_inception_date>2006-12-14</fund_inception_date>
<url>https://fondswelt.hansainvest.com/de/fonds/details/41</url>
</fund>
<years>
<item key="2017">2.17</item>
<item key="2016">3.91</item>
<item key="2015">4.01</item>
<item key="2014">10.55</item>
<item key="2013">-4.75</item>
<item key="2012">8.09</item>
<item key="2011">3.24</item>
<item key="2010">12.57</item>
<item key="2009">11.43</item>
<item key="2008">1.48</item>
<item key="2007">-2.19</item>
<item key="2006">-0.66</item>
</years>
</DE0005321459>
<DE0008479023>
<fund>
<name>HANSAsecur</name>
<isin>DE0008479023</isin>
<wkn>847902</wkn>
<fund_inception_date>1970-01-02</fund_inception_date>
<url>https://fondswelt.hansainvest.com/de/fonds/details/6</url>
</fund>
<years>
<item key="2017">2.45</item>
<item key="2016">-7.55</item>
<item key="2015">12.52</item>
<item key="2014">-1.33</item>
<item key="2013">26.38</item>
<item key="2012">26.02</item>
<item key="2011">-17.3</item>
<item key="2010">19.36</item>
<item key="2009">24.21</item>
<item key="2008">-33.35</item>
<item key="2007">2.89</item>
<item key="2006">28.05</item>
<item key="2005">36.84</item>
<item key="2004">12.54</item>
<item key="2003">41.72</item>
<item key="2002">-28.34</item>
<item key="2001">-10.92</item>
<item key="2000">9.06</item>
<item key="1999">20.11</item>
<item key="1998">2.93</item>
<item key="1997">22.22</item>
<item key="1996">10.87</item>
<item key="1995">0.97</item>
<item key="1994">-11.08</item>
<item key="1993">45.86</item>
<item key="1992">-7.65</item>
<item key="1991">-11.44</item>
<item key="1990">-13.22</item>
<item key="1989">12.32</item>
<item key="1988">29.97</item>
<item key="1987">-37.5</item>
<item key="1986">1.32</item>
<item key="1985">56.57</item>
<item key="1984">8.41</item>
<item key="1983">24.62</item>
<item key="1982">8.13</item>
<item key="1981">1.9</item>
<item key="1980">0.88</item>
<item key="1979">-6.7</item>
<item key="1978">6.55</item>
<item key="1977">10.12</item>
<item key="1976">-6.48</item>
<item key="1975">31.81</item>
<item key="1974">2.42</item>
<item key="1973">-13.83</item>
<item key="1972">7.87</item>
<item key="1971">2.64</item>
<item key="1970">-3.04</item>
</years>
</DE0008479023>
</funds>
</root>
Errors
| Code | Problem | Description |
|---|---|---|
| 404 | There are no performance data (years) for the fund | The given fund has no performance data per calendar year available. |
| 403 | It is not permitted to get performance data for the fund with ISIN: [ISIN], because this fund is not yet one year old. | The requested performance data (years) for this fund shall not be displayed, because it is not yet one year old. |
Error response (example)
{
"title": "It is not permitted to get performance by years for the fund with ISIN",
"type": "https://api.hansainvest.com/docs/v1/endpoints/performance-years/#error-403-noapidataforfund",
"status": 403
}