Historie der abgeschlossenen Bestellungen

get
https://api.cryptomus.com/v2/user-api/exchange/orders/history
KOPIEREN

Anfrage

Abfrageparameter

NameParametertypDefinition
marketstringNach Handelspaar filtern (z. B. „TRX_USDT“)
directionstringNach Richtung filternVerfügbare Optionen:buysell
order_idstringFiltern Sie nach Order-ID im Orderbuch
client_order_idstringNach Kundenauftrags-ID filtern
limitstringEin spezieller Parameter, der die maximale Anzahl von Datensätzen festlegt, die die Anfrage zurückgibt
offsetstringEin spezieller Parameter, der die Anzahl der zu überspringenden Datensätze angibt

Parametertyp

string

Definition

Nach Handelspaar filtern (z. B. „TRX_USDT“)

Parametertyp

string

Definition

Nach Richtung filternVerfügbare Optionen:- buy- sell

Parametertyp

string

Definition

Filtern Sie nach Order-ID im Orderbuch

Parametertyp

string

Definition

Nach Kundenauftrags-ID filtern

Parametertyp

string

Definition

Ein spezieller Parameter, der die maximale Anzahl von Datensätzen festlegt, die die Anfrage zurückgibt

Parametertyp

string

Definition

Ein spezieller Parameter, der die Anzahl der zu überspringenden Datensätze angibt

Antwort

Bestellantwortparameter

NameDefinition
idOrder-ID im Orderbuch
typeAuftragsartVerfügbare Optionen:buysell
directionBestellrichtungVerfügbare Optionen:buysell
symbolNach Handelspaar filtern (z. B. „TRX_USDT“)
quantityAngeforderte Menge des Basis-Assets
filledQuantityGefüllte Menge des Basis-Assets
filledValueGefüllte Menge des Angebots-Assets
stateAktueller Status der Bestellung (z. B. „abgeschlossen“)
internalStateInterner Status der Bestellung (z. B. „ausgeführt“)
createdAtZeitpunkt, zu dem die Bestellung erstellt wurde
finishedAtZeitpunkt, zu dem die Bestellung abgeschlossen wurde
stopLossPriceDer Schwellenmarktpreis des Vermögenswerts, bei dessen Erreichen die Bestellung automatisch storniert wird

Definition

Order-ID im Orderbuch

Definition

AuftragsartVerfügbare Optionen:- buy- sell

Definition

BestellrichtungVerfügbare Optionen:- buy- sell

Definition

Nach Handelspaar filtern (z. B. „TRX_USDT“)

Definition

Angeforderte Menge des Basis-Assets

Definition

Gefüllte Menge des Basis-Assets

Definition

Gefüllte Menge des Angebots-Assets

Definition

Aktueller Status der Bestellung (z. B. „abgeschlossen“)

Definition

Interner Status der Bestellung (z. B. „ausgeführt“)

Definition

Zeitpunkt, zu dem die Bestellung erstellt wurde

Definition

Zeitpunkt, zu dem die Bestellung abgeschlossen wurde

Definition

Der Schwellenmarktpreis des Vermögenswerts, bei dessen Erreichen die Bestellung automatisch storniert wird

Deal-Response-Parameter

NameDefinition
idHandels-ID
stateHandelsstatus (z. B. „abgeschlossen“)
createdAtZeitpunkt, zu dem der Handel erstellt wurde
completedAtZeitpunkt, zu dem der Handel abgeschlossen wurde
averageFilledPriceDurchschnittlicher erfüllter Preis für den Handel

Definition

Handels-ID

Definition

Handelsstatus (z. B. „abgeschlossen“)

Definition

Zeitpunkt, zu dem der Handel erstellt wurde

Definition

Zeitpunkt, zu dem der Handel abgeschlossen wurde

Definition

Durchschnittlicher erfüllter Preis für den Handel

Antwortparameter für Geschäftstransaktionen

NameDefinition
idTransaktions-ID
tradeRoleRolle im HandelVerfügbare Optionen:takermaker
filledPriceAusgefüllter Preis für die Transaktion
filledQuantityAusgeführter Betrag in der Basiswährung
filledValueAusgeführter Betrag in der Kurswährung
feeTransaktionsgebühr
feeCurrencyWährung, in der die Gebühr berechnet wird
committedAtZeitpunkt der Transaktionsausführung

Definition

Transaktions-ID

Definition

Rolle im HandelVerfügbare Optionen:- taker- maker

Definition

Ausgefüllter Preis für die Transaktion

Definition

Ausgeführter Betrag in der Basiswährung

Definition

Ausgeführter Betrag in der Kurswährung

Definition

Transaktionsgebühr

Definition

Währung, in der die Gebühr berechnet wird

Definition

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      
KOPIEREN

Mögliche Codes

404: Benutzer oder Ressource nicht gefunden

422: Ungültige Eingabedaten

500: Interner Serverfehler

Mögliche Kombinationen

NameDefinitioninternal_state
completedDie Bestellung ist abgeschlossen und vollständig ausgefülltgefüllt
canceledDie Bestellung wurde nicht ausgeführt und vom Benutzer storniertleer
canceled_by_stop_lossDie Order wurde nicht ausgeführt und automatisch storniert, da der Markt den stop_loss preis erreichteleer
canceledDie Bestellung wurde teilweise ausgeführt und dann vom Benutzer storniertteilweise_gefüllt
canceled_by_stop_lossDie Order wurde teilweise ausgeführt und dann automatisch storniert, da der Markt den stop_loss preis erreichteteilweise_gefüllt

Definition

Die Bestellung ist abgeschlossen und vollständig ausgefüllt

Definition

Die Bestellung wurde nicht ausgeführt und vom Benutzer storniert

Definition

Die Order wurde nicht ausgeführt und automatisch storniert, da der Markt den stop_loss preis erreichte

Definition

Die Bestellung wurde teilweise ausgeführt und dann vom Benutzer storniert

Definition

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}
KOPIEREN

Antwortbeispiel 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