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. See details.
language Language of the response data (de or en) Not necessary to provide as URL part. When provided it will overwrite the Accept-Language-Header. See details.

Response data

Field Type Description
fund Object List of basic 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",
        "status_date": "2023-03-16",
        "url": "https://fondswelt.hansainvest.com/de/fonds/details/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>
    <status_date>2023-03-16</status_date>
    <url>https://fondswelt.hansainvest.com/de/fonds/details/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&#xE4;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&#xE4;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
}