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 all 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",
        "url": "https://www.hansainvest.com/deutsch/fondswelt/fondsdetails.html?fondsid=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>
    <url>https://www.hansainvest.com/deutsch/fondswelt/fondsdetails.html?fondsid=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",
                "url": "https://www.hansainvest.com/deutsch/fondswelt/fondsdetails.html?fondsid=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://www.hansainvest.com/deutsch/fondswelt/fondsdetails.html?fondsid=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://www.hansainvest.com/deutsch/fondswelt/fondsdetails.html?fondsid=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://www.hansainvest.com/deutsch/fondswelt/fondsdetails.html?fondsid=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>
        <url>https://www.hansainvest.com/deutsch/fondswelt/fondsdetails.html?fondsid=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://www.hansainvest.com/deutsch/fondswelt/fondsdetails.html?fondsid=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://www.hansainvest.com/deutsch/fondswelt/fondsdetails.html?fondsid=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://www.hansainvest.com/deutsch/fondswelt/fondsdetails.html?fondsid=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 for the fund The given fund has no performance data per calendar year available.

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
}