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 basic 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",
"status_date": "2023-03-16",
"url": "https://fondswelt.hansainvest.com/de/fonds/details/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>
<status_date>2023-03-16</status_date>
<url>https://fondswelt.hansainvest.com/de/fonds/details/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. |
| 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 (legal) for this fund shall not be displayed, because it is not yet one year old. |
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
}