Performance legal endpoint

General information

GET

/api/v1/performance-legal/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

Field Type Description
fund Object List of all fund data (see details)
performance Object List of all performance data
  periods Object{} Object/list of the necessary periods data
  bargross Object List of period's values (gross)
  barnet Object List of period's values (net)

Example response (JSON)

GET

/api/v1/performance-legal/DE0008479023/?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"
    },
    "performance": {
        "periods": {
            "2012": {
                "from": "2012-10-01",
                "realfrom": "2012-10-01",
                "to": "2013-09-30",
                "fromformatted": "01.10.12",
                "toformatted": "30.09.13"
            },
            "2013": {
                "from": "2013-10-01",
                "realfrom": "2013-10-01",
                "to": "2014-09-30",
                "fromformatted": "01.10.13",
                "toformatted": "30.09.14"
            },
            "2014": {
                "from": "2014-10-01",
                "realfrom": "2014-10-01",
                "to": "2015-09-30",
                "fromformatted": "01.10.14",
                "toformatted": "30.09.15"
            },
            "2015": {
                "from": "2015-10-01",
                "realfrom": "2015-10-01",
                "to": "2016-09-30",
                "fromformatted": "01.10.15",
                "toformatted": "30.09.16"
            },
            "2016": {
                "from": "2016-10-01",
                "realfrom": "2016-10-01",
                "to": "2017-09-30",
                "fromformatted": "01.10.16",
                "toformatted": "30.09.17"
            }
        },
        "line": [
            {
                "x": 1348963200000,
                "y": 0
            },
            {
                "x": 1349049600000,
                "y": -0.76548364999999
            },
            {
                "x": 1349136000000,
                "y": 0.69589421913405
            },
            {
                "x": 1349308800000,
                "y": 0.5915100860494
            },
            {
                "x": 1349395200000,
                "y": 0.6610995039691
            },
            {
                "x": 1349654400000,
                "y": 1.8093249729454
            },
            {
                "x": 1349740800000,
                "y": 0.59151007970675
            },


            /* 
             * stripped lots of lines 
             */


            {
                "x": 1505952000000,
                "y": 62.78115126462
            },
            {
                "x": 1506038400000,
                "y": 63.521944713315
            },
            {
                "x": 1506297600000,
                "y": 63.153372610934
            },
            {
                "x": 1506384000000,
                "y": 63.040246516453
            },
            {
                "x": 1506470400000,
                "y": 62.934418885882
            },
            {
                "x": 1506556800000,
                "y": 63.967150642683
            },
            {
                "x": 1506643200000,
                "y": 64.540079577477
            },
            {
                "x": 1506729600000,
                "y": 64.540079577477
            }
        ],
        "bargross": {
            "2012": 21.87957,
            "2013": 4.21791,
            "2014": 2.98277,
            "2015": 4.81641,
            "2016": 20.00645
        },
        "barnet": {
            "2012": 16.07578,
            "2013": 4.21791,
            "2014": 2.98277,
            "2015": 4.81641,
            "2016": 20.00645
        }
    }
}

Example response (XML)

GET

/api/v1/performance-legal/DE0008479023/?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>
  <performance>
    <periods>
      <item key="2012">
        <from>2012-10-01</from>
        <realfrom>2012-10-01</realfrom>
        <to>2013-09-30</to>
        <fromformatted>01.10.12</fromformatted>
        <toformatted>30.09.13</toformatted>
      </item>
      <item key="2013">
        <from>2013-10-01</from>
        <realfrom>2013-10-01</realfrom>
        <to>2014-09-30</to>
        <fromformatted>01.10.13</fromformatted>
        <toformatted>30.09.14</toformatted>
      </item>
      <item key="2014">
        <from>2014-10-01</from>
        <realfrom>2014-10-01</realfrom>
        <to>2015-09-30</to>
        <fromformatted>01.10.14</fromformatted>
        <toformatted>30.09.15</toformatted>
      </item>
      <item key="2015">
        <from>2015-10-01</from>
        <realfrom>2015-10-01</realfrom>
        <to>2016-09-30</to>
        <fromformatted>01.10.15</fromformatted>
        <toformatted>30.09.16</toformatted>
      </item>
      <item key="2016">
        <from>2016-10-01</from>
        <realfrom>2016-10-01</realfrom>
        <to>2017-09-30</to>
        <fromformatted>01.10.16</fromformatted>
        <toformatted>30.09.17</toformatted>
      </item>
    </periods>
    <line>
      <item key="0">
        <x>1348963200000</x>
        <y>0</y>
      </item>
      <item key="1">
        <x>1349049600000</x>
        <y>-0.76548364999999</y>
      </item>
      <item key="2">
        <x>1349136000000</x>
        <y>0.69589421913405</y>
      </item>
      <item key="3">
        <x>1349308800000</x>
        <y>0.5915100860494</y>
      </item>
      <item key="4">
        <x>1349395200000</x>
        <y>0.6610995039691</y>
      </item>
      <item key="5">
        <x>1349654400000</x>
        <y>1.8093249729454</y>
      </item>
      <item key="6">
        <x>1349740800000</x>
        <y>0.59151007970675</y>
      </item>
      <item key="7">
        <x>1349827200000</x>
        <y>-0.10438413968298</y>
      </item>
      <item key="8">
        <x>1349913600000</x>
        <y>-0.2087682753447</y>
      </item>
      <item key="9">
        <x>1350000000000</x>
        <y>0.80027834837276</y>
      </item>
      <item key="10">
        <x>1350259200000</x>
        <y>0.24356296722726</y>
      </item>
      <item key="11">
        <x>1350345600000</x>
        <y>0.66109950066705</y>
      </item>
      <item key="12">
        <x>1350432000000</x>
        <y>2.1572720789651</y>
      </item>
      <item key="13">
        <x>1350518400000</x>
        <y>2.5400139015925</y>
      </item>
      <item key="14">
        <x>1350604800000</x>
        <y>3.2359081249405</y>
      </item>
      <item key="15">
        <x>1350864000000</x>
        <y>2.5052191919086</y>
      </item>
      <item key="16">
        <x>1350950400000</x>
        <y>1.878914383502</y>
      </item>
      <item key="17">
        <x>1351036800000</x>
        <y>-0.20876829046227</y>
      </item>
      <item key="18">
        <x>1351123200000</x>
        <y>0.13917882661745</y>
      </item>
      <item key="19">
        <x>1351209600000</x>
        <y>0.34794709400471</y>
      </item>

      
      <!-- stripped lots of lines -->


      <item key="1277">
        <x>1506643200000</x>
        <y>64.540079577477</y>
      </item>
      <item key="1278">
        <x>1506729600000</x>
        <y>64.540079577477</y>
      </item>
    </line>
    <bargross>
      <item key="2012">21.87957</item>
      <item key="2013">4.21791</item>
      <item key="2014">2.98277</item>
      <item key="2015">4.81641</item>
      <item key="2016">20.00645</item>
    </bargross>
    <barnet>
      <item key="2012">16.07578</item>
      <item key="2013">4.21791</item>
      <item key="2014">2.98277</item>
      <item key="2015">4.81641</item>
      <item key="2016">20.00645</item>
    </barnet>
  </performance>
</root>

Errors

Code Problem Description
404 No performance data (legal) found for this fund: [ISIN] The requested performance data (legal) for this fund does not exist or shall not be displayed.

Error response (example)

{
    "title": "No performance data (legal) found for this fund: ISIN",
    "type": "https://api.hansainvest.com/docs/v1/endpoints/performance-legal/#error-404-nodata",
    "status": 404
}