API

Einführung

Public API und Trade API bieten eine bequeme Möglichkeit für Drittanbieter-Software, mit der Börse zu interagieren.

• Public API wird verwendet, um Informationen abzurufen, die keinen Zugriff auf persönliche Kontodaten erfordern.
• Trade API wird verwendet, um Aufträge zu erstellen und zu stornieren, aktuelle Guthaben abzufragen und Informationen abzurufen, die Zugriff auf persönliche Kontodaten erfordern.

Public API

Public API existiert derzeit in mehreren Versionen. Entwickler werden ermutigt, die neueste Version zur Verwendung in ihren Softwareprodukten auszuwählen.

v2

Public API Version 2 bietet die Möglichkeit, Folgendes zu erhalten: depth, fee, ticker, trades (Methoden).

Der Link sieht so aus: https://yobit.net/api/2/Paar/Methodenname

In einem Link kann nur ein Paar angegeben werden.
Beispiele für ein Paar ltc_btc:

• Depth: https://yobit.net/api/2/ltc_btc/depth
• Ticker: https://yobit.net/api/2/ltc_btc/ticker
• Trades: https://yobit.net/api/2/ltc_btc/trades
• Fee: https://yobit.net/api/2/ltc_btc/fee

v3

Der Hauptunterschied zwischen Public API Version 3 und Public API Version 2 ist die Möglichkeit, Informationen für mehrere Paare in einer einzigen Anfrage an den Server abzurufen. Dabei wird die Liste der gewünschten Paare durch einen Bindestrich angezeigt.

Serverantworten werden alle 2 Sekunden zwischengespeichert, daher macht es keinen Sinn, Anfragen öfter zu stellen.

Verfügbare Methoden: depth, ticker, trades, info.

Der Link sieht so aus: https://yobit.net/api/3/Methodenname/Aufzählung von Paaren
Es können mehrere Paare ohne Wiederholungen oder nur eines angegeben werden.

Die Methode info hat keinen Paaraufzählungsparameter. Diese Methode kann verwendet werden, um eine Liste der aktuellen Paare zu erhalten.

Beispiele für eine Liste von Paaren ltc_btc-nmc_btc:

• Info: https://yobit.net/api/3/info
• Depth: https://yobit.net/api/3/depth/ltc_btc-nmc_btc
• Ticker: https://yobit.net/api/3/ticker/ltc_btc-nmc_btc
• Trades: https://yobit.net/api/3/trades/ltc_btc-nmc_btc

Warnung! Wenn wir ein Paar aus der Liste deaktivieren, wird die API einen Fehler erzeugen. Um solche Fehler ignorieren zu können, steht der GET-Parameter ignore_invalid zur Verfügung.
Anwendungsbeispiel: https://yobit.net/api/3/depth/ltc_btc-error_pair?ignore_invalid=1

info

Anfragebeispiel: https://yobit.net/api/3/info

Antwortbeispiel:

{
	"server_time":1418654531,
	"pairs":{
		"ltc_btc":{
			"decimal_places":8,
			"min_price":0.00000001,
			"max_price":10000,
			"min_amount":0.0001,
			"hidden":0,
			"fee":0.2
		}
		...
	}
}

• decimal_places: Anzahl der zulässigen Dezimalstellen
• min_price: zulässiger Mindestpreis
• max_price: zulässiger Höchstpreis
• min_amount: zulässiger Mindestbetrag zum Kaufen oder Verkaufen
• hidden: Paar versteckt (0 oder 1)
• fee: Paarprovision

Versteckte Paare werden nicht auf der Hauptseite der Börse aufgeführt, aber die Tauschgeschäfte funktionieren weiterhin.
Wenn ein Paar deaktiviert wird, verschwindet es aus der Liste.

ticker

Die Methode liefert statistische Informationen für die letzten 24 Stunden.

Anfragebeispiel: https://yobit.net/api/3/ticker/ltc_btc

Antwortbeispiel:

{
	"ltc_btc":{
		"high":105.41,
		"low":104.67,
		"avg":105.04,
		"vol":43398.22251455,
		"vol_cur":4546.26962359,
		"last":105.11,
		"buy":104.2,
		"sell":105.11,
		"updated":1418654531
	}
	...
}

• high: Höchstpreis
• low: Mindestpreis
• avg: Durchschnittspreis
• vol: Handelsvolumen
• vol_cur: Handelsvolumen in Währung
• last: Preis der letzten Transaktion
• buy: Kaufpreis
• sell: Verkaufspreis
• updated: letzte Cache-Aktualisierung

depth

Die Methode liefert Informationen über die Listen der aktiven Aufträge der angegebenen Paare.

Der GET-Parameter limit legt die Auszahlungstiefe fest (Standard 150, maximal 2000 ).

Anfragebeispiel: https://yobit.net/api/3/depth/ltc_btc

Antwortbeispiel:

{
	"ltc_btc":{
		"asks":[
			[104.67,0.01],
			[104.75,11],
			[104.80,0.523],
			...
		],
		"bids":[
			[104.3,5.368783],
			[104.212,2.57357],
			[103.62,0.43663336],
			[103.61,0.7255672],
			...
		]
	}
	...
}

• asks: Verkaufsaufträge
• bids: Kaufaufträge

trades

Die Methode liefert Informationen über die letzten Transaktionen der angegebenen Paare.

Der GET-Parameter limit legt die Auszahlungstiefe fest (Standard 150, maximal 2000 ).

Anfragebeispiel: https://yobit.net/api/3/trades/ltc_btc

Antwortbeispiel:

{
	"ltc_btc":[
		{
			"type":"ask",
			"price":104.2,
			"amount":0.101,
			"tid":41234426,
			"timestamp":1418654531
		},
		{
			"type":"bid",
			"price":103.53,
			"amount":1.51414,
			"tid":41234422,
			"timestamp":1418654530
		},
		...
	]
	...
}

• type: ask - Verkauf, bid - Kauf
• price: Kauf-/Verkaufspreis
• amount: Betrag
• tid: Transaktions-ID
• timestamp: unix time der Transaktion

Trade API

Trade API wird verwendet, um Aufträge zu erstellen und zu stornieren, aktuelle Guthaben abzufragen und Informationen abzurufen, die Zugriff auf persönliche Kontodaten erfordern.

Um Trade API zu verwenden, müssen Sie einen Schlüssel im entsprechenden Bereich erstellen.
Die Verschlüsselung ist nur für eine Stunde nach der Erstellung einsehbar, daher empfehlen wir Ihnen, es sofort nach der Erstellung des Schlüssels zu speichern. Die Schlüssel und ihre Verschlüsselung werden zur Authentifizierung des Benutzers verwendet.

Adresse zum Senden von Trade-API-Anfragen: https://yobit.net/tapi/

Jede Anfrage erfordert eine Authentifizierung.

Alle Serverantworten sind im JSON-Format

Beispiel für eine erfolgreiche Serverantwort:

{"success":1,"return":{Antwort}}

Beispiel für eine Antwort, die über einen Fehler informiert:

{"success":0,"error":"Fehler"}

Authentifizierung

Jede Trade API-Anfrage muss authentifiziert werden.
Die Authentifizierung erfolgt durch Senden der folgenden HTTP-Header:

Key - API-Schlüssel, Beispiel: FAF816D16FFDFBD1D46EEF5D5B10D8A2

Sign - digitale Signatur, POST-Parameter (?param0=val0 & ...& nonce=1) signiert mit einem Geheimschlüssel unter Verwendung von HMAC-SHA512

Der Parameter nonce (Minimum 1, Maximum 2147483646) muss bei jeder neuen Anfrage größer sein als der Wert der vorherigen Anfrage.
Um die Nonce zurückzusetzen, müssen Sie einen neuen Schlüssel erstellen.

getInfo

Die Methode liefert Informationen über Benutzerguthaben und API-Schlüsselberechtigungen sowie die Serverzeit.

Anforderungen: Schlüsselberechtigung info

Parameter: keine

Antwortbeispiel:

{
	"success":1,
	"return":{
		"funds":{
			"ltc":22,
			"nvc":423.998,
			"ppc":10,
			...
		},
		"funds_incl_orders":{
			"ltc":32,
			"nvc":523.998,
			"ppc":20,
			...
		},	
		"rights":{
			"info":1,
			"trade":0,
			"withdraw":0
		},
		"transaction_count":0,
		"open_orders":1,
		"server_time":1418654530
	}
}

• funds: Verfügbarer Kontoguthaben (ohne Gelder auf offenen Aufträgen)
• funds_incl_orders: Verfügbarer Kontoguthaben (einschließlich Gelder auf offenen Aufträgen)
• rights: Schlüsselberechtigungen. withdraw wird nicht verwendet (reserviert)
• transaction_count: immer 0 (veraltet)
• open_orders: immer 0 (veraltet)
• server_time: Serverzeit

Trade

Die Methode, mit der neue Aufträge für den Handel an der Börse erstellt werden

Anforderungen: Schlüsselberechtigungen info&trade

Parameter:

• pair: Paar (Beispiel: ltc_btc)
• type: Vorgangstyp (Beispiel: buy oder sell)
• rate: Kurs, zu dem gekauft oder verkauft werden soll (Wert: numerisch)
• amount: zu kaufender oder zu verkaufender Betrag (Wert: numerisch)

Antwortbeispiel:

{
	"success":1,
	"return":{
		"received":0.1,
		"remains":0,
		"order_id":12345,
		"funds":{
			"btc":15,
			"ltc":51.82,
			"nvc":0,
			...
		}
	}
}

• received: wie viel Währung gekauft/verkauft wurde
• remains: wie viel Währung noch zu kaufen/verkaufen ist
• order_id: ID des erstellten Auftrags
• funds: aktuelle Guthaben nach Anfrage

ActiveOrders

Die Methode liefert eine Liste der aktiven Aufträge des Benutzers

Anforderungen: Schlüsselberechtigung info

Parameter:

• pair: Paar (Beispiel: ltc_btc)

Antwortbeispiel:

{
	"success":1,
	"return":{
		"100025362":{
			"pair":"ltc_btc",
			"type":"sell",
			"amount":21.615,
			"rate":0.258,
			"timestamp_created":1418654530,
			"status":0
		},
		...
	}
}

• Feldschlüssel: ID der Aufträge (im Beispiel: 100025362)
• pair: Paar (Beispiel: ltc_btc)
• type: Vorgangstyp (Beispiel: buy oder sell)
• amount: noch zu kaufen oder zu verkaufen
• rate: Kauf- oder Verkaufspreis
• timestamp_created: Zeitpunkt der Auftragserstellung
• status: immer 0 (veraltet)

OrderInfo

Die Methode liefert detaillierte Informationen über den angegebenen Auftrag

Anforderungen: Schlüsselberechtigung info

Parameter:

• order_id: ID des Auftrags (Werte: numerisch)

Antwortbeispiel:

{
	"success":1,
	"return":{
		"100025362":{
			"pair":ltc_btc,
			"type":sell,
			"start_amount":13.345,
			"amount":12.345,
			"rate":485,
			"timestamp_created":1418654530,
			"status":0
		}
	}
}

• Feldschlüssel: ID des Auftrags (im Beispiel: 100025362)
• pair: Auftragspaar (Beispiel: ltc_btc)
• type: Auftragstyp (Beispiel: buy oder sell)
• start_amount: ursprünglicher Betrag des Auftrags bei der Erstellung
• amount: Restbetrag, der im Rahmen des Auftrags gekauft oder verkauft werden soll
• rate: Kauf- oder Verkaufspreis
• timestamp_created: Zeitpunkt der Auftragserstellung
• status: 0 - aktiv, 1 - ausgeführt und abgeschlossen, 2 - storniert, 3 - storniert, aber teilweise ausgeführt.

CancelOrder

Die Methode storniert den angegebenen Auftrag

Anforderungen: Schlüsselberechtigungen info&trade

Parameter:

• order_id: ID des Auftrags (Werte: numerisch)

Antwortbeispiel:

{
	"success":1,
	"return":{
		"order_id":100025362,
		"funds":{
			"btc":15,
			"ltc":51.82,
			"nvc":0,
			...
		}
	}
}

• order_id: ID des Auftrags
• funds: aktuelle Guthaben nach Anfrage<

TradeHistory

Die Methode liefert den Verlauf von Transaktionen.

Anforderungen: Schlüsselberechtigung info

Parameter:

• from: Transaktionsnummer, ab der die Auszahlung beginnen soll (Werte: numerisch, Standard: 0)
• count: Anzahl der Auszahlungstransaktionen (Werte: numerisch, Standard: 1000)
• from_id: Transaktions-ID, ab der die Auszahlung beginnen soll (Werte: numerisch, Standard: 0)
• end_id: Transaktions-ID, mit der die Auszahlung enden soll (Werte: numerisch, Standard: ∞)
• order: Sortierung bei der Auszahlung (Werte: ASC oder DESC, Standard: DESC)
• since: zu welchem Zeitpunkt die Auszahlung beginnen soll (Werte: unix time, Standard: 0)
• end: zu welchem Zeitpunkt die Auszahlung beendet werden soll (Werte: unix time, Standard: ∞)
• pair: Paar (Beispiel: ltc_btc)

Bei Verwendung der Parameter since oder end, wird der Parameter order automatisch gesetzt zu ASC.

Bei Verwendung des Parameters since, liegt das maximale Datum, für das der Verlauf abgerufen werden kann, vor einer Woche..

Antwortbeispiel:

{
	"success":1,
	"return":{
		"24523":{
			"pair":"ltc_btc",
			"type":"sell",
			"amount":11.4,
			"rate":0.145,
			"order_id":100025362,
			"is_your_order":1,
			"timestamp":1418654530
		}
		...
	}
}

• Feldschlüssel: ID der Transaktionen (im Beispiel: 24523)
• pair: Paar (Beispiel: ltc_btc)
• type: Vorgangstyp (Beispiel: buy oder sell)
• amount: gekaufte oder verkaufte Beträge
• rate: Kauf- oder Verkaufspreis
• order_id: ID des Auftrags
• is_your_order: gehört der Auftrag Ihnen (1 oder 0)
• timestamp: Zeitpunkt der Transaktion

GetDepositAddress

Die Methode liefert die Auffülladresse.

Anforderungen: Schlüsselberechtigung deposits

Parameter:

• coinName: Währungsticker (Beispiel: BTC)
• need_new: value: 0 oder 1, Standard: 0

Antwortbeispiel:

{
	"success":1,
	"return":{
		"address": 1UHAnAWvxDB9XXETsi7z483zRRBmcUZxb3,
		"processed_amount": 1.00000000,		
		"server_time": 1437146228
	}
}

WithdrawCoinsToAddress

Die Methode erstellt einen Auszahlungsantrag.

Anforderungen: Schlüsselberechtigung withdrawals

Parameter:

• coinName: Währungsticker (Beispiel: BTC)
• amount: Auszahlungsbetrag
• address: Empfängeradresse

Antwortbeispiel:

{
	"success":1,
	"return":{
		"server_time": 1437146228
	}
}

CreateYobicode

Die Methode dient der Erstellung von Yobicodes (Gutscheinen).

Alternative Schreibweise der Methode: CreateCoupon

Anforderungen: Schlüsselberechtigung withdrawals

Parameter:

• currency: Währungsticker (Beispiel: BTC)
• amount: Yobicode-Betrag

Antwortbeispiel:

{
	"success":1,
	"return":{
		"coupon": "YOBITUZ0HHSTBCOH5F6EAOENCRD8RGOQX3H01BTC",
		"transID": 1,	
		"funds":{
			"btc":15,
			"ltc":51.82,
			"nvc":0,
			...
		}
	}
}

• coupon: Yobicode
• transID: immer 1 für die Kompatibilität mit den APIs anderer Börsen
• funds: aktuelle Guthaben nach Anfrage

RedeemYobicode

Die Methode dient der Einlösung von Yobicodes (Gutscheinen).

Alternative Schreibweise der Methode: RedeemCoupon

Anforderungen: Schlüsselberechtigung deposits

Parameter:

• coupon: yobicode zum Gutschreiben (Beispiel: YOBITUZ0HHSTB...OQX3H01BTC)

Antwortbeispiel:

{
	"success":1,
	"return":{
		"couponAmount": "1.2345",
		"couponCurrency": "BTC",
		"transID": 1,	
		"funds":{
			"btc":15,
			"ltc":51.82,
			"nvc":0,
			...
		}
	}
}

• couponAmount: Gutgeschriebener Betrag.
• couponCurrency: Gutgeschriebene Yobicode-Währung.
• transID: immer 1 für die Kompatibilität mit den APIs anderer Börsen
• funds: aktuelle Guthaben nach Anfrage

Defi Public API

Beispiel für die Abfrage von Informationen zu allen Pools:
https://yobit.net/api/defi/info

Beispiel für die Abfrage von Informationen zu bestimmten Pools:
https://yobit.net/api/defi/info/btc_usdt-yo_btc

Antwortbeispiel:

{
	"server_time":1418654531,
	"pools":{
		"usdt_spitz":{
			"liq1":"45540230.71160736",
			"liq2":"230.12172671",
			"price1":"0.00000505",
			"price2":"197896.26717427",
			"fee":"0.003",
			"price24high1":"0.00000512",
			"price24low1":"0.00000505",
			"price24high2":"197898.16740049",			
			"price24low2":"195199.11794729",
			"vol1":"47.57434935",			
			"vol2":"2.61017416",
			"algo1":"erc20",
			"tokenid1":"0xdac17f958d2ee523a2206206994597c13d831ec7",
			"algo2":"bep20",
			"tokenid2":"0x9d1d63501e3490aeedf0dba24f60c29918caf965",

		}
		...
	}
}

• liq1: Währung 1 von Liquiditätsanbietern in den Pool eingelegt
• liq2: Währung 2 von Liquiditätsanbietern in den Pool eingelegt
• price1: aktueller price 1
• price2: aktueller price 2
• fee: Provision in % (0,003 bedeutet 0,3 %)
• price24high1: der höchste price 1 in den letzten 24 Stunden
• price24low1: der niedrigste price 1 in den letzten 24 Stunde
• price24high2: der höchste price 2 in den letzten 24 Stunden
• price24low2: der niedrigste price 2 in den letzten 24 Stunden
• vol1: Swapvolumen in Währung 1 in den letzten 24 Stunden
• vol2: Swapvolumen in Währung 2 in den letzten 24 Stunden
• algo1: erc20, trc20, bep20 oder SHA256/Scrypt/X11
• tokenid1: für Währung 1 Token-Adresse für erc20-, trc20-, bep20-Algorithmen oder leer für andere
• algo2: erc20, trc20, bep20 or SHA256/Scrypt/X11
• tokenid2: für Währung 2 Token-Adresse für erc20-, trc20-, bep20-Algorithmen oder leer für andere

Versteckte Pools werden nicht auf der Hauptseite der Börse aufgeführt.
Wenn ein Pool deaktiviert wird, verschwindet er aus der Liste.

DefiSwapInfo

Die Methode ist für die Durchführung von Defi-Swaps bestimmt.

Anforderungen: Schlüsselberechtigung info&trade

Parameter:

• pool: Poolname im Format cur1_cur2 (Beispiel: btc_usdt)
• PayCurrency: Währung, die Sie beim Swap ausgeben. Sie muss cur1 ODER cur2 sein (Beispiel: usdt)
• PayAmount: Betrag, der Sie beim Swap ausgeben (Beispiel: 1.123)

Antwortbeispiel:

{
	"success":1,
	"swap_made":0,
	"info":{
		"desc": "SWAP 1.12300000 USDT to 0.00002567 BTC with price 43732.86034952",
		"pay_amount": "1.12300000",
		"pay_currency": "USDT",
		"get_amount": "0.00002567",
		"get_currency": "BTC",
		"price_of_swap": "43732.86034952",
		"fee_total": "0.00000007",
		"fee_total_currency": "BTC",
		"price1_before": "43601.61783433",
		"price1_after": "43601.70585432",
		"price2_before": "0.00002293",
		"price2_after": "0.00002294",
	}
}

• swap_made: ist immer 0. Zeigt an, dass der Swap nicht wirklich stattgefunden hat.
• pay_amount: Betrag, der Sie beim Swap ausgeben
• pay_currency: Währung, die Sie beim Swap ausgeben
• get_amount: Betrag, der Sie beim Swap erhalten
• get_currency: Währung, die Sie beim Swap erhalten
• price_of_swap: Swap-Preis (
• fee_total: Provisionsbetrag
• fee_total_currency: Provisionswährung
• price1_before: aktueller Preis von Pool 1 vor dem Swap
• price1_after: aktueller Preis von Pool 2 vor dem Swap
• price2_before: zeigt, wie hoch der Preis von Pool 1 nach dem Swap gewesen wäre
• price2_after: zeigt, wie hoch der Preis von Pool 2 nach dem Swap gewesen wäre

DefiSwap

Die Methode ist für die Durchführung von Defi-Swaps bestimmt.

Anforderungen: Schlüsselberechtigung info&trade

Parameter:

• pool: Poolname im Format cur1_cur2 (Beispiel: btc_usdt)
• PayCurrency: Währung, die Sie beim Swap ausgeben. Sie muss cur1 ODER cur2 sein (Beispiel: usdt)
• PayAmount: Betrag, der Sie beim Swap ausgeben (Beispiel: 1.123)

Antwortbeispiel:

{
	"success":1,
	"swap_made":0,
	"info":{
		"desc": "SWAP 1.12300000 USDT to 0.00002567 BTC with price 43732.86034952",
		"pay_amount": "1.12300000",
		"pay_currency": "USDT",
		"get_amount": "0.00002567",
		"get_currency": "BTC",
		"price_of_swap": "43732.86034952",
		"fee_total": "0.00000007",
		"fee_total_currency": "BTC",
		"price1_before": "43601.61783433",
		"price1_after": "43601.70585432",
		"price2_before": "0.00002293",
		"price2_after": "0.00002294",
	},
	"user":{
		"new_balance1": "12.07789855",
		"new_balance1_currency": "BTC",
		"new_balance2": "497908.66928976",
		"new_balance2_currency": "USDT",
		"pooled1": "1.07518709",
		"pooled2": "46729.28782075",
		"pooled_est": "$93,233.91955017",
		"pooled_pr": "2.1456",
		"comfee1": "4.1894",
		"comfee2": "625.3309128",
		"comfee_est": "$1,207.09775086",
	}	
}

• pay_amount: Betrag, der Sie beim Swap ausgeben
• pay_currency: Währung, die Sie beim Swap ausgeben
• get_amount: Betrag, der Sie beim Swap erhalten
• get_currency: Währung, die Sie beim Swap erhalten
• price_of_swap: Swap-Preis (
• fee_total: Provisionsbetrag
• fee_total_currency: Provisionswährung
• price1_before: Preis von Pool 1 vor dem Swap
• price1_after: Preis von Pool 2 vor dem Swap
• price2_before: Preis von Pool 1 nach dem Swap
• price2_after: Preis von Pool 2 nach dem Swap
• new_balance1: Ihr neues Guthaben von Währung 1 nach dem Swap
• new_balance1_currency: Name der Währung 1
• new_balance2: Ihr neues Guthaben von Währung 2 nach dem Swap
• new_balance2_currency: Name der Währung 2
• pooled1: Ihr Anteil an Währung 1 im Liquiditätspool
• pooled2: Ihr Anteil an Währung 2 im Liquiditätspool
• pooled_est: ungefährer Betrag von pooled1+pooled2 in USD
• pooled_pr: Ihr Prozent des Liquiditätspools (Beispiel: 2,1456 bedeutet 2,1456 % des Liquiditätspools)
• comfee1: verdiente Provision (insgesamt Währung 1)
• comfee2: verdiente Provision (insgesamt Währung 2)
• comfee_est: ungefährer Betrag von comfee1+comfee2 in USD