Bitcoin.de - API (Basic)

Die Bitcoin.de API (Basic) ermöglicht Ihnen den Zugriff auf die Übersicht der erfolgreich abgeschlossenen Trades (Tradehistory), der aktuellen Kauf- und Verkaufsangebote (Orderbook) und den aktuellen Bitcoin.de-Kurs (Rate). Tradehistory und Orderbook werden alle 60 Sekunden aktualisiert.

Die API (Basic) ist auch ohne großes technisches Wissen zu nutzen! Für fortgeschrittene User steht hier unsere vollumfängliche Bitcoin.de API zur Verfügung.

Für den Aufruf der API (Basic) wird ein API-Key benötigt, der mit Ihrem Bitcoin.de Account verknüpft ist. Jeder registrierte Bitcoin.de-User kann sich seinen persönlichen API-Key in seinem Account generieren.

Zugriffsbeschränkung

Der Zugriff auf die API (Basic) ist mengenmäßig beschränkt. Alle API-Keys eines Bitcoin.de-Accounts teilen sich ein Kontingent an sog. "Credits". Abhängig vom jeweiligen Trust-Level des Accounts ist das Kontingent auf ein bestimmtes Maximum gedeckelt. Die API-Aufrufe kosten Credits, die sofort vom aktuellen Kontingent abgezogen werden und dieses auch ins Negative laufen lassen können. Die aktuelle Höhe der Credits, wird mit jedem API-Aufruf zurückgeben. Befindet sich der User vor einem Aufruf bereits im Negativen, so verdoppeln sich die Kosten eines Aufrufs. Das Credit-Kontingent wird pro Sekunde, in der keine API-Abfrage gestellt wird, um einen Credit erhöht solange das Credit-Maximum noch nicht erreicht wurde. Sollten Sie trotz bereits negativem Credit-Kontingent viele weitere API-Requests stellen, so behalten wir uns vor, Ihre API-Zugänge temporär zu sperren.

Anleitung

Der Response der API (Basic) hat das JSON-Format und beinhaltet im Normalfall 3 Keys. Ein Key ("trades", "orderbook" oder "rate") enthält das Ergebnis Ihrer Anfrage, der Key "credits" enthält die Ihnen noch zur Verfügung stehenden Credits (siehe "Zugriffsbeschränkung") und der Key "errors" enthält im Fehlerfall einen Hinweis darauf, warum Ihre Anfrage fehlgeschlagen ist. Im Erfolgsfall handelt es sich um ein leeres Array. Die möglichen Werte für den Parameter ":trading_pair" können Sie der Tabelle "Handelspaare Krypto-zu-Euro Marktplatz" entnehmen.

Tradehistory

Abfrage erfolgreich abgeschlossener Trades. Wenn kein Parameter gesetzt wird, werden alle erfolgreich abgeschlossenen Trades der letzten 7 Tage zurückgeliefert.

https://api.bitcoin.de/v4/:trading_pair/basic/trades.json?apikey=YOUR_API_KEY

Über den Parameter “since” können inkrementelle Daten ab einer bestimmten ID abgefragt werden.

https://api.bitcoin.de/v4/:trading_pair/basic/trades.json?apikey=YOUR_API_KEY&since=123
Rückgabewerte:
  • Datum (Unixtimestamp)
  • Preis pro Coin (Euro)
  • Anzahl Coins
  • Eindeutige ID
  • Verbleibende Credits

Orderbook

Abfrage aller Kauf- und Verkaufsangebote (bids und asks).

https://api.bitcoin.de/v4/:trading_pair/basic/orderbook.json?apikey=YOUR_API_KEY
Rückgabewerte:
  • Typ (bids/asks)
  • Preis pro Coin (Euro)
  • Anzahl Coins
  • Verbleibende Credits

Rate

Abfrage des gewichteten Durchschnittskurses der letzten 3 Stunden und der letzten 12 Stunden.

https://api.bitcoin.de/v4/:trading_pair/basic/rate.json?apikey=YOUR_API_KEY

Der Wert “rate_weighted” gibt in der Regel den gewichtete Durchschnittskurs der letzten 3 Stunden an. Wird eine kritische Masse an Trades in den letzten 3 Stunden unterschritten, dann wird hier der 12 Stunden Durchschnitt zurückgegeben.

Rückgabewerte:
  • rate_weighted
  • rate_weighted_3h
  • rate_weighted_12h

Handelspaare Krypto-zu-Euro Marktplatz

Handelspaar-Kürzel Bezeichnung
btceur BTC / EUR
bcheur BCH / EUR
btgeur BTG / EUR
etheur ETH / EUR
bsveur BSV / EUR
ltceur LTC / EUR