← Zurück

August 7, 2024

Tutorial: Integration einer Börsen API

Autor:
Bavest
Engineering
Einführung

In der modernen Finanzwelt ist eine Börsen API der Pfeiler vieler Finanzprodukte und Unternehmen, von Trading Apps, Finanztools bis hin zur quantitativen Analyse bei Banken und Asset Managers.In diesem Tutorial führen wir Sie Schritt für Schritt durch den Prozess der Integration unserer Börsen-API bei Bavest, damit Sie Finanzdaten wie Aktienkurse, ETF-Daten und mehr in Ihre Anwendungen einbinden können.
Woher Sie einen API-Schlüssel erhalten und was Sie genau tun müssen, erfahren Sie in diesem Blog Artikel.

Was Sie vor der API-Integration beachten sollten
Statuspage und API-Dokumentation

Bevor Sie mit der Integration unserer API beginnen, sollten Sie unsere Statuspage und die API-Dokumentation sorgfältig durchlesen. Die Statuspage gibt Ihnen einen Überblick über die aktuelle Verfügbarkeit und eventuelle Wartungsarbeiten unserer Dienste. Die API-Dokumentation ist Ihr Leitfaden für die Nutzung unserer API und enthält detaillierte Informationen zu den verfügbaren Endpunkten, den Datenformaten und den Authentifizierungsmethoden.

  • Statuspage: Überprüfen Sie regelmäßig unsere Statuspage, um sicherzustellen, dass alle Dienste ordnungsgemäß funktionieren.
  • API-Dokumentation: Lesen Sie die API-Dokumentation gründlich durch, um ein umfassendes Verständnis der API-Funktionen zu erlangen. Nutzen Sie unser API Dokumentation um basierend auf Ihren Tech-Stack die Requests in der passenden Programmiersprache auszuwählen. Kopieren Sie den Code und testen die Sie Requests auch direkt in der API-Dokumentation mit Ihrem API-Key.

Bevor Sie mit der Integration beginnen, sollten Sie einige wichtige technische und organisatorische Aspekte berücksichtigen:

Tech Stack

Stellen Sie sicher, dass Ihr Tech Stack kompatibel mit unserer API ist. Unsere API unterstützt verschiedene Programmiersprachen und Frameworks, darunter Python, JavaScript (Node.js) und PHP. Wählen Sie die Sprache, die am besten zu Ihrem Projekt passt.

Cloud Anbieter

Wenn Sie Ihre Anwendung in der Cloud hosten möchten, sollten Sie einen geeigneten Cloud-Anbieter auswählen. Unsere API kann mit verschiedenen Cloud-Diensten wie AWS, Google Cloud und Azure integriert werden. Stellen Sie sicher, dass Ihr Cloud-Anbieter die benötigten Ressourcen und Dienste bereitstellt.

  • AWS: Bietet umfassende Dienstleistungen und Tools für die API-Integration.
  • Google Cloud: Bekannt für seine leistungsfähigen Datenanalyse-Tools.
  • Azure: Bietet nahtlose Integration mit Microsoft-Produkten.

Bavest API Integration: Schritt-für-Schritt Anleitung

Schritt 1: Registrierung und API-Schlüssel erhalten

Bevor Sie unsere API nutzen können, müssen Sie einen Test-API Key bei support@bavest.co anfordern. Sie erhalten einen API-Schlüssel, den Sie für den Zugriff auf unsere Daten nutzen können.

Schritt 2: API-Dokumentation durchlesen

Unsere API-Dokumentation enthält alle notwendigen Informationen zur Nutzung unserer Schnittstelle. Besuchen Sie die Dokumentationsseite, um sich mit den verfügbaren Endpunkten, den Datenformaten und den Authentifizierungsmethoden vertraut zu machen.

Schritt 3: Erste Anfrage stellen

Mit Ihrem API-Schlüssel können Sie nun Ihre erste Anfrage an unsere API stellen. Im Folgenden zeigen wir Ihnen ein Beispiel, wie Sie Aktienkurse abrufen können.

Beispiel: Abrufen von Aktienkursen

Um die aktuellen Aktienkurse eines Unternehmens abzurufen, verwenden Sie den folgenden Endpunkt:

In diesem Beispiel wird der Aktienkurs von Apple (Symbol: AAPL) abgerufen. Ersetzen Sie API-KEY durch Ihren persönlichen API-Schlüssel.

Beispielcode in Python

Hier ist ein Beispielcode in Python, der zeigt, wie Sie unsere API nutzen können:

1import requests
2
3url = "https://api.bavest.co/v0/quote"
4
5headers = {
6    "accept": "application/json",
7    "content-type": "application/json",
8    "x-api-key": "API-Key"
9}
10
11response = requests.post(url, headers=headers)
12
13print(response.text)

Nun möchten wir sicherstellen, das die Bavest API keinen Error zurückgibt und tatsächlich den letzten Kurs von Apple liefert, dann sieht der Code wie folgt aus:

1import requests
2
3url = "https://api.bavest.co/v0/quote"
4
5payload = {
6    "symbol": "AAPL",
7    "currency": "EUR"
8}
9headers = {
10    "accept": "application/json",
11    "content-type": "application/json",
12    "x-api-key": "API-Key"
13}
14
15response = requests.post(url, json=payload, headers=headers)
16
17if response.status_code == 200:
18    json_data = response.json()
19    
20    # Extracting the historical price data for "day"
21    if 'historical_price' in json_data and 'day' in json_data['historical_price']:
22        historical_day_prices = json_data['historical_price']['day']
23        
24        # Print the latest update (assuming the latest is the last in the list)
25        if historical_day_prices:
26            latest_price_update = historical_day_prices[-1]
27            print("Latest price update:", latest_price_update)
28        else:
29            print("No historical day prices available.")
30    else:
31        print("Historical price data for 'day' not found in the response.")
32else:
33    print('Error:', response.status_code, response.text)

Dieser Code führt die folgenden Aktionen aus:

- Er sendet eine POST-Anfrage an die API unter Verwendung der angegebenen URL, Nutzdaten und Kopfzeilen.
- Überprüft, ob der Antwortstatus 200 ist (was auf Erfolg hinweist).
- Analysiert die JSON-Antwort und extrahiert den „historical_price“ für „day“.
- Zeigt die letzte Preisaktualisierung aus den „historical_price“ „day“-Daten.

Schritt 4: Integration in Ihre Anwendung

Je nachdem, welche Programmiersprache oder Plattform Sie verwenden, können Sie unsere API in Ihre Anwendung integrieren. Hier sind einige Beispiele für verschiedene Sprachen:

JavaScript (Node.js)

Verwenden wir die node-fetch-requests:

npm install node-fetch@2 --save

1const fetch = require('node-fetch');
2
3const url = 'https://api.bavest.co/v0/quote';
4const options = {
5  method: 'POST',
6  headers: {
7    accept: 'application/json',
8    'content-type': 'application/json',
9    'x-api-key': 'API-Key'
10  },
11  body: JSON.stringify({symbol: 'AAPL', currency: 'EUR'})
12};
13
14fetch(url, options)
15  .then(res => res.json())
16  .then(json => console.log(json))
17  .catch(err => console.error('error:' + err));

PHP

For php nutzen wir guzzle-requests:

composer require guzzlehttp/guzzle

1<?php
2require_once('vendor/autoload.php');
3
4$client = new \GuzzleHttp\Client();
5
6$response = $client->request('POST', 'https://api.bavest.co/v0/quote', [
7  'body' => '{"symbol":"AAPL","currency":"EUR"}',
8  'headers' => [
9    'accept' => 'application/json',
10    'content-type' => 'application/json',
11    'x-api-key' => 'API-Key',
12  ],
13]);
14
15echo $response->getBody();

Real-time Kurse integrieren
Anleitung für Websockets mit wscat

Um Echtzeitdaten über Websockets zu integrieren, können Sie wscat verwenden. wscat ist ein WebSocket-Client, der es Ihnen ermöglicht, Echtzeitdaten von unserer API zu empfangen.

Installation von wscat

npm install -g wscat

Verbindung herstellen

wscat -c "wss://ws.bavest.co/v0" -H "x-api-key: <API KEY>"

Echtzeitdaten von verschiedenen Börsen abrufen

Unsere API unterstützt verschiedene Börsen. Um Echtzeitdaten für ein bestimmtes Symbol von einer bestimmten Börse zu erhalten, hängen Sie das Börsenkürzel als Suffix an das Symbol an. Zum Beispiel:

  • AAPL.BE: Abrufen der Echtzeitdaten für Apple von der Börse Berlin.
  • AAPL.NY: Abrufen der Echtzeitdaten für Apple von der New Yorker Börse.

Finanzdaten Integration
Fundamentals

Um fundamentale Finanzdaten abzurufen, verwenden Sie den folgenden Endpunkt: Bavest API Docs: Fundamentals →

Beispielcode in Python

Request im Allgemeinen:

1const url = 'https://api.bavest.co/v0/stock/fundamentals';
2const options = {
3  method: 'POST',
4  headers: {
5    accept: 'application/json',
6    'content-type': 'application/json',
7    'x-api-key': 'API-Key'
8  },
9  body: JSON.stringify({symbol: 'AAPL'})
10};
11
12fetch(url, options)
13  .then(res => res.json())
14  .then(json => console.log(json))
15  .catch(err => console.error('error:' + err));

Erweiterter Code um die Antwort der API zu speichern:

1import requests
2import json
3
4url = 'https://api.bavest.co/v0/stock/fundamentals'
5headers = {
6    'accept': 'application/json',
7    'content-type': 'application/json',
8    'x-api-key': 'API-Key'
9}
10data = {
11    'symbol': 'AAPL'
12}
13
14response = requests.post(url, headers=headers, data=json.dumps(data))
15
16if response.status_code == 200:
17    json_data = response.json()
18    print(json_data)
19else:
20    print('Fehler:', response.status_code, response.text)

Financials

Um Finanzdaten abzurufen, verwenden Sie den folgenden Endpunkt: Bavest API Docs: Financials →

Der Endpunkt gibt die Finanzdaten aus Income Sheet, Balance Sheet und Cashflow Statement zurück, z. B. die Bilanz, die Gewinn- und Verlustrechnung oder die Kapitalflussrechnung.

Beispielcode in Python

1const fetch = require('node-fetch');
2
3const url = 'https://api.bavest.co/v0/stock/financials';
4const options = {
5  method: 'POST',
6  headers: {
7    accept: 'application/json',
8    'content-type': 'application/json',
9    'x-api-key': 'API-Key'
10  },
11  body: JSON.stringify({
12    symbol: 'AAPL.DE',
13    freq: 'quarterly',
14    statement: 'cf',
15    currency: 'EUR',
16    limit: 1
17  })
18};
19
20fetch(url, options)
21  .then(res => res.json())
22  .then(json => console.log(json))
23  .catch(err => console.error('error:' + err));

Worauf sollte man bei der Auswahl einer Börsen API achten?

Bei der Wahl einer Börsen-API gibt es mehrere wichtige Kriterien zu beachten, um sicherzustellen, dass sie den Anforderungen Ihres Projekts entspricht. Hier sind die wichtigsten Aspekte:

1. Datenabdeckung

  • Märkte und Börsen: Stellen Sie sicher, dass die API Daten von den Märkten und Börsen abdeckt, die für Ihr Projekt relevant sind.
  • Finanzinstrumente: Überprüfen Sie, ob die API alle notwendigen Finanzinstrumente wie Aktien, ETFs, Fonds, Anleihen, Kryptowährungen usw. unterstützt.

2. Datenqualität und Aktualität

  • Echtzeitdaten: Prüfen Sie, ob die API Echtzeitdaten bereitstellt und wie oft diese aktualisiert werden.
  • Historische Daten: Verfügbarkeit und Umfang historischer Daten können für Analysen und Backtesting entscheidend sein.

3. Zuverlässigkeit und Verfügbarkeit

  • Uptime: Eine hohe Verfügbarkeit und Zuverlässigkeit sind essentiell, besonders für Handelsanwendungen.
  • Statuspage: Eine öffentlich zugängliche Statusseite zur Überwachung der Dienste ist vorteilhaft.

4. Dokumentation und Support

  • API-Dokumentation: Die Dokumentation sollte klar und umfassend sein, mit Beispielen und detaillierten Beschreibungen der Endpunkte.
  • Support: Verfügbarkeit von technischem Support oder einer Entwickler-Community zur Behebung von Problemen und zur Unterstützung bei der Integration.

5. Kosten und Abonnementpläne

  • Preismodell: Verstehen Sie das Preismodell und stellen Sie sicher, dass es zu Ihrem Budget passt.
  • Kostenlose Testphase: Viele APIs bieten eine kostenlose Testphase oder ein Freemium-Modell, um die Dienste vorab zu testen.

6. Technische Aspekte und Integration

  • Kompatibilität: Überprüfen Sie, ob die API mit Ihrem Tech-Stack und Ihren Entwicklungswerkzeugen kompatibel ist.
  • Anfragegeschwindigkeit und Limits: Prüfen Sie die Rate Limits (Anzahl der Anfragen pro Minute/Stunde) und die Latenz der API.

7. Sicherheit und Authentifizierung

  • Auth-Methoden: Stellen Sie sicher, dass die API sichere Authentifizierungsmethoden wie API-Schlüssel, OAuth oder andere unterstützt.
  • Datenverschlüsselung: Überprüfen Sie, ob die Datenübertragung verschlüsselt ist (z.B. mittels HTTPS).

8. Zusätzliche Funktionen

  • Websockets: Für Echtzeitanwendungen kann die Unterstützung von Websockets nützlich sein.
  • Analytik- und Statistiktools: Einige APIs bieten zusätzliche analytische Tools und Funktionen.

9. Nutzerbewertungen und Reputation

  • Bewertungen: Schauen Sie sich Bewertungen und Erfahrungsberichte anderer Nutzer an, um die Zuverlässigkeit und Qualität der API besser einschätzen zu können.
  • Reputation des Anbieters: Ein etablierter Anbieter mit gutem Ruf ist oft vertrauenswürdiger.

10. Flexibilität und Anpassbarkeit

  • Custom Endpoints: Manchmal ist es nützlich, wenn die API anpassbare Endpunkte oder flexible Datenabfragen unterstützt.

Indem Sie diese Kriterien sorgfältig prüfen, können Sie die Börsen-API auswählen, die am besten zu Ihren Bedürfnissen und Anforderungen passt.

Vorteile der Bavest API

Unsere Börsen-API bei Bavest bietet zahlreiche Vorteile:

  1. Echtzeitdaten: Erhalten Sie aktuelle Kurse und Marktinformationen in Echtzeit.
  2. Welweite Datenabdeckung & Assets: Zugriff auf Daten zu Aktien, ETFs, Fonds und mehr.
  3. Data-on-Demand: Bei fehlenden Datenpunkten oder Wertpapieren sammelt Bavest die Daten innerhalb von 2 Wochen und macht diese per API verfügbar.
  4. Alternative Daten: Zugriff auf ESG- & Klimadaten, Sentiment-Daten und KPIs zu börsennotierten Unternehmen wie Umsatz nach Region und Produkten.
  5. Hohe Verfügbarkeit und Zuverlässigkeit: Unsere Infrastruktur gewährleistet eine kontinuierliche Verfügbarkeit der Daten.
  6. Einfache Integration: Unsere API ist benutzerfreundlich und leicht in bestehende Anwendungen zu integrieren.
  7. Vielfältige Endpunkte: Von Echtzeitkursen bis hin zu historischen Daten und Finanzberichten – unsere API deckt alle Ihre Bedürfnisse ab.
  8. Kundensupport: Unser engagiertes Support-Team steht Ihnen bei Fragen und Problemen jederzeit zur Verfügung, wir antworten innerhalb von 24h.

Bavest zeichnet sich durch sein benutzerzentriertes Modell aus, das Einfachheit und Transparenz betont. Kunden profitieren von:

  • Single-API-Solution: Konsolidiert den Datenzugriff in einer API und reduziert den Wartungsaufwand im Backend, den man mit mehreren APIs besitzen würde.
  • Data on Demand: Sie benötigen Daten, aber diese fehlen in der Bavest API? Kein Problem, innerhalb von 2 Wochen sammelt Bavest diese Daten und stellt Sie Ihnen zur Verfügung.
  • Transparente Preisgestaltung: Einfache Preisstruktur ohne komplexe Lizenzierung, sodass Benutzer nur für das zahlen, was sie benötigen.

Use-Cases

Bavest richtet sich an eine breite Palette von Unternehmensarten, darunter Vermögensverwalter, Fintech-Unternehmen, Banken, Family Offices, Beratungsunternehmen, Unternehmen und Medienorganisationen. Die Infrastruktur unterstützt verschiedene Anwendungen, von der Automatisierung von Forschungsprozessen bis hin zur Entwicklung innovativer Finanzprodukte

Fazit

Mit unserer Infrastruktur bei Bavest können Sie schnell und einfach Finanzdaten in Ihre Anwendungen integrieren. Egal ob Sie aktuelle Aktienkurse, historische Daten oder ETF-Informationen, alternative Daten oder quantitative Portfolioanalyse benötigen, unsere API bietet Ihnen die notwendige Basis für Ihr Produkt oder Asset Management.

Sind Sie interessiert? Dann buchen Sie eine Demo und sprechen Sie mit uns. Wir freuen uns auf Sie und möchten Sie gerne kennenlernen und mehr über Ihr Unternehmen erfahren.

blog

Weitere Artikel