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
}