Historie der abgeschlossenen Bestellungen

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

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

Name	Parametertyp	Definition
id	string	Order-ID im Orderbuch
type	string	AuftragsartVerfügbare Optionen:• buy• sell
direction	string	BestellrichtungVerfügbare Optionen:• buy• sell
symbol	string	Nach Handelspaar filtern (z. B. „TRX_USDT“)
quantity	string\|null	Angeforderte Menge des Basis-Assets
filledQuantity	string	Gefüllte Menge des Basis-Assets
filledValue	string	Gefüllte Menge des Angebots-Assets
state	string	Aktueller Status der Bestellung (z. B. „abgeschlossen“)
internalState	string	Interner Status der Bestellung (z. B. „ausgeführt“)
createdAt	string	Zeitpunkt, zu dem die Bestellung erstellt wurde
finishedAt	string	Zeitpunkt, zu dem die Bestellung abgeschlossen wurde
stopLossPrice	string\|null	Der Schwellenmarktpreis des Vermögenswerts, bei dessen Erreichen die Bestellung automatisch storniert wird

: Parametertyp
string
Definition
Order-ID im Orderbuch
: Parametertyp
string
Definition
AuftragsartVerfügbare Optionen:- buy- sell
: Parametertyp
string
Definition
BestellrichtungVerfügbare Optionen:- buy- sell
: Parametertyp
string
Definition
Nach Handelspaar filtern (z. B. „TRX_USDT“)
: Parametertyp
string|null
Definition
Angeforderte Menge des Basis-Assets
: Parametertyp
string
Definition
Gefüllte Menge des Basis-Assets
: Parametertyp
string
Definition
Gefüllte Menge des Angebots-Assets
: Parametertyp
string
Definition
Aktueller Status der Bestellung (z. B. „abgeschlossen“)
: Parametertyp
string
Definition
Interner Status der Bestellung (z. B. „ausgeführt“)
: Parametertyp
string
Definition
Zeitpunkt, zu dem die Bestellung erstellt wurde
: Parametertyp
string
Definition
Zeitpunkt, zu dem die Bestellung abgeschlossen wurde
: Parametertyp
string|null
Definition
Der Schwellenmarktpreis des Vermögenswerts, bei dessen Erreichen die Bestellung automatisch storniert wird

Deal-Response-Parameter

Name	Parametertyp	Definition
id	string	Handels-ID
state	string	Handelsstatus (z. B. „abgeschlossen“)
createdAt	string	Zeitpunkt, zu dem der Handel erstellt wurde
completedAt	string	Zeitpunkt, zu dem der Handel abgeschlossen wurde
averageFilledPrice	string	Durchschnittlicher erfüllter Preis für den Handel

: Parametertyp
string
Definition
Handels-ID
: Parametertyp
string
Definition
Handelsstatus (z. B. „abgeschlossen“)
: Parametertyp
string
Definition
Zeitpunkt, zu dem der Handel erstellt wurde
: Parametertyp
string
Definition
Zeitpunkt, zu dem der Handel abgeschlossen wurde
: Parametertyp
string
Definition
Durchschnittlicher erfüllter Preis für den Handel

Antwortparameter für Geschäftstransaktionen

Name	Parametertyp	Definition
id	string	Transaktions-ID
tradeRole	string	Rolle im HandelVerfügbare Optionen:• taker• maker
filledPrice	string	Ausgefüllter Preis für die Transaktion
filledQuantity	string	Ausgeführter Betrag in der Basiswährung
filledValue	string	Ausgeführter Betrag in der Kurswährung
fee	string	Transaktionsgebühr
feeCurrency	string	Währung, in der die Gebühr berechnet wird
committedAt	string	Zeitpunkt der Transaktionsausführung

: Parametertyp
string
Definition
Transaktions-ID
: Parametertyp
string
Definition
Rolle im HandelVerfügbare Optionen:- taker- maker
: Parametertyp
string
Definition
Ausgefüllter Preis für die Transaktion
: Parametertyp
string
Definition
Ausgeführter Betrag in der Basiswährung
: Parametertyp
string
Definition
Ausgeführter Betrag in der Kurswährung
: Parametertyp
string
Definition
Transaktionsgebühr
: Parametertyp
string
Definition
Währung, in der die Gebühr berechnet wird
: Parametertyp
string
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

Kopie

Mö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ü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}

Kopie

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}

Kopie