API REFERENCE
FX-Auftrag abfragen
Diese API fragt Informationen zu einem FX-Auftrag ab.
Nachdem ein FX-Auftrag erstellt und ausgeführt wurde, verwenden Sie diese API, um seinen aktuellen Status, Ausführungsinformationen und zugehörige Transaktionsdetails abzufragen.
Verwenden Sie bitte ein dediziertes Konto.
user=040268
| Parameter | Typ | Beschreibung | Erforderlich |
|---|---|---|---|
| user | String | Händlerbezogenes UID | Erforderlich |
| sign | String | Signature | Erforderlich |
| method | String | v3.QueryFXOrder | Erforderlich |
| time | Long | Timestamp | Erforderlich |
- Parameter
| Parameter | Typ | Beschreibung | Erforderlich |
|---|---|---|---|
| trade_id | String | Kurs-ID | Erforderlich |
| request_id | String | Eindeutige Anfrage-ID; empfohlen wird eine Kombination aus mindestens 24 Ziffern und Buchstaben | Erforderlich |
Signaturbeispiel:
Die sortierten Parameter werden zu einer URL-ähnlichen Abfragezeichenfolge verkettet.
"method=v3.QueryFXOrder&request_id=20304095064069023960369q-11&time=1546588959&trade_id=6e5cf660fb58455cd68a413a8249061a&user=040268"
Signieren Sie stringA mit secret_key.
Die resultierende Signatur lautet:
"YOUR_SIGNATURE"
Anfragebeispiel:
{
"user": "040268",
"sign": "YOUR_SIGNATURE",
"method": "v3.QueryFXOrder",
"time": 1546588959,
"data": {
"trade_id": "6e5cf660fb58455cd68a413a8249061a",
"request_id": "20304095064069023960369q-11"
}
}
Antwortbeispiel:
{
"status": true,
"code": "200",
"data": {
"booking_status": "success",
"settlement_status": "settled",
"sell_currency": "GBP",
"buy_currency": "DKK",
"sold_currency": "GBP",
"sold_amount": "1.00",
"bought_currency": "DKK",
"bought_amount": "8.54",
"tenor": "TOD",
"exchange_rate": "8.544924729",
"order_id": "YOUR_ORDER_ID",
"quote_id": "83e96dc0-8f8e-48c7-9bc4-6acc1019fced",
"trade_id": "6e5cf660fb58455cd68a413a8249061a",
"reference": "YB test"
},
"message": "",
"response_id": "202603181711118835985708"
}
Weitere Informationen:
Antwortergebnis:
- Bei erfolgreichem Aufruf wird "status": true zurückgegeben.
- Bei fehlgeschlagenem Aufruf wird "status": false zurückgegeben.
Antwortcodes:
| Status | Code | Message |
|---|---|---|
| true | 200 | |
| false | -1000 | Internal error |
| false | -403 | The signature Error |
| false | -2001 | The user not exist |
| false | -3001 | Required field is missing |
| false | -4118 | Incorrect request ID |
booking_status
| Status | Beschreibung |
|---|---|
| success | Die FX-Buchungsanfrage wurde erfolgreich verarbeitet; der Auftrag wurde erstellt oder ausgeführt. |
| failed | Die Anfrage ist aufgrund eines internen Systemfehlers fehlgeschlagen. Versuchen Sie es später erneut oder wenden Sie sich an den technischen Support, wenn das Problem weiterhin besteht. |
| pending | Die Anfrage steht aus, weil die Signaturprüfung fehlgeschlagen ist. Prüfen Sie die Signaturparameter und versuchen Sie es erneut. |
| reversed | Die Anfrage konnte nicht verarbeitet werden, weil der angegebene Nutzer nicht im System vorhanden ist. |
| rolled | Die Anfrage wurde abgelehnt, weil mindestens ein erforderliches Feld in den Anforderungsparametern fehlt. |
| updated | Die angegebene Anfrage-ID ist falsch oder gehört zu keiner vorhandenen Transaktion. |
settlement_status:
| Status | Beschreibung |
|---|---|
| open | Der FX-Auftrag wurde erfolgreich erstellt und wartet auf die Abrechnung. |
| settled | Die FX-Transaktion wurde vollständig abgerechnet und die Mittel wurden gemäß der vereinbarten Laufzeit bereitgestellt. |
| pending | Der FX-Auftrag wurde erstellt, aber noch nicht vollständig abgerechnet. Dies kann etwa beim Warten auf das Abrechnungsdatum auftreten (z. B. SPOT T+2). |
| cancelled | Der FX-Auftrag wurde storniert und wird nicht abgerechnet. |