Historie der abgeschlossenen Bestellungen
get
https://api.cryptomus.com/v2/user-api/exchange/orders/history
Anfrage
Abfrageparameter
Name | Parametertyp | Definition |
---|---|---|
market | string | Nach Handelspaar filtern (z. B. „TRX_USDT“) |
direction | string | Nach Richtung filternVerfügbare Optionen:• buy• sell |
order_id | string | Filtern Sie nach Order-ID im Orderbuch |
client_order_id | string | Nach Kundenauftrags-ID filtern |
limit | string | Ein spezieller Parameter, der die maximale Anzahl von Datensätzen festlegt, die die Anfrage zurückgibt |
offset | string | Ein spezieller Parameter, der die Anzahl der zu überspringenden Datensätze angibt |
Parametertyp
stringDefinition
Nach Handelspaar filtern (z. B. „TRX_USDT“)Parametertyp
stringDefinition
Nach Richtung filternVerfügbare Optionen:- buy- sellParametertyp
stringDefinition
Filtern Sie nach Order-ID im OrderbuchParametertyp
stringDefinition
Nach Kundenauftrags-ID filternParametertyp
stringDefinition
Ein spezieller Parameter, der die maximale Anzahl von Datensätzen festlegt, die die Anfrage zurückgibtParametertyp
stringDefinition
Ein spezieller Parameter, der die Anzahl der zu überspringenden Datensätze angibt
Antwort
Bestellantwortparameter
Name | Definition |
---|---|
id | Order-ID im Orderbuch |
type | AuftragsartVerfügbare Optionen:• buy• sell |
direction | BestellrichtungVerfügbare Optionen:• buy• sell |
symbol | Nach Handelspaar filtern (z. B. „TRX_USDT“) |
quantity | Angeforderte Menge des Basis-Assets |
filledQuantity | Gefüllte Menge des Basis-Assets |
filledValue | Gefüllte Menge des Angebots-Assets |
state | Aktueller Status der Bestellung (z. B. „abgeschlossen“) |
internalState | Interner Status der Bestellung (z. B. „ausgeführt“) |
createdAt | Zeitpunkt, zu dem die Bestellung erstellt wurde |
finishedAt | Zeitpunkt, zu dem die Bestellung abgeschlossen wurde |
stopLossPrice | Der Schwellenmarktpreis des Vermögenswerts, bei dessen Erreichen die Bestellung automatisch storniert wird |
Definition
Order-ID im OrderbuchDefinition
AuftragsartVerfügbare Optionen:- buy- sellDefinition
BestellrichtungVerfügbare Optionen:- buy- sellDefinition
Nach Handelspaar filtern (z. B. „TRX_USDT“)Definition
Angeforderte Menge des Basis-AssetsDefinition
Gefüllte Menge des Basis-AssetsDefinition
Gefüllte Menge des Angebots-AssetsDefinition
Aktueller Status der Bestellung (z. B. „abgeschlossen“)Definition
Interner Status der Bestellung (z. B. „ausgeführt“)Definition
Zeitpunkt, zu dem die Bestellung erstellt wurdeDefinition
Zeitpunkt, zu dem die Bestellung abgeschlossen wurdeDefinition
Der Schwellenmarktpreis des Vermögenswerts, bei dessen Erreichen die Bestellung automatisch storniert wird
Deal-Response-Parameter
Name | Definition |
---|---|
id | Handels-ID |
state | Handelsstatus (z. B. „abgeschlossen“) |
createdAt | Zeitpunkt, zu dem der Handel erstellt wurde |
completedAt | Zeitpunkt, zu dem der Handel abgeschlossen wurde |
averageFilledPrice | Durchschnittlicher erfüllter Preis für den Handel |
Definition
Handels-IDDefinition
Handelsstatus (z. B. „abgeschlossen“)Definition
Zeitpunkt, zu dem der Handel erstellt wurdeDefinition
Zeitpunkt, zu dem der Handel abgeschlossen wurdeDefinition
Durchschnittlicher erfüllter Preis für den Handel
Antwortparameter für Geschäftstransaktionen
Name | Definition |
---|---|
id | Transaktions-ID |
tradeRole | Rolle im HandelVerfügbare Optionen:• taker• maker |
filledPrice | Ausgefüllter Preis für die Transaktion |
filledQuantity | Ausgeführter Betrag in der Basiswährung |
filledValue | Ausgeführter Betrag in der Kurswährung |
fee | Transaktionsgebühr |
feeCurrency | Währung, in der die Gebühr berechnet wird |
committedAt | Zeitpunkt der Transaktionsausführung |
Definition
Transaktions-IDDefinition
Rolle im HandelVerfügbare Optionen:- taker- makerDefinition
Ausgefüllter Preis für die TransaktionDefinition
Ausgeführter Betrag in der BasiswährungDefinition
Ausgeführter Betrag in der KurswährungDefinition
TransaktionsgebührDefinition
Währung, in der die Gebühr berechnet wirdDefinition
Zeitpunkt der Transaktionsausführung
Antwortbeispiel
1{
2 "result": [
3 {
4 "id": "01JEXAPY04JDFBVFC2D23BCKMK",
5 "type": "market",
6 "direction": "sell",
7 "symbol": "TRX_USDT",
8 "quantity": "67.5400000000000000",
9 "filledQuantity": "67.5400000000000000",
10 "filledValue": "20.0053480000000000",
11 "state": "completed",
12 "internalState": "filled",
13 "createdAt": "2024-12-12 11:40:19",
14 "finishedAt": "2024-12-12 11:40:21",
15 "deal": {
16 "id": "01JEXAPZ9C9TWENPFZJASZ1YD2",
17 "state": "completed",
18 "createdAt": "2024-12-12 11:40:21",
19 "completedAt": "2024-12-12 11:40:21",
20 "averageFilledPrice": "0.2962000000000000",
21 "transactions": [
22 {
23 "id": "01JEXAPZ9C9TWENPFZJASZ1YD3",
24 "tradeRole": "taker",
25 "filledPrice": "0.2962000000000000",
26 "filledQuantity": "67.5400000000000000",
27 "filledValue": "20.0053480000000000",
28 "fee": "0.0000000000000000",
29 "feeCurrency": "USDT",
30 "committedAt": "2024-12-12 11:40:21"
31 }
32 ]
33 }
34 },
35 {
36 "id": "01JEXAJDK51C453Z3395RTAY8Y",
37 "type": "market",
38 "direction": "buy",
39 "symbol": "TRX_USDT",
40 "value": "20.0000000000000000",
41 "filledQuantity": "67.5400000000000000",
42 "filledValue": "19.9985940000000000",
43 "state": "completed",
44 "internalState": "filled",
45 "createdAt": "2024-12-12 11:37:51",
46 "finishedAt": "2024-12-12 11:37:53",
47 "deal": {
48 "id": "01JEXAJF41RJ05Z220F2H01S9Z",
49 "state": "completed",
50 "createdAt": "2024-12-12 11:37:53",
51 "completedAt": "2024-12-12 11:37:53",
52 "averageFilledPrice": "0.2961000000000000",
53 "transactions": [
54 {
55 "id": "01JEXAJF4ADPPPVH3NVP2SFX0F",
56 "tradeRole": "taker",
57 "filledPrice": "0.2961000000000000",
58 "filledQuantity": "67.5400000000000000",
59 "filledValue": "19.9985940000000000",
60 "fee": "0.0000000000000000",
61 "feeCurrency": "TRX",
62 "committedAt": "2024-12-12 11:37:53"
63 }
64 ]
65 }
66 },
67 {
68 "id": "01JEXAFCCC5ZVJPZAAHHDKQBNG",
69 "type": "limit",
70 "direction": "sell",
71 "symbol": "TRX_USDT",
72 "price": "0.2964000000000000",
73 "quantity": "20.0000000000000000",
74 "value": "5.9280000000000000",
75 "filledQuantity": "20.0000000000000000",
76 "filledValue": "5.9280000000000000",
77 "state": "completed",
78 "internalState": "filled",
79 "createdAt": "2024-12-12 11:36:12",
80 "finishedAt": "2024-12-12 11:36:22",
81 "deal": {
82 "id": "01JEXAFP50QGFS8CGY2YRR5EDV",
83 "state": "completed",
84 "createdAt": "2024-12-12 11:36:22",
85 "completedAt": "2024-12-12 11:36:22",
86 "averageFilledPrice": "0.2964000000000000",
87 "transactions": [
88 {
89 "id": "01JEXAFP55H5XHF3SHRVCEQ1G9",
90 "tradeRole": "taker",
91 "filledPrice": "0.2964000000000000",
92 "filledQuantity": "20.0000000000000000",
93 "filledValue": "5.9280000000000000",
94 "fee": "0.0000000000000000",
95 "feeCurrency": "USDT",
96 "committedAt": "2024-12-12 11:36:22"
97 }
98 ]
99 }
100 }
101 ]
102}
103
KOPIERENMögliche Codes
404: Benutzer oder Ressource nicht gefunden
422: Ungültige Eingabedaten
500: Interner Serverfehler
Mögliche Kombinationen
Name | Definition | internal_state |
---|---|---|
completed | Die Bestellung ist abgeschlossen und vollständig ausgefüllt | gefüllt |
canceled | Die Bestellung wurde nicht ausgeführt und vom Benutzer storniert | leer |
canceled_by_stop_loss | Die Order wurde nicht ausgeführt und automatisch storniert, da der Markt den stop_loss preis erreichte | leer |
canceled | Die Bestellung wurde teilweise ausgeführt und dann vom Benutzer storniert | teilweise_gefüllt |
canceled_by_stop_loss | Die Order wurde teilweise ausgeführt und dann automatisch storniert, da der Markt den stop_loss preis erreichte | teilweise_gefüllt |
Definition
Die Bestellung ist abgeschlossen und vollständig ausgefülltDefinition
Die Bestellung wurde nicht ausgeführt und vom Benutzer storniertDefinition
Die Order wurde nicht ausgeführt und automatisch storniert, da der Markt den stop_loss preis erreichteDefinition
Die Bestellung wurde teilweise ausgeführt und dann vom Benutzer storniertDefinition
Die Order wurde teilweise ausgeführt und dann automatisch storniert, da der Markt den stop_loss preis erreichte
Mögliche Fehler
Beispielantworten:
1{
2 "state": 0,
3 "message": "Standard validation error"
4}
KOPIERENAntwortbeispiel mit Fehler
1{
2 "code": 0,
3 "message": "Validation failed.",
4 "errors": [
5 {
6 "property": "direction",
7 "value": "sells",
8 "message": "The value you selected is not a valid choice."
9 }
10 ]
11}
KOPIEREN