Durchsuchen des Orderbooks nach passenden Angeboten

Credits:

2

URL-Parameter

GET - Parameter

Response

Success 200

Name	Type	Value	Notes
orders	Array		Gefundene Angebote

Orders

Name	Type	Value	Notes
order_id	String		ID des Angebots
is_external_wallet_order	Boolean		Zeigt an ob sich die Order auf einen "Krypto-zu-Krypto (mit eigener Wallet)" Marktplatz bezieht.
trading_pair	String		Handelspaar (s. Tabelle Handelspaare)
type	String	buy sell	Typ des Angebots
max_amount_currency_to_trade	Float		Maximal handelbare Coin-Menge
min_amount_currency_to_trade	Float		Mindestens handelbare Coin-Menge
price	Float		Preis pro Coin
max_volume_currency_to_pay	Float		Max. Volumen des Angebots
min_volume_currency_to_pay	Float		Min. Volumen des Angebots
order_requirements_fullfilled	Boolean		Zeigt an, ob das Angebot bedient werden könnte oder nicht (Trust-Level, KYC-Full, Sitz der Bank etc.).
sepa_option	Integer	0 1	Optionen zur Abwicklung via SEPA 0 => keine Optionen vorhanden 1 => Beschleunigte Zahlungsabwicklung via SEPA-Echtzeitüberweisung möglich
trading_partner_information	Array		Infos zum User des Angebots (s. Tabelle Trading Partner Information)
order_requirements	Array		Voraussetzungen zum Bedienen des Angebots (s. Tabelle Order Requirements)

Trading-Partner-Information (beziehen sich auf den Ersteller des Angebots)

Name	Type	Value	Notes
username	String		User-Name
is_kyc_full	Boolean		Vollständig identifizierter User
trust_level	String	bronze silver gold platin	Trust-Level
bank_name	String		Name der Bank
bic	String		BIC der Bank
rating	Integer		Prozentualer Anteil an positiven Bewertungen durch die Handelspartner
amount_trades	Integer		Anzahl bereits getätigter Trades

Order Requirements

Name	Type	Value	Notes
min_trust_level	String	bronze silver gold platin	Mindest-Trust-Level des Handelspartners
only_kyc_full OPTIONAL	Boolean		Handelspartner muss vollständig identifiziert sein
seat_of_bank OPTIONAL	Array	Bankenländerliste	Erlaubte Länder, in denen die Bank des Handelspartners ihren Sitz haben darf (ISO 3166-2) s. Tabelle Bankenländerliste
payment_option OPTIONAL	Integer	1 2 3	1 => Express-Only 2 => SEPA-Only 3 => Express & SEPA

Success-Response:

HTTP/1.1 200 OK
{
   "orders": [{
       "order_id": "A1B2D3",
       "is_external_wallet_order":false,
       "trading_pair": "btceur",
       "type": "buy",
       "max_amount":0."max_amount_currency_to_trade":0.5,
       "min_amount":0."min_amount_currency_to_trade":0.1,
       "price":230.55,
       "max_volume":115."max_volume_currency_to_pay":115.28,
       "min_volume":23."min_volume_currency_to_pay":23.06,
       "order_requirements_fullfilled":true,
       "sepa_option":0,
       "trading_partner_information":{
           "username":"bla",
           "is_kyc_full":true,
           "trust_level":"gold",
           "bank_name":"Sparkasse",
           "bic":"HASPDEHHXXX",
           "seat_of_bank":"DE",
           "rating": 99,
           "amount_trades": 52
       },
       "order_requirements":{
           "min_trust_level":"gold",
           "only_kyc_full":true,
           "seat_of_bank":[
               "DE",
               "NL"
           ],
           "payment_option":1
       }
   }],
   "errors":[

   ],
   "credits":12
}

Error

Http-Status 422

---

HTTP/1.1 200 OK
{
   "orders":{
        "order_id":"ETHBTC-75S6ZF",
        "is_external_wallet_order":true,
        "trading_pair":"ethbtc",
        "type":"buy",
        "max_amount_currency_to_trade":"10.00000000",
        "min_amount_currency_to_trade":"9.00000000",
        "price":"0.01900000",
        "max_volume_currency_to_pay":"0.19",
        "min_volume_currency_to_pay":"0.171",
        "order_requirements_fullfilled":true,
        "trading_partner_information":{
           "username":"maxM",
           "is_kyc_full":true,
           "trust_level":"bronze",
           "amount_trades":72,
           "rating":99
        },
   },
   "errors":[
   ],
   "credits":12
}

Details zu einem Angebot abrufen

Credits:

2

URL-Parameter

Response

Success 200

Name	Type	Value	Notes
order	Array		Gefundenes Angebot

Order

Name	Type	Value	Notes
order_id	String		ID des Angebots
is_external_wallet_order	Boolean		Zeigt an ob sich die Order auf einen "Krypto-zu-Krypto (mit eigener Wallet)" Marktplatz bezieht.
trading_pair	string		Handelspaar (s. Tabelle Handelspaare)
type	String	buy sell	Typ des Angebots
max_amount_currency_to_trade	Float		Maximal handelbare Coin-Menge
min_amount_currency_to_trade	Float		Mindestens handelbare Coin-Menge
price	Float		Preis pro Coin
max_volume_currency_to_pay	Float		Max. Volumen des Angebots
min_volume_currency_to_pay	Float		Min. Volumen des Angebots
order_requirements_fullfilled	Boolean		Zeigt an, ob das Angebot bedient werden könnte oder nicht (Trust-Level, KYC-Full, Sitz der Bank etc.).
sepa_option	Integer	0 1	Zeigt an, welche SEPA-Optionen für das Angebot vorliegen (nur in Kombination mit der payment_option "2" oder "3" möglich, s. Tabelle Order Requirements). 0 => keine SEPA-Option vorhanden 1 => beschleunigte Zahlungsabwicklung via SEPA-Echtzeitüberweisung möglich.
trading_partner_information	Array		Infos zum User des Angebots (s. Tabelle Trading Partner Information)
order_requirements	Array		Voraussetzungen zum Bedienen des Angebots (s. Tabelle Order Requirements)

Trading-Partner-Information (beziehen sich auf den Ersteller des Angebots)

Name	Type	Value	Notes
username	String		User-Name
is_kyc_full	Boolean		Vollständig identifizierter User
trust_level	String	bronze silver gold platin	Trust-Level
bank_name	String		Name der Bank
bic	String		BIC der Bank
rating	Integer		Prozentualer Anteil an positiven Bewertungen durch die Handelspartner
amount_trades	Integer		Anzahl bereits getätigter Trades

Order Requirements

Name	Type	Value	Notes
min_trust_level	String	bronze silver gold platin	Mindest-Trust-Level des Handelspartners
only_kyc_full	Boolean		Handelspartner muss vollständig identifiziert sein
seat_of_bank	Array	Bankenländerliste	Erlaubte Länder, in denen die Bank des Handelspartners ihren Sitz haben darf (ISO 3166-2) s. Tabelle Bankenländerliste
payment_option	Integer	1 2 3	1 => Express-Only 2 => SEPA-Only 3 => Express & SEPA

Success-Response:

HTTP/1.1 200 OK
{
   "order":{
       "order_id": "A1B2D3",
       "trading_pair":"btceur",
       "type": "buy",
       "max_amount":0.5,
       "min_amount":0.1,
       "price":230.55,
       "max_volume":115.28,
       "min_volume":23.06,
       "order_requirements":{
           "min_trust_level":"gold",
           "only_kyc_full":true,
           "seat_of_bank":[
               "DE",
               "NL"
           ],
           "payment_option":1,
       }
       "trading_partner_information":{
           "username":"mustermann",
           "is_kyc_full":true,
           "trust_level":"gold",
           "bank_name":"Sparkasse",
           "bic":"HASPDEHHXXX",
           "seat_of_bank":"DE",
           "rating": 99,
           "amount_trades": 52
       },

       "order_requirements_fullfilled":true,
      "order_id":"82NW88",
      "trading_pair":"btceur",
      "is_external_wallet_order":false,
      "type":"sell",
      "max_amount_currency_to_trade":"0.015",
      "min_amount_currency_to_trade":"0.015",
      "price":8660,
      "max_volume_currency_to_pay":129.9,
      "min_volume_currency_to_pay":129.9,
      "order_requirements":{
         "min_trust_level":"bronze",
         "only_kyc_full":true,
         "seat_of_bank":[ "AT", "DE" ],
         "payment_option":3
      },
      "trading_partner_information":{
         "username":"MusterMann",
         "is_kyc_full":true,
         "trust_level":"gold",
         "bank_name":"Fidor Bank",
         "bic":"FDDODEMMXXX",
         "seat_of_bank":"DE",
         "amount_trades":90,
         "rating":97
      },
      "order_requirements_fullfilled":true,
      "sepa_option":0
   },
   "errors":[

   ],
   "credits":12
"errors":[],
   "credits":62
}

Error

Http-Status 404

---

HTTP/1.1 200 OK
{
   "order":{
      "order_id":"ETHBTC-YTR3N3",
      "trading_pair":"ethbtc",
      "is_external_wallet_order":true,
      "type":"sell",
      "max_amount_currency_to_trade":"13",
      "min_amount_currency_to_trade":"6.5",
      "price":"0.012",
      "max_volume_currency_to_pay":"0.156",
      "min_volume_currency_to_pay":"0.078",
      "order_requirements_fullfilled":true,
      "trading_partner_information":{
         "username":"Max",
         "is_kyc_full":true,
         "trust_level":"bronze",
         "amount_trades":72,
         "rating":67
      },
   },
   "errors":[],
   "credits":198
}

Anlegen einer neuen Order

Credits:

1

URL-Parameter

POST - Parameter

Response

Success 201

Name	Type	Value	Notes
order_id	String		Die ID des angelegten Angebots.

Location-Header

Sofern die Details zu der neu angelegten Order abgerufen werden sollen, kann der hier im Location-Header enthaltene URI verwendet werden, der auf die API-Methode "showMyOrderDetails" der konkreten Order zeigt.

https://api.bitcoin.de/v4/:trading_pairs/orders/:order_id

Success-Response:

HTTP/1.1 201 Created
{
 "order_id": "A1234BC",
 "errors": [],
 "credits": 8
}

Error

Http-Status 422

---

https://api.bitcoin.de/v4/:trading_pair/orders/:order_id

HTTP/1.1 201 Created
{
 "order_id": "ETHBTC-A1234BC",
 "errors": [],
 "credits": 8
}

Löschen einer Order

Credits:	2
Credits (instant*):	10
*Orders die nicht älter als 60 Sekunden sind.

Bitte beachten Sie (neu ab API-Version v4): Die Methode deleteOrder kann jederzeit, d.h. auch bei einem negativen Credit-Stand ausgeführt werden. Es wird also nie ein HTTP-Statuscode 429 zurückgegeben.

URL-Parameter

Response

Success-Response:

HTTP/1.1 200 OK
{
 "errors": [],
 "credits": 5
}

Error

Http-Status 403

Http-Status 404

Http-Status 422

---

Abrufen und Filtern meiner Orders

Credits:

2

Berücksichtigt alle Handelspaare Berücksichtigt ein spezifisches Handelspaar

URL-Parameter

GET - Parameter

Response

Success 200

Name	Type	Value	Notes
orders	Array		Max. 20 Angebote mit ihren Details (s. Tabelle Order-Details)
page	Array		Informationen zu den möglichen Ergebnisseiten (s. Tabelle Page-Details)

Page Details

Name	Type	Value	Notes
current	Integer		Aktuell zurückgelieferte Seite
last	Integer		Letzte verfügbare Seite zu den Suchkriterien

Success-Response:

HTTP/1.1 200 OK
{
   "orders":
   [
     {
       "order_id': "2EDYNS",
       "trading_pair": "btceur",
       "type": "sell",
       "max_amount": 0.      {
         "order_id":"6784S7",
         "trading_pair":"btceur",
         "is_external_wallet_order":false,
         "type":"sell",
         "max_amount_currency_to_trade":"0.015",
         "min_amount_currency_to_trade":"0.007",
         "price":8700,
         "max_volume_currency_to_pay":130.5,
       "min_amount": 0.2,
       "price": 250.55,
       "max_volume": 125.28,
       "min_volume": 50.11,
       "end_datetime": "2015-01-20T15:00:00+02:00",
       "new_order_for_remaining_amount": true,
       "state": 0,
        "order_requirements":
        {
           "min_trust_level":"silver",
           "only_kyc_full": true,
           "payment_option": 1,
                    "min_volume_currency_to_pay":60.9,
         "order_requirements":
         {
            "min_trust_level":"bronze",
            "only_kyc_full":true,
            "seat_of_bank": {"DE", "NL"}
        },
        "created_at": "2015-01-10T15:00:00+02:00"
[ "AT", "DE" ],
            "payment_option":3
         },
         "new_order_for_remaining_amount":false,
         "state":0,
         "sepa_option":1,
         "end_datetime":"2019-09-16T23:45:00+02:00",
         "created_at":"2019-08-12T08:33:24+02:00"
      },
      {
         "order_id":"4XDM7A",
         "trading_pair":"btceur",
         "is_external_wallet_order":false,
         "type":"buy",
         "max_amount_currency_to_trade":"0.15",
         "min_amount_currency_to_trade":"0.075",
         "price":8590,
         "max_volume_currency_to_pay":1288.5,
         "min_volume_currency_to_pay":644.25,
         "order_requirements":
         {
            "min_trust_level":"bronze",
            "only_kyc_full":false,
            "seat_of_bank":["DE"],
            "payment_option":1
         },
         "new_order_for_remaining_amount":true,
         "state":0,
         "sepa_option":0,
         "end_datetime":"2019-09-16T23:45:00+02:00",
         "created_at":"2019-08-12T08:32:53+02:00"
      },
      {
         "order_id":"FZ2VA7",
         "trading_pair":"btceur",
         "is_external_wallet_order":false,
         "type":"buy",
         "max_amount_currency_to_trade":"0.01",
         "min_amount_currency_to_trade":"0.01",
         "price":8500,
         "max_volume":85,
         "min_volume":85,
         "order_requirements":
         {
            "min_trust_level":"bronze",
            "only_kyc_full":false,
            "seat_of_bank":[ "AT", "DE", "NL" ]
            "payment_option":1
         },
         "new_order_for_remaining_amount":true,
         "state":0,
         "sepa_option":0,
         "end_datetime":"2019-09-11T23:45:00+02:00",
         "created_at":"2019-08-07T12:18:00+02:00"
      }
   ],
   "page": {
       "current": 1,
       "last": 2
"page":{
      "current":1,
      "last":1
   },
   "errors": [],
   "credits": 15
"errors":[],
   "credits":68
}

Error

Http-Status 404

Http-Status 422

---

HTTP/1.1 200 OK
{
   "orders":
   [
      {
         "order_id":"ETHBTC-TT4RZR",
         "trading_pair":"ethbtc",
         "is_external_wallet_order":true,
         "type":"buy",
         "max_amount_currency_to_trade":"12",
         "min_amount_currency_to_trade":"10",
         "price":"0.01151",
         "max_volume_currency_to_pay":"0.13812",
         "min_volume_currency_to_pay":"0.1151",
         "new_order_for_remaining_amount":false,
         "state":"0",
         "end_datetime":"2019-08-17T23:45:00+02:00",
         "created_at":"2019-08-12T08:01:26+02:00",
      },
      {
         "order_id":"ETHBTC-76P6EX",
         "trading_pair":"ethbtc",
         "is_external_wallet_order":true,
         "type":"buy",
         "max_amount_currency_to_trade":"10",
         "min_amount_currency_to_trade":"10",
         "price":"0.019",
         "max_volume_currency_to_pay":"0.19",
         "min_volume_currency_to_pay":"0.19",
         "new_order_for_remaining_amount":false,
         "state":"0",
         "end_datetime":"2019-08-06T23:45:00+02:00",
         "created_at":"2019-08-01T13:48:01+02:00",
      }
   ],
   "page":
   {
       "current":1,
       "last":1
   },
   "errors":[],
   "credits":60
}

Details zu einer meiner Order abrufen

Credits:

2

URL-Parameter

Response

Success 200

Name	Type	Value	Notes
order	Array		Details zum Angebot (s. Tabelle Order-Details)

Order Details

Name	Type	Value	Notes
order_id	String		ID des Angebots
trading_pair	String		Handelspaar (s. Tabelle Handelspaare)
is_external_wallet_order	Boolean		Zeigt an ob sich die Order auf einen "Krypto-zu-Krypto (mit eigener Wallet)" Marktplatz bezieht.
type	String	buy sell	Typ des Angebots
max_amount_currency_to_trade	Float		Maximal zu kaufende/verkaufende Coin-Menge
min_amount_currency_to_trade	Float		Minimal zu kaufende/verkaufende Coin-Menge
price	Float		Preis pro Coin in Euro
max_volume_currency_to_pay	Float		Max. Euro-Volumen der Order
min_volume_currency_to_pay	Float		Min. Euro-Volumen der Order
end_datetime	String		Ablaufzeitpunkt des Angebots. Format gemäß RFC 3339 (Bsp: 2015-01-20T15:00:00+02:00).
new_order_for_remaining_amount	Boolean		Neues Angebot mit Restmenge anlegen, wenn nur eine Teilmenge aus dem Angebot bedient wurde.
state	Integer		Aktueller Status (s. Tabelle Possible Order-State-Values)
order_requirements	Array		Voraussetzungen zum Bedienen des Angebots (s. Tabelle Order Requirements)
sepa_option	Integer	0 1	Gibt zusätzliche SEPA-Optionen an (nur in Kombination mit der payment_option "2" oder "3" möglich, s. Tabelle Order Requirements). 0 => keine SEPA-Optionen vorhanden 1 => beschleunigte Zahlungsabwicklung via SEPA-Echtzeitüberweisung möglich
created_at	String		Erstellzeitpunkt des Angebots. Format gemäß RFC 3339 (Bsp: 2015-01-20T15:00:00+02:00)

Order requirements

Name	Type	Value	Notes
min_trust_level	String	bronze silver gold platin	Mindest-Trust-Level des Handelspartners
only_kyc_full	Boolean		Handelspartner muss vollständig identifiziert sein
seat_of_bank	Array	Bankenländerliste	Erlaubte Länder, in denen die Bank des Handelspartners ihren Sitz haben darf (ISO 3166-2)
payment_option	Integer		1 => Express-Only 2 => SEPA-Only 3 => Express & SEPA

Location-Header

Hinweis: Sofern das Angebot z.T. oder komplett von einem anderen Marktplatzteilnehmer bedient wurde, wird der Status-Code 301 erfolgen und ein Location-Header mit dem URI im Response übergeben, der auf die API-Methode "showMyTradeDetails" des konkreten Trades zeigt.

https://api.bitcoin.de/v4/:trading_pair/trades/:trade_id

Possible Order-State-Values

Code	Reason	Note
-2	Expired	Angebot ist ausgelaufen
-1	Cancelled	Angebot wurde abgebrochen
0	Pending	Das Angebot ist auf dem Marktplatz verfügbar.

Success-Response:

HTTP/1.1 200 OK
{
   "order":
   {
       "order_id': "2EDYNS",
       "trading_pair": "btceur",
       "is_external_wallet_order": false,
       "type": "sell",
       "max_amount": "max_amount_currency_to_trade": 0.5,
       "min_amount": "min_amount_currency_to_trade": 0.2,
       "price": 250.55,
       "max_volume": "max_volume_currency_to_pay": 125.28,
       "min_volume": "min_volume_currency_to_pay": 50.11,
       "end_datetime": "2015-01-20T15:00:00+02:00",
       "new_order_for_remaining_amount": true,
       "state": 0,
       "order_requirements":
        {
           "min_trust_level":"silver",
           "only_kyc_full": true,
           "payment_option": 1,
           "seat_of_bank": {"DE", "NL"}
        },
        "sepa_option": 0,
        "created_at": "2015-01-10T15:00:00+02:00"
   },
   "errors": [],
   "credits": 15
}

Error

Http-Status 404

---

https://api.bitcoin.de/v4/:trading_pair/trades/:trade_id

HTTP/1.1 200 OK
{
   "order":
   {
       "order_id":"ETHBTC-TT4RZR",
       "trading_pair":"ethbtc",
       "is_external_wallet_order":true,
       "type":"buy",
       "max_amount_currency_to_trade":"12",
       "min_amount_currency_to_trade":"10",
       "price":"0.01151",
       "max_volume_currency_to_pay":"0.13812",
       "min_volume_currency_to_pay":"0.1151",
       "new_order_for_remaining_amount":false,
       "state":"0",
       "end_datetime":"2019-08-17T23:45:00+02:00",
       "created_at":"2019-08-12T08:01:26+02:00",
   },
   "errors":[],
   "credits": 15
}

Kaufen/Verkaufen einer konkreten Order

Credits:

1

URL-Parameter

POST - Parameter

Response

Location-Header

Sofern die Details zu dem neu angelegten Trade abgerufen werden sollen, kann der hier im Location-Header enthaltene URI verwendet werden, der auf die API-Methode "showMyTradeDetails" des konkreten Trades zeigt.

https://api.bitcoin.de/v4/:trading_pair/trades/:trade_id

Success-Response:

HTTP/1.1 201 OK
{
 "errors": [],
 "credits": 8
}

Error

Http-Status 404

Http-Status 422

---

https://api.bitcoin.de/v4/:trading_pair/trades/:trade_id

HTTP/1.1 201 OK
{
 "errors": [],
 "credits": 8
}

Abrufen und Filtern meiner getätigten Trades

Credits:

3

Berücksichtigt alle Handelspaare Berücksichtigt ein spezifisches Handelspaar

URL-Parameter

GET - Parameter

Response

Success 200

Name	Type	Value	Notes
trades	Array		Max. 20 Trades mit ihren Details (s. Tabelle Trade-Details)
page	Array		Informationen zu den möglichen Ergebnisseiten (s. Tabelle Page-Details)

Page Details

Name	Type	Value	Notes
current	Integer		Aktuell zurückgelieferte Seite
last	Integer		Letzte verfügbare Seite zu den Suchkriterien

Success-Response:

HTTP/1.1 200 OK
{
   "trades":
   [
     {
       "trade_id': "2EDYNS",
       "trading_pair": "btceur",
       "is_external_wallet_trade": false,
       "type": "sell",
       "amount": "amount_currency_to_trade": 0.5,
       "price": 250.55,
       "volume": "volume_currency_to_pay": 125.28,
       "volume_after_fee": "volume_currency_to_pay_after_fee": 124.68,
       "fee_eur": "amount_currency_to_trade_after_fee": 0.4975
       "fee_currency_to_pay": 0.6,
       "fee_btc": "fee_currency_to_trade": 0.0025,
       "fee_currency": 0.0025,
       "new_trade_id_for_remaining_amount": "C4Y8HD",
       "state": 1,
       "my_rating_for_trading_partner": "positive",
       "trading_partner_information":
        {
           "username":"testuser",
           "is_kyc_full": true,
           "bank_name": "sparkasse",
           "bic": "NOL12345",
           "rating": 99,
           "amount_trades": 42,
           "trust_level": "gold",
           "seat_of_bank": "DE"
        },
        "payment_method": 1,
        "created_at": "2015-01-10T15:00:00+02:00",
        "successfully_finished_at": "2015-01-10T15:00:00+02:00"
     },
   ],
   "page": {
       "current": 2,
       "last": 4
   },
   "errors": [],
   "credits": 15
}

Error

Http-Status 422

---

HTTP/1.1 200 OK
{
   "trades":
   [
     {
        "trade_id":"ETHBTC-Z86KWB",
        "is_external_wallet_trade":true,
        "trading_pair":"ethbtc",
        "type":"sell",
        "amount_currency_to_trade":"10",
        "price":"0.01900000",
        "volume_currency_to_pay":"0.19",
        "amount_currency_to_trade_after_fee":"9.95000000",
        "volume_currency_to_pay_after_fee":"0.18810000",
        "fee_currency_to_trade":"0.05000000",
        "fee_currency_to_pay":"0.00190000",
        "state":0,
        "my_rating_for_trading_partner":"pending",
        "trading_partner_information":{
           "username":"MaxUser",
           "is_kyc_full":true,
           "trust_level":"bronze",
           "amount_trades":72,
           "rating":67
        },
        "created_at":"2019-08-05T14:41:07+02:00"
     },
   ],
   "page": {
       "current": 2,
       "last": 4
   },
   "errors": [],
   "credits": 15
}

Details zu einem Trade abrufen

Credits:

3

URL-Parameter

Response

Success 200

Name	Type	Value	Notes
trade	Array		Details zum Trade (s. Tabelle Trade-Details)

Trade-Details

Name	Type	Value	Notes
trade_id	String		ID des Trades
is_external_wallet_trade	Boolean		Zeigt an ob sich der Trade auf einen "Krypto-zu-Krypto (mit eigener Wallet)" Marktplatz bezieht.
trading_pair	String		Handelspaar (s. Tabelle Handelspaare)
type	String	buy sell	Typ des Trades
amount_currency_to_trade	Float		Gekaufte/verkaufte Coin-Menge
price	Float		Preis pro Coin in Euro
volume_currency_to_pay	Float		Euro-Volumen des Trades
amount_currency_to_trade_after_fee	Float		Anzahl der Coins nach Abzug der Gebühren
volume_currency_to_pay_after_fee	Float		Euro-Volumen des Trades nach Abzug der Gebühren
fee_currency_to_pay	Float		Gebühr in Euro
fee_currency_to_trade	Float		Gebühr in Kryptowährung des jeweiligen Handelspaars
new_order_id_for_remaining_amount OPTIONAL	String		ID des neuen Angebots, das automatisch für die verbleibende Coin-Menge erstellt wurde.
state	Integer	-1 0 1	Aktueller Status (s. Tabelle Possible Trade-State-Values)
is_trade_marked_as_paid	Boolean		Zeigt an, ob der Trade als "bezahlt" markiert wurde.
trade_marked_as_paid_at OPTIONAL	String		Format gemäß RFC 3339 (Bsp: 2015-01-20T15:00:00+02:00)
my_rating_for_trading_partner	String	pending negative neutral positive	Abgegebene Bewertung für den Handelspartner
trading_partner_information	Array		Details über den Handelspartner (s. Tabelle Trading Partner Information)
created_at	String		Erstellzeitpunkt des Trades. Format gemäß RFC 3339 (Bsp: 2015-01-20T15:00:00+02:00)
successfully_finished_at OPTIONAL	String		Nur bei Trade-Status 1 (Successful). Format gemäß RFC 3339 (Bsp: 2015-01-20T15:00:00+02:00)
cancelled_at OPTIONAL	String		Nur bei Trade-Status -1 (Cancelled). Format gemäß RFC 3339 (Bsp: 2015-01-20T15:00:00+02:00)
payment_method	Integer	1 2 3	s. Tabelle Possible payment method values

Trading Partner Information

Name	Type	Value	Notes
username	String		User-Name
is_kyc_full	Boolean		Vollständig identifizierter User
trust_level	String	bronze silver gold platin	Trust-Level
depositor OPTIONAL	String		Name des Empfängers Nur bei Trade-Status 0 (Pending)
iban OPTIONAL	String		Iban des Empfängers Nur bei Trade-Status 0 (Pending)
bank_name	String		Name der Bank
bic	String		BIC der Bank
seat_of_bank	String	Bankenländerliste	Sitz der Bank als Ländercode in ISO 3166-2
amount_trades	Integer		Anzahl bereits getätigten Trades
rating	Integer		Prozentualer Anteil an positiven Bewertungen durch die Handelspartner

Possible Trade-State-Values

Code	Reason	Note
-1	Cancelled	Der Trade wurde abgebrochen.
0	Pending	Der Trade wurde noch nicht erfolgreich abgeschlossen.
1	Successful	Der Trade wurde erfolgreich abgeschlossen.

Possible payment method values

Code	Reason	Note
1	SEPA	Der Trade wurde durch eine manuelle SEPA-Überweisung abgewickelt.
2	Express	Der Trade wurde als Express-Handel abgewickelt.
3	SEPA-Instant	Der Trade wurde durch eine manuelle SEPA-Echtzeitüberweisung abgewickelt.

Success-Response BTC / EUR:

HTTP/1.1 200 OK
{
   "trade":
   {
       "trade_id': "2EDYNS",
       "trading_pair": "btceur",
       "is_external_wallet_trade": false,
       "type": "sell",
       "amount": "amount_currency_to_trade": 0.5,
       "price": 250.55,
       "volume": "volume_currency_to_pay": 125.28,
       "volume_after_fee": "volume_currency_to_pay_after_fee": 124.68,
       "fee_eur": "amount_currency_to_trade_after_fee": 0.4975
       "fee_currency_to_pay": 0.6,
       "fee_btc": "fee_currency_to_trade": 0.0025,
       "fee_currency": 0.0025,
       "new_trade_id_for_remaining_amount": "C4Y8HD",
       "state": 1,
       "is_trade_marked_as_paid": false,
       "my_rating_for_trading_partner": "positive",
       "trading_partner_information":
        {
           "username":"testuser",
           "is_kyc_full": true,
           "depositor": "Max Musterman"
           "iban": "DE09999999999999999999"
           "bank_name": "sparkasse",
           "bic": "HASPDEHHXXX",
           "rating": 99,
           "amount_trades": 42,
           "trust_level": "gold",
           "seat_of_bank": "DE"
        },
        "payment_method": 1,
        "created_at": "2015-01-10T15:00:00+02:00",
        "successfully_finished_at": "2015-01-10T15:00:00+02:00"
   },
   "errors": [],
   "credits": 15
}

Error

Http-Status 404

---

HTTP/1.1 200 OK
{
   "trade":{
      "trade_id":"ETHBTC-Z86KWB",
      "is_external_wallet_trade":true,
      "trading_pair":"ethbtc",
      "type":"sell",
      "amount_currency_to_trade":"10",
      "price":"0.01900000",
      "volume_currency_to_pay":"0.19",
      "amount_currency_to_trade_after_fee":"9.95000000",
      "volume_currency_to_pay_after_fee":"0.18810000",
      "fee_currency_to_trade":"0.05000000",
      "fee_currency_to_pay":"0.00190000",
      "state":0,
      "my_rating_for_trading_partner":"pending",
      "trading_partner_information":{
         "username":"MaxUser",
         "is_kyc_full":true,
         "trust_level":"bronze",
         "amount_trades":72,
         "rating":67
      },
      "created_at":"2019-08-05T14:41:07+02:00"
   },
   "errors":[

   ],
   "credits":63
}

Trade als bezahlt markieren

Credits:

1

URL-Parameter

POST - Parameter

Response

Success-Response:

HTTP/1.1 200 OK
{
 "errors": [],
 "credits": 8
}

Error

Http-Status 404

Http-Status 422

---

Zahlungseingang bestätigen.

Credits:

1

URL-Parameter

POST - Parameter

Response

Success-Response:

HTTP/1.1 200 OK
{
 "errors": [],
 "credits": 8
}

Error

Http-Status 404

Http-Status 422

---

Handelspartner bewerten

Credits:

1

URL-Parameter

POST - Parameter

Response

Success-Response:

HTTP/1.1 201 OK
{
 "errors": [],
 "credits": 8
}

Error

Http-Status 404

Http-Status 422

---

Abruf von Account Infos

Credits:

2

Response

Success 200

Name	Type	Value	Notes
data	Array		Account-Infos (s. Tabelle Data)

Data

Name	Type	Value	Notes
balances	Array		Auflistung aller Balances (am Beispiel BTC s. Tabelle Kryptowährung)
fidor_reservation OPTIONAL	Array		Infos zur ggfs. vorhandenen Fidor-Reservierung (s. Tabelle Fidor-Reservation)
encrypted_information	Array		Verschlüsselte Infos (s. Tabelle Encrypted-Information¹)

Kryptowährung

Name	Type	Value	Notes
btc	Array		Infos zur BTC-Balance (Aufbau s. Tabelle BTC)

BTC

Name	Type	Value	Notes
total_amount	String		Aktuelles BTC-Guthaben
available_amount	String		Aktuell verfügbares BTC-Guthaben
reserved_amount	String		Aktuell reserviertes BTC-Guthaben

Fidor-Reservation

Name	Type	Value	Notes
total_amount	Float		Gesambetrag der Reservierung
available_amount	Float		Aktuell verfügbarer Betrag der Reservierung
reserved_at	String		Erstelldatum der Reservierung (Format: 2015-04-07T12:23:04+02:00 gemäß RFC 3339
valid_until	String		Reservierung gültig bis (Format: 2015-04-07T12:23:04+02:00 gemäß RFC 3339)
allocation	String		Prozentuale Aufteilung des verfügbaren Betrags der Reservierung (am Beispiel BCH s. Tabelle Prozentuale Aufteilung)

Prozentuale Aufteilung

Name	Type	Value	Notes
bch	String		Infos zur BCH-Aufteilung (Aufbau s. Tabelle BCH)

BCH

Name	Type	Value	Notes
percent	String		Prozentuale Aufteilung der noch verfügbaren Reservierung
max_eur_volume	String		Max. Betrag zur Hervorhebung von Kaufanfragen
eur_volume_open_orders	String		Akt. verwendeter Betrag zur Hervorhebung von Kaufanfragen

Encrypted-Information¹

Name	Type	Value	Notes
bic_short OPTIONAL	String		Verschlüsselte Bankengruppe aus der BIC (ersten 4 Zeichen)
bic_full OPTIONAL	String		Verschlüsselte komplette BIC
uid	String		Verschlüsselte eigene User-Id

¹Diese Informationen können zum Abgleich von Angebots-Bedingungen genutzt werden, wenn die Websocket-API genutzt wird, um über neue Angebote informiert zu werden (s. Kapitel Websocket-API).

Success-Response:

HTTP/1.1 200 OK
{
 "data":
 {
     "balances":
     {
         "btc":
         {
             "available_amount": "19",
             "reserved_amount":"1.3",
             "total_amount": "20.3"
         },
         "bch":
         {
             "available_amount": "5",
             "reserved_amount":"2.5",
             "total_amount": "7.5"
         },
         "eth":
         {
             "available_amount": "10",
             "reserved_amount":"2.5",
             "total_amount": "12.5"
         }
     },
     "fidor_reservation":
     {
         "total_amount": 500,
         "available_amount": 235.55,
         "reserved_at": "2017-10-05T08:31:23+02:00",
         "valid_until": "2017-10-06T08:31:23+02:00",
         "allocation":
         {
             "btc":
             {
                 "percent": 50,
                 "max_eur_volume": 500,
                 "eur_volume_open_orders": 0
             },
             "eth":
             {
                 "percent": 0,
                 "max_eur_volume": 0,
                 "eur_volume_open_orders": 0
             },
             "bch":
             {
                 "percent": 50,
                 "max_eur_volume": 500,
                 "eur_volume_open_orders": 0
             },
         }
     },
     "encrypted_information":
     {
         "bic_short": "sdf..",
         "bic_full": "sdfiojf..",
         "uid": "Fijsdf3lksjdf.."
     },
 },
 "errors": [],
 "credits": 12
}

---

Kauf- und Verkaufsangebote (bids und asks) in kompakter Form.

Credits:

3

URL-Parameter

Response

Success 200

Name	Type	Value	Notes
trading_pair	String		Handelspaar (s. Tabelle Handelspaare)
orders	Array		Array mit Bids / Asks

Orders

Name	Type	Value	Notes
bids	Array		Auflistung der Bids
asks	Array		Auflistung der Asks

Bids

Name	Type	Value	Notes
price	Float		Preis pro Coin
amount_currency_to_trade	Float		Anzahl Coins

Asks

Name	Type	Value	Notes
price	Float		Preis pro Coin
amount_currency_to_trade	Float		Anzahl Coins

Success-Response:

HTTP/1.1 200 OK
{
     "trading_pair":"btceur",
     "orders":{
         "bids": [
             {
                 "price":200,
                 "amount":0."amount_currency_to_trade":0.2
             },
             {
                 "price":205,
                 "amount":1
"amount_currency_to_trade":1
             },
         ],
         "asks": [
             {
                 "price":250,
                 "amount":0."amount_currency_to_trade":0.2
             },
             {
                 "price":265.07,
                 "amount":0."amount_currency_to_trade":0.3102676
             },
          ]
     },

     "errors":[],
     "credits":19
}

---

Erfolgreich abgeschlossene Trades. Wenn kein Parameter gesetzt wird, werden alle erfolgreich abgeschlossenen Trades der letzten 24 Stunden zurückgeliefert. Die Liste ist absteigend nach Datum sortiert.

Credits:

3

URL-Parameter

GET - Parameter

Response

Success 200

Name	Type	Value	Notes
trading_pair	string		Handelspaar (s. Tabelle Handelspaare)
trades	Array		Erfolgreich abgeschlossene Trades

Trades

Name	Type	Value	Notes
0	Array		s. Tabelle Trade Informationen

Trade Informationen

Name	Type	Value	Notes
date	Integer		Datum (Unixtimestamp)
price	Float		Preis pro Coin
amount_currency_to_trade	Float		Anzahl Coins
tid	Integer		Eindeutige ID

Success-Response:

HTTP/1.1 200 OK
{
     "trading_pair":"btceur",
     "trades":[
         {
             "date":1435922625,
             "price":230,
             "amount":"2."amount_currency_to_trade":"2.50000000",
             "tid":1252020
         },
         {
             "date":1435922655,
             "price":200.1,
             "amount":"0."amount_currency_to_trade":"0.60000000",
             "tid":1252023
         }
     ],
     "errors":[],
     "credits":19
}

---

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

Credits:

3

URL-Parameter

Response

Success 200

Name	Type	Value	Notes
trading_pair	string		Handelspaar (s. Tabelle Handelspaare)
rates	Array		Rate-Infos (s. Tabelle Rates)

Rates

Name	Type	Value	Notes
rate_weighted	String		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.
rate_weighted_3h	String		Durchschnittskurs der letzten 3 Stunden
rate_weighted_12h	String		Durchschnittskurs der letzten 12 Stunden

Success-Response:

HTTP/1.1 200 OK
{
    "trading_pair":"btceur",
    "rates":{
          "rate_weighted":"257.3999269",
          "rate_weighted_3h":"258.93994247",
          "rate_weighted_12h":"255.30363219"
     },
     "errors":[],
     "credits":19
}

---

HTTP/1.1 200 OK
{
    "trading_pair":"dashbtc",
    "rates":{
          "rate_weighted":"0.01999269",
     },
     "errors":[],
     "credits":19
}

Abruf des Kontoauszuges
Bitte beachten Sie, dass im Kontoauzug nur Transaktionen aufgelistet werden, die bis zum Vortag ausgeführt wurden. Transaktionen von heute sind also erst morgen im Kontoauszug aufgeführt.

Credits:

3

URL-Parameter

GET - Parameter

Response

Success 200

Name	Type	Value	Notes
account_ledger	Array		Details zur Position (s. Tabelle Details zur Position)
page	Array		Informationen zu den möglichen Ergebnisseiten (s. Tabelle Page-Details)

Details zur Position

Name	Type	Value	Notes
date	String		Buchungsdatum (Format: 2015-04-07T12:23:04+02:00 gemäß RFC 3339)
type	String		Typ der Position
reference	String		Referenz zu der Position (trade_id bei buy/sell oder txid bei einer Einzahlung/Auszahlung)
trade OPTIONAL	Array		Tradedetails (nur bei Typ sell/buy) (s. Tabelle Tradedetails)
cashflow	String		Zu- / Abgang
balance	String		Kontostand

Tradedetails

Name	Type	Value	Notes
trade_id	String		ID des Trades
trading_pair	String		Handelspaar (s. Tabelle Handelspaare)
price	String		Preis pro Coin
is_external_wallet_trade	Boolean		Zeigt an ob sich der Trade auf einen "Krypto-zu-Krypto (mit eigener Wallet)" Marktplatz bezieht.
currency_to_trade	Array		(Krypto) Währung-Summen (s. Tabelle Currency to trade)
currency_to_pay	Array		(Krypto) Währung-Summen (s. Tabelle Currency to pay)

Currency to trade

Name	Type	Value	Notes
currency	String		(Krypto) Währung
before_fee	String		Summe vor Gebühr
after_fee	String		Summe nach Gebühr

Currency to pay

Name	Type	Value	Notes
currency	String		(Krypto) Währung
before_fee	String		Summe vor Gebühr
after_fee	String		Summe nach Gebühr

Page Details

Name	Type	Value	Notes
current	Integer		Aktuell zurückgelieferte Seite
last	Integer		Letzte verfügbare Seite zu den Suchkriterien

Success-Response:

HTTP/1.1 200 OK
{
   "account_ledger":[
         {
             "date":"2015-08-13T10:20:27+02:00",
             "type":"sell",
             "reference":"NVP39U",
             "trade":{
                     "trade_id":"NVP39U",
                     "trading_pair":"btceur",
                     "price":"243.77",
                     "primary_currency":{
"currency_to_trade":{
                             "currency":"btc",
                             "before_fee":"1.71600000",
                             "after_fee":"1.69884000"
                      },
                     "secondary_currency":{
"currency_to_pay":{
                             "currency":"eur",
                             "before_fee":"418,31",
                             "after_fee":"414,13"
                     }
             },
             "cashflow":"-1.71600000",
             "balance":"3.00019794"
         },
         {
             "date":"2015-08-12T13:05:02+02:00",
             "type":"payout",
             "reference":"dqwdqwdwqwq4dqw4d5qd45qd45qwd4qw5df45g4r5g4trh4r5j5j4tz5j4tbc",
             "cashflow":"-0.10000000",
             "balance":"4.71619794"
         },
         {
             "date":"2015-08-12T12:30:01+02:00",
             "type":"payout",
             "reference":"bdgwflwguwgr884t34g4g555h4zr5j4fh5j48rg4s5bx2nt4jr5jr45j4r5j4",
             "cashflow":"-1.91894200",
             "balance":"4.81619794"
         },
         {
             "date":"2015-08-10T12:12:41+02:00",
             "type":"buy",
             "reference":"HCRBEL",
             "trade":{
                     "trade_id":"HCRBEL",
                     "price":"244",
                     "btc":{
                             "before_fee":"0.55676560",
                             "after_fee":"0.55119794"
                     },
                     "euro":{
                             "before_fee":"135,85",
                             "after_fee":"134,49"
                     }
             },
             "cashflow":"0.55119794",
             "balance":"6.73513994"
         }
   ],
   "page":{
         "current":1,
         "last":1
   },
   "errors":[

   ],
   "credits":9
}

---

Liefert alle Aktionen, für die der für die Anfrage genutzte Api-Key freigeschaltet ist.

Credits:

2

Response

Success-Response:

HTTP/1.1 200 OK
{
 "permissions": [
     "showOrderbook",
     "createOrder",
     "executeTrade",
     "showPermissions",
  ],
 "errors": [],
 "credits": 5
}

---

Anlegen einer neuen Auszahlung

URL-Parameter

POST - Parameter

Response

Success 200

Name	Type	Value	Notes
withdrawal_id	Integer		Auszahlungs-ID

Location-Header

Sofern die Details zu der neu angelegten Auszahlung abgerufen werden sollen, kann der hier im Location-Header enthaltene URI verwendet werden, der auf die API-Methode "showWithdrawal" der konkreten Auszahlung zeigt.

https://api.bitcoin.de/v4/:currency/withdrawals/:withdrawal_id

Success-Response:

HTTP/1.1 201 Created
{
 "withdrawal_id": 123413,
 "errors": [],
 "credits": 8
}

Error

Http-Status 422

---

Ermöglicht das Abbrechen einer Auszahlung, sofern die Auszahlungsanforderung vom System noch nicht prozessiert wurde

URL-Parameter

Response

Success-Response:

HTTP/1.1 200 OK
{
 "errors": [],
 "credits": 8
}

Error

Http-Status 403

Http-Status 404

Http-Status 422

---

Details einer Auszahlung abrufen

URL-Parameter

Response

Success 200

Name	Type	Value	Notes
withdrawal	Array		Details zur Auszahlung

Withdrawal

Name	Type	Value	Notes
withdrawal_id	String		Auszahlungs-Id
address	String		Coin-Empfänger-Adresse
recipient_purpose OPTIONAL	String		Verwendungszweck für die Auszahlung (s. Unterstützung der Option "recipient_purpose")
amount	Float		Coin-Auszahlbetrag
network_fee	Float		Netzwerkgebühr im jeweiligen Coin
comment	String		Kommentar zur Auszahlung (nur auf bitcoin.de einsehbar)
created_at	String		Anforderungszeitpunkt der Auszahlung (Format: 2015-04-07T12:23:04+02:00 gemäß RFC 3339)
state	Integer	-1 0 1	Aktueller Status der Auszahlung (s. Tabelle Possible Withdrawal-State-Values)
transferred_at	String		Zeitpunkt an dem die Auszahlung ausgeführt wurde (Format: 2015-04-07T12:23:04+02:00 gemäß RFC 3339)
txid	String		Transaktions-Id, falls die Auszahlung ausgeführt wurde

Possible Withdrawal-State-Values

Code	Reason	Note
-1	Cancelled	Die Auszahlung wurde abgebrochen
0	Pending	Die Auszahlung wurde noch nicht ausgeführt.
1	Transferred	Die Auszahlung wurde ausgeführt.

Success-Response:

HTTP/1.1 200 OK
{
 "withdrawal": {
      "withdrawal_id": "123",
      "address": "123sdfasdiojf3434",
      "recipient_purpose": "123",
      "amount": 12.54202,
      "network_fee": 0.01,
      "comment": "Bitpay",
      "created_at": "2015-03-22T11:36:41+02:00",
      "state": 1,
      "transferred_at": "2015-03-22T11:45:23+02:00",
      "txid": "sdofji234oijsdfiojdsij2"
 },
 "errors": [],
 "credits": 8
}

Error

Http-Status 404

Http-Status 422

---

Aktuelle Mindest-Netzwerkgebühr für eine Auszahlung anzeigen

URL-Parameter

Response

Success 200

Name	Type	Value	Notes
min_network_fee	String		Die aktuelle Mindest-Netzwerkgebühr für eine Auszahlung

Success-Response:

HTTP/1.1 200 OK
{
 "min_network_fee": "0.000035",
 "errors": [],
 "credits": 8
}

Error

Http-Status 422

---

Abrufen von Auszahlungen

URL-Parameter

GET - Parameter

Response

Success 200

Name	Type	Value	Notes
withdrawals	Array		Max. 10 Auszahlungen mit ihren Details (s. Tabelle Withdrawal)
page	Array		Informationen zu den möglichen Ergebnisseiten

Page

Name	Type	Value	Notes
current	Integer		Aktuell zurückgelieferte Seite
last	Integer		Letzte verfügbare Seite

Success-Response:

HTTP/1.1 200 OK
{
  "withdrawals": [
     {
         "withdrawal_id": "123",
         "address": "123sdfasdiojf3434",
         "recipient_purpose": "123",
         "amount": 12.54202,
         "network_fee": 0.01,
         "comment": "Bitpay",
         "created_at": "2015-03-22T11:36:41+02:00",
         "state": 1,
         "transferred_at": "2015-03-22T11:45:23+02:00",
         "txid": "sdofji234oijsdfiojdsij2"
     },
     {
         "withdrawal_id": "234",
         "address": "234sdfasdiojf3434",
         "recipient_purpose": "234",
         "amount": 0.25,
         "network_fee": 0,
         "comment": "Börse",
         "created_at": "2015-03-23T16:22:41+02:00",
         "state": -1,
         "transferred_at": NULL,
         "txid": NULL
     }
  ],
   "page": {
       "current": 1,
       "last": 3
   },
  "errors": [],
  "credits": 8
}

Error

Http-Status 422

---

Abfrage von Auszahlungsadressen für eine Währung

URL-Parameter

GET - Parameter

Response

Success 200

Name	Type	Value	Notes
outgoing_address	Array		Max. 10 Auszahlungsadressen mit ihren Details
page	Array		Werte des Pager

Page

Name	Type	Value	Notes
current	Integer		Aktuell zurückgelieferte Seite
last	Integer		Letzte verfügbare Seite

Success-Response:

HTTP/1.1 200 OK
{
    "outgoing_address": {
        {
            "address_id": 7411,
            "recipient_address": "0xc562be8f6893e0cc796a19e42dccf0ed7ea1d5d4",
            "comment":  "Mein Self-Hosted Wallet"
        },
        {
            "address_id": 4909,
            "recipient_address": "0xc562ccddeeffa19e42dcca19e42dcca19e42dcc",
            "recipient_purpose": "123",
            "comment":  "Mein Wallet bei Börse XY"
         },
         {
            "address_id": 7910,
            "recipient_address": "0xc562ccddeea19e42dcca19e42dcca19e42dccff",
            "recipient_purpose": "150",
            "comment":  "Peters Wallet bei Börse ABC"
         },
     },
     "page": {
        "current": 1,
        "last": 2
     },
     "errors":{},
     "credits":19
}

---

Unbenutzte Einzahladresse abrufen

URL-Parameter

POST - Parameter

Response

Success 200

Name	Type	Value	Notes
address	String		Bereits zuvor angelegte aber noch unbenutzte Einzahladresse zurückgeliefert
recipient_purpose OPTIONAL	String		Verwendungszweck, der bei einer Einzahlung mit angegeben werden muss (s. Unterstützung der Option "recipient_purpose")

Success 201

Response

Name	Type	Value	Notes
address	String		Neu erstellte Einzahladresse
recipient_purpose OPTIONAL	String		Verwendungszweck, der bei einer Einzahlung mit angegeben werden muss (s. Unterstützung der Option "recipient_purpose")

Success-Response:

HTTP/1.1 200 OK
{
   "address": "123sdfasdiojf3434",
   "recipient_purpose": 123,
   "errors": [],
   "credits": 8
}

Error

Http-Status 422

---

Details einer Einzahlung abrufen

URL-Parameter

Response

Success 200

Name	Type	Value	Notes
deposit	Array		Details zur Einzahlung

Deposit

Name	Type	Value	Notes
deposit_id	Integer		Einzahlungs-Id
address	String		Coin-Adresse, welche die Einzahlung empfängt
recipient_purpose OPTIONAL	String		Verwendungszweck welcher der Einzahladresse zugeordnet ist (s. Unterstützung der Option "recipient_purpose")
amount	Float		Coin-Betrag
state	Integer	-1 0 1 2	Aktueller Status der Einzahlung (s. Tabelle Possible Deposit-State-Values)
txid	String		Transaktions-Id der Einzahlung
confirmations	Integer		Bestätigungsanzahl der Transaktion. Die Bestätigungsanzahl wird im state=2 (Fully confirmed) nicht weiter aktualisiert!
created_at	String		Zeitpunkt an dem die Einzahlung im Netzwerk des zugehörigen Coins verzeichnet wurde (Format: 2015-04-07T12:23:04+02:00 gemäß RFC 3339)

Possible Deposit-State-Values

Code	Reason	Note
-1	Invalid	Die Einzahlung ist ungültig
0	Unconfirmed	Die Einzahlung befindet sich noch im Mempool und wurde bisher in keinen Block aufgenommen.
1	Partially confirmed	Die Einzahlung verfügt entweder über noch zu wenig Bestätigungen, weshalb sie noch dem unbestätigten Coin-Guthaben zugeordnet wird oder weißt zwar bereits ausreichend Bestätigungen auf, befindet sich aber noch in
Bearbeitung.
2	Fully confirmed	Die Einzahlung verfügt über ausreichend Bestätigungen, wurde erfolgreich bearbeitet und dem bestätigten Coin-Guthaben gutgeschrieben.

Success-Response:

HTTP/1.1 200 OK
{
   "deposit": {
      "deposit_id": 123,
      "address":"134oisjdfijfj",
      "recipient_purpose":"123",
      "amount": 12.54202,
      "state": 1,
      "txid": "sdofji234oijsdfiojdsij2",
      "confirmations": 3
3,
      "created_at": "2020-01-08T11:36:41+02:00"
   },
   "errors": [],
   "credits": 8
}

Error

Http-Status 404

Http-Status 422

---

Abrufen von Einzahlungen

URL-Parameter

GET - Parameter

Response

Success 200

Name	Type	Value	Notes
deposits	Array		Max. 10 Einzahlungen mit ihren Details (s. Tabelle Deposit)

Success-Response:

HTTP/1.1 200 OK
{  "deposits": {
   "deposits":
   [
      {
         "deposit_id": "123",
         "address": "123qwertzasdfgyxcv123",
         "recipient_purpose": "123",
         "amount": 2.14578,
         "state": 1,
         "txid": "hueqbfuzacoevewoubwevbweivb2iur3feicie323535",
         "confirmations": 3
3,
         "created_at": "2020-01-08T11:36:41+02:00"
      },
      {
         "deposit_id": "234",
         "address": "234qwertzasdfgyxcv234",
         "recipient_purpose": "234",
         "amount": 0.01478,
         "state": 0,
         "txid": "drqdu73833223zug28f2fb2798fhb23ufi23zbf9723fh"
         "drqdu73833223zug28f2fb2798fhb23ufi23zbf9723fh",
         "confirmations": 0
0,
         "created_at": "2020-01-09T11:36:41+02:00"
      },
   ],
   "page": {
       "current": 1,
       "last": 3
   },
   "errors": [],
   "credits": 5
}

Error

Http-Status 422

---