Key figures endpoint
General information
GET
/api/v1/figures/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) |
figures | Object | List of all key figures data |
name | String | German name of key figure |
value | String | Value of the key figures |
value2 | String | Value 2 of the key figures (optional) |
Example response (JSON)
GET
/api/v1/figures/DE000A1H44G8/?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"
},
"figures": [
{
"name": "Investitionsgrad",
"value": "97.087436",
"value2": null
},
{
"name": "VaR",
"value": "5,31%",
"value2": null
},
{
"name": "offene Fremdw\u00e4hrungsquote",
"value": "0,14 %",
"value2": null
},
{
"name": "Sharpe Ratio",
"value": "0,08",
"value2": null
},
{
"name": "Max Drawdown",
"value": "-0,12",
"value2": null
},
{
"name": "Drawdown",
"value": "-0,02",
"value2": null
},
{
"name": "Anzahl positiver Monate",
"value": "19",
"value2": null
},
{
"name": "Anzahl negativer Monate",
"value": "17",
"value2": null
},
{
"name": "Bester Monat",
"value": "11,05 %",
"value2": null
},
{
"name": "Schlechtester Monat",
"value": "-10,09 %",
"value2": null
},
{
"name": "Anteil positiver Monate",
"value": "52,78 %",
"value2": null
},
{
"name": "Volatilit\u00e4t",
"value": "13,63 %",
"value2": null
}
]
}
Example response (XML)
GET
/api/v1/figures/DE000A1H44G8/?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>
<figures>
<item key="0">
<name>Investitionsgrad</name>
<value>97.087436</value>
<value2/>
</item>
<item key="1">
<name>VaR</name>
<value>5,31%</value>
<value2/>
</item>
<item key="2">
<name>offene Fremdwährungsquote</name>
<value>0,14 %</value>
<value2/>
</item>
<item key="3">
<name>Sharpe Ratio</name>
<value>0,08</value>
<value2/>
</item>
<item key="4">
<name>Max Drawdown</name>
<value>-0,12</value>
<value2/>
</item>
<item key="5">
<name>Drawdown</name>
<value>-0,02</value>
<value2/>
</item>
<item key="6">
<name>Anzahl positiver Monate</name>
<value>19</value>
<value2/>
</item>
<item key="7">
<name>Anzahl negativer Monate</name>
<value>17</value>
<value2/>
</item>
<item key="8">
<name>Bester Monat</name>
<value>11,05 %</value>
<value2/>
</item>
<item key="9">
<name>Schlechtester Monat</name>
<value>-10,09 %</value>
<value2/>
</item>
<item key="10">
<name>Anteil positiver Monate</name>
<value>52,78 %</value>
<value2/>
</item>
<item key="11">
<name>Volatilität</name>
<value>13,63 %</value>
<value2/>
</item>
</figures>
</root>
Errors
Code | Problem | Description |
---|---|---|
400 | No ISIN provided | For the used endpoint it is necessary to provide the ISIN to identify the fund. |
404 | There is no fund with this ISIN: [ISIN] | No fund can be found for the provided ISIN. |
403 | It is not permitted to get data for the fund with ISIN: [ISIN] | For some reasons for the fund there is no data provided by the Fund-API. |
Error response (example)
{
"title": "There is no investment structure type: TEST",
"type": "https://api.hansainvest.com/docs/v1/endpoints/investment_structure/#error-416-wrongtype",
"status": 416
}