Erste Schritte
Die FHUB Web API bietet Basisinformationsblätter und Termsheet für strukturierte Produkte, Warrants, EUREX Produkte und Fonds einfach und zentral für Ihr Finanzsystem an.
Für die Nutzung benötigen Sie einen entsprechenden API Key. Gerne unterstützen wir Sie bei Fragen oder dem erstmaligen Setup. Senden Sie ein Mail an info at factsheet-hub.ch.
PRODUKTUMFANG
| Nr. | Produkt | Emittenten | Anzahl |
|---|---|---|---|
| 1. | Strukturierte Produkte (Anlageprodukte) | Julius Bär, BCV, CS, Leonteq, LUKB, Raiffeisen, EFG, RBS BNP, UBS, Vontobel, ZKB, Corner Bank | ca. 300'000 |
| 2 | Warrants (Hebelprodukte) | Julius Bär, BCV, CS, Leonteq, LUKB, Raiffeisen, EFG, RBS BNP, UBS, Vontobel, ZKB, Corner Bank | ca. 25'000 |
| 3 | TOFF | EUREX | ca. 7'000 |
| 4 | Fonds | Diverse Emittenten | ca. 30'000 |
Der aktuelle Produktumfang können Sie auch per CSV mit ihrem System abgleichen, treten Sie dazu mit uns in Kontakt.
Strukturierte Produkte & Warrants
Um Dokumente für strukturierte Produkte oder Warrants abzurufen, nutzen sie folgende URL mit
entsprechenden Parametern:https://api.factsheet-hub.ch/v2/req_derivat.php?
QUERY PARAMETER
| Feld | Typ | Beschreibung |
|---|---|---|
| auth | String | Ihr API Key, Beispiel auth=asdf2l3k4jd09u3k |
| k | String (ISIN) | Produktidentifikation ISIN, Beispiel k=CH1208659461 |
| t | String ["bib","ts","all"], Default=bib | (optional) Dokument Typ entweder bib=Basisinformationsblatt oder ts=Termsheet, Beispiel t=bib. Bei der Angabe von "all" werden alle verfügbaren Dokumente in einer HTML Seite zur Auswahl verfügbar gemacht. |
| l | String ["de","en"], Default=de | (optional) Dokumentsprache entweder de=Deutsch oder en=Englisch, Beispiel l=de |
Die Query Parameter sind mittels einem "&" voneinander zu separieren.
QUERY BEISPIELE
| Nr. | Query | Beschreibung |
|---|---|---|
| 1 | https://api.factsheet-hub.ch/v2/req_derivat.php?auth=e67d82db13ecee932486&k=CH1208659461 | Minimales Query ohne Angabe des Typen oder der Sprache. |
| 2 | https://api.factsheet-hub.ch/v2/req_derivat.php?auth=e67d82db13ecee932486&k=CH1208659461&t=ts | Query mit Angabe des Typen, hier wird ausdrücklich ein Termsheet gewünscht. |
| 3 | https://api.factsheet-hub.ch/v2/req_derivat.php?auth=e67d82db13ecee932486&k=CH1208659461&l=en | Query mit Angabe der Sprache ohne Typen, in diesem Fall wird ein Basisinformationsblatt (default) in der Sprache englisch gesucht. |
RETURN
- Im positiven Fall wird das gewünschte PDF-File zurückgegeben.
- Im negativen Fall eine HTML-Seite mit dem Hinweis "Leider kein Verkaufsdokument verfügbar".
-Bei der Angabe "all" wird eine HTML Seite mit allen verfügbaren Dokumenten des Produkts angezeigt.
Die Dokumente können einzeln angewählt werden.
HINWEISE
- Ist die gewünschte Sprache eines Dokuments nicht verfügbar, wird bei Verfügbarkeit die Alternativsprache zurückgegeben.
Fonds
Um Dokumente für Fonds abzurufen, nutzen sie folgende URL mit entsprechenden Parametern:https://api.factsheet-hub.ch/v2/req_fonds.php?
QUERY PARAMETER
| Feld | Typ | Beschreibung |
|---|---|---|
| auth | String | Ihr API Key, Beispiel auth=asdf2l3k4jd09u3k |
| k | String (ISIN) | Produktidentifikation ISIN, Beispiel k=CH0382492327 |
| t | String ["kid","fpd","all"], Default=kid | (optional) Dokument Typ entweder kid=Key Information Document oder fpd=Fondsprospekt, Beispiel t=kid. Bei der Angabe von "all" werden alle verfügbaren Dokumente in einer HTML Seite zur Auswahl verfügbar gemacht. |
| l | String ["de","en"], Default=de | (optional) Dokumentsprache entweder de=Deutsch oder en=Englisch, Beispiel l=de |
Die Query Parameter sind mittels einem "&" voneinander zu separieren.
QUERY BEISPIELE
| Nr. | Query | Beschreibung |
|---|---|---|
| 1 | https://api.factsheet-hub.ch/v2/req_fonds.php?auth=e67d82db13ecee932486&k=LU2775729077 | Minimales Query ohne Angabe des Typen oder der Sprache. Alle verfügbaren Dokumente werden angezeigt |
| 2 | https://api.factsheet-hub.ch/v2/req_fonds.php?auth=e67d82db13ecee932486&k=LU2775729077&t=fpd | Query mit Angabe des Typen, hier wird ausdrücklich der Fondsprospekt gewünscht. |
| 3 | https://api.factsheet-hub.ch/v2/req_fonds.php?auth=e67d82db13ecee932486&k=IE000UDFKE13&t=kid | Query mit Angabe des Typen, hier wird ausdrücklich das KID gewünscht. |
RETURN
- Im positiven Fall wird das gewünschte PDF-File zurückgegeben.
- Im negativen Fall eine HTML-Seite mit dem Hinweis "Leider kein Verkaufsdokument verfügbar".
- Bei der Angabe "all" wird eine HTML Seite mit allen verfügbaren Dokumenten des Produkts angezeigt.
Die Dokumente können einzeln angewählt werden.
HINWEISE
- Ist die gewünschte Sprache eines Dokuments nicht verfügbar, wird bei Verfügbarkeit die
Alternativsprache zurückgegeben.
- Für Fonds gibt es keine "on-the-fly" Suche.
TOFF
Dokumente für Produkte im Traded Options and Financial Futures Bereich rufen Sie analog der
strukturierten Produkten ab.
Für diese Produkte speziell ist die Angabe des Key bzw. der ISIN. Bei EUREX Produkten muss der Key
fallspezifisch zusammengesetzt werden
KEY DEFINITION
| Produkt | Key | Beschreibung |
|---|---|---|
| Option | Ticker,Long/Short,Put/Call | Der Key setzt sich aus dem Produkt Ticker der Angabe Long oder Short und der Angabe ob Call oder Put zusammen, Beispiel k=ABB5LONGCALL |
| Future | Ticker,Long/Short | Der Key setzt sich aus dem Produkt Ticker der Angabe Long oder Short zusammen, Beispiel k=ACELONGCALL |
QUERY BEISPIELE
| Nr. | Query | Beschreibung |
|---|---|---|
| 1 | https://api.factsheet-hub.ch/v2/req_derivat.php?auth=e67d82db13ecee932486&k=ABB5LONGCALL | Minimales Query für eine Long Call Option. |
| 2 | https://api.factsheet-hub.ch/v2/req_derivat.php?auth=e67d82db13ecee932486&k=ADSESHORTPUT | Minimales Query für eine Short Put Option. |
RETURN
- Im positiven Fall wird das gewünschte PDF-File zurückgegeben.
- Im negativen Fall eine HTML-Seite mit dem Hinweis "Leider kein Verkaufsdokument verfügbar".
HINWEISE
- Für die EUREX stehen jeweils generische Basisinformationsblätter zur Verfügung.
- Ist die gewünschte Sprache eines Dokuments nicht verfügbar, wird bei Verfügbarkeit die
Alternativsprache zurückgegeben.
- Für Fonds gibt es keine "on-the-fly" Suche.
UPLOAD
Mit der Upload-Funktion laden Sie einfach und schnell eigene Dokumente hoch und machen diese in Ihrem System verfügbar.
Die Funktion erreichen Sie über den Linkupload.factsheet-hub.ch
ANGABEN UPLOAD
| Feld | Beschreibung |
|---|---|
| ISIN | Angabe der ISIN zum Produkt zum Beispiel CH12345678 |
| Valor | Angabe der Valoren-Nr. zum Produkt zum Beispiel 2345678 |
| Emittent | Angabe des Emittenten. Damit wird sichergestellt, dass das Produkt später auch aktualisiert wird. |
| Basisinformationsblatt deutsch | (optional) Ein Basisinformationsblatt in deutsch als Format .pdf |
| Basisinformationsblatt englisch | (optional) Ein Basisinformationsblatt in englisch als Format .pdf |
| Termsheet deutsch | (optional) Ein Termsheet in deutsch als Format .pdf |
| Termsheet englisch | (optional) Ein Termsheet in englisch als Format .pdf |
| Selektion Typ | Auswahl um welchen Produkttyp es sich handelt |
WEITERE FUNKTIONEN
Neben den gängigen API Funktionen haben wir weitere Funktionen rund um die Abfrage von Dokumenten.
HTML SUCHSEITE
Über die Suchseite können Sie oder Ihre Kunden mittels Angabe der ISIN sämtliche Dokumente zu einem Produkt auswählen und betrachten.
Die Suche erreichen Sie über den Linksearch.factsheet-hub.ch
VERFÜGBARKEITSPRÜFUNG
Für Systeme kann es hilfreich sein zu prüfen, ob ein Dokument für eine ISIN verfügbar ist, ohne dieses zu laden. Mit der Verfügbarkeitsprüfung wird ausschliesslich ein HTTP Header zurückgegeben.
Die Prüfung steht für strukturierte Produkte, Warrants und TOFF Produkte zur Verfügung.
Die Abfrage stellen Sie analog der normalen Abfrage für ein Struki, Warrant TOFF Produkt zusammen.
Anstelle des URL Parameter req_derivat erfassen Sie check_derivat
https://api.factsheet-hub.ch/v2/check_derivat.php?auth=e67d82db13ecee932486&k=CH1208659461
Im positiven Fall erhalten Sie einen HTTP Code 200. Im negativen Fall ein HTTP 404.
CSV EXPORT DES UMFANGS
Über nachstehend Link finden Sie eine Liste aller verfügbaren Produkte. Der File-Export enthält nur Produkte-ISIN für Strukturierte Produkte und Warrants. Fonds und TOFF Produkte sind nicht aufgeführt, ausserdem werden Produkte, welche über den On-the-fly Modus abgerufen werden, hier erst am Folgetag ersichtlich.
Die Suche erreichen Sie über den Linkhttp://factsheet-hub.ch/api/exchange/product_list.csv
| Bereich | Beschreibung |
|---|---|
| Aktualisierung | 03.50 Uhr, täglich |
| Size | ca. 5MB |
| Codierung | UTF-8 |
| Formattierung | 1 Zeile = Kopfzeile (ISIN, VALOR, TIMESTAMP), Zweite Zeile = Start Content |
RELEASE NOTES
05.04.2024- Version 2.0.3 Ausbau des "On the fly Request"
- Beim "On the fly Request" sind jetzt auch für Termsheets abgedeckt"
- Es wurde zusätzliche Emittenten für den Modus aufgeschaltet (Vontobel, UBS, Leonteq, ZKB, Julius Bär, LUKB und BCV)"
23.02.2023- Version 2.0.2 neue Funktion Verfügbarkeitsprüfung hinzugefügt
Siehe Beschreibung unter "Weitere Funktionen: Verfügbarkeitsprüfung"
03.01.2023- Version 2.0.1 Ergänzung Docs
Ergänzung zu Return-Werten im negativen Fall. Kleinere Korrekturen in diesem Zusammenhang.
01.09.2022- Version 2.0.0 für Start Testphase
| Nr. | Change | Beschreibung |
|---|---|---|
| Release Plan | Die neue Version 2 der FHUB API ist ab dem 1. September 2022 verfügbar. Wir planen eine
3 Monate Testphase sodass wir etwaige Kundenwünsche bis zum Produktionsstart
berücksichtigen Können. Die Umstellung auf die neue Version werden wir dann per 1.4.2023
auf unserer Seite vornehmen, dann werden sämtliche Anfrage automatisch auf die neue
Version umgeleitet. |
|
| 1 | On the fly | On the fly Abfrage für die Emittenten Vontobel, UBS und Leonteq. |
| 2 | Upload | Neuer Upload inklusive Fonds und Sicherstellung der späteren Aktualisierung durch FHUB durch Angabe des Emittenten. |
| 3 | System Raw API | Möglichkeit des Zugriffzugriffs auf unsere interne Raw API, welche ausschliesslich Filelinks im JSON-Format liefert. |
| 4 | Umfang | ACHTUNG: Während der Testphase von Sept. bis Dezember ist der Umfang an Produkten eingeschränkt. Die verfügbaren Produkte sind jeweils in den Beispiel-Links ersichtlich. |