Historique des commandes terminées

get

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

COPIE

Demande

Paramètres de requête

Nom	Type de paramètre	Définition
market	string	Filtrer par paire de trading (par exemple, « TRX_USDT »)
direction	string	Filtrer par directionOptions disponibles:• buy• sell
order_id	string	Filtrer par numéro de commande dans le carnet de commandes
client_order_id	string	Filtrer par numéro de commande client
limit	string	Un paramètre spécial qui définit le nombre maximum d'enregistrements que la requête renverra
offset	string	Un paramètre spécial qui indique le nombre d'enregistrements à ignorer

Type de paramètre

string

Définition

Filtrer par paire de trading (par exemple, « TRX_USDT »)

Type de paramètre

string

Définition

Filtrer par directionOptions disponibles:- buy- sell

Type de paramètre

string

Définition

Filtrer par numéro de commande dans le carnet de commandes

Type de paramètre

string

Définition

Filtrer par numéro de commande client

Type de paramètre

string

Définition

Un paramètre spécial qui définit le nombre maximum d'enregistrements que la requête renverra

Type de paramètre

string

Définition

Un paramètre spécial qui indique le nombre d'enregistrements à ignorer

Réponse

Paramètres de réponse à la commande

Nom	Définition
id	Numéro de commande dans le carnet de commandes
type	Type de commandeOptions disponibles:• buy• sell
direction	Direction de la commandeOptions disponibles:• buy• sell
symbol	Filtrer par paire de trading (par exemple, « TRX_USDT »)
quantity	Quantité demandée de l'actif de base
filledQuantity	Quantité remplie de l'actif de base
filledValue	Quantité remplie de l'actif de devis
state	État actuel de la commande (par exemple, « terminée »)
internalState	État interne de la commande (par exemple, « rempli »)
createdAt	Heure à laquelle la commande a été créée
finishedAt	Heure à laquelle la commande a été complétée
stopLossPrice	Le prix de marché seuil de l'actif, une fois atteint, l'ordre sera automatiquement annulé

: Définition
Numéro de commande dans le carnet de commandes
: Définition
Type de commandeOptions disponibles:- buy- sell
: Définition
Direction de la commandeOptions disponibles:- buy- sell
: Définition
Filtrer par paire de trading (par exemple, « TRX_USDT »)
: Définition
Quantité demandée de l'actif de base
: Définition
Quantité remplie de l'actif de base
: Définition
Quantité remplie de l'actif de devis
: Définition
État actuel de la commande (par exemple, « terminée »)
: Définition
État interne de la commande (par exemple, « rempli »)
: Définition
Heure à laquelle la commande a été créée
: Définition
Heure à laquelle la commande a été complétée
: Définition
Le prix de marché seuil de l'actif, une fois atteint, l'ordre sera automatiquement annulé

Paramètres de réponse à la transaction

Nom	Définition
id	ID de transaction
state	État commercial (par exemple, « terminé »)
createdAt	Heure à laquelle le commerce a été créé
completedAt	Heure à laquelle la transaction a été terminée
averageFilledPrice	Prix d'exécution moyen pour la transaction

: Définition
ID de transaction
: Définition
État commercial (par exemple, « terminé »)
: Définition
Heure à laquelle le commerce a été créé
: Définition
Heure à laquelle la transaction a été terminée
: Définition
Prix d'exécution moyen pour la transaction

Paramètres de réponse aux transactions de transaction

Nom	Définition
id	Identifiant de la transaction
tradeRole	Rôle dans le commerceOptions disponibles:• taker• maker
filledPrice	Prix indiqué pour la transaction
filledQuantity	Montant exécuté dans la devise de base
filledValue	Montant exécuté dans la devise de cotation
fee	Frais de transaction
feeCurrency	Devise dans laquelle les frais sont facturés
committedAt	Heure d'exécution de la transaction

: Définition
Identifiant de la transaction
: Définition
Rôle dans le commerceOptions disponibles:- taker- maker
: Définition
Prix indiqué pour la transaction
: Définition
Montant exécuté dans la devise de base
: Définition
Montant exécuté dans la devise de cotation
: Définition
Frais de transaction
: Définition
Devise dans laquelle les frais sont facturés
: Définition
Heure d'exécution de la transaction

Exemple de réponse


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

COPIE

Codes possibles

404 : Utilisateur ou ressource introuvable

422 : Données d'entrée invalides

500 : erreur de serveur interne

Combinaisons possibles

Nom	Définition	état_interne
completed	La commande est complétée et entièrement exécutée	rempli
canceled	La commande n'a pas été exécutée et a été annulée par l'utilisateur	vide
canceled_by_stop_loss	L'ordre n'a pas été exécuté et a été automatiquement annulé car le marché a atteint le prix stop_loss	vide
canceled	La commande a été partiellement exécutée puis annulée par l'utilisateur	partiellement_rempli
canceled_by_stop_loss	L'ordre a été partiellement exécuté puis automatiquement annulé car le marché a atteint le prix stop_loss	partiellement_rempli

: Définition
La commande est complétée et entièrement exécutée
: Définition
La commande n'a pas été exécutée et a été annulée par l'utilisateur
: Définition
L'ordre n'a pas été exécuté et a été automatiquement annulé car le marché a atteint le prix stop_loss
: Définition
La commande a été partiellement exécutée puis annulée par l'utilisateur
: Définition
L'ordre a été partiellement exécuté puis automatiquement annulé car le marché a atteint le prix stop_loss

Erreurs possibles

Exemples de réponses:


1{
2  "state": 0,
3  "message": "Standard validation error"
4}

COPIE

Exemple de réponse avec erreur


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}

COPIE