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

: Type de paramètre
string
Définition
Numéro de commande dans le carnet de commandes
: Type de paramètre
string
Définition
Type de commandeOptions disponibles:- buy- sell
: Type de paramètre
string
Définition
Direction de la commandeOptions disponibles:- buy- sell
: Type de paramètre
string
Définition
Filtrer par paire de trading (par exemple, « TRX_USDT »)
: Type de paramètre
string|null
Définition
Quantité demandée de l'actif de base
: Type de paramètre
string
Définition
Quantité remplie de l'actif de base
: Type de paramètre
string
Définition
Quantité remplie de l'actif de devis
: Type de paramètre
string
Définition
État actuel de la commande (par exemple, « terminée »)
: Type de paramètre
string
Définition
État interne de la commande (par exemple, « rempli »)
: Type de paramètre
string
Définition
Heure à laquelle la commande a été créée
: Type de paramètre
string
Définition
Heure à laquelle la commande a été complétée
: Type de paramètre
string|null
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	Type de paramètre	Définition
id	string	ID de transaction
state	string	État commercial (par exemple, « terminé »)
createdAt	string	Heure à laquelle le commerce a été créé
completedAt	string	Heure à laquelle la transaction a été terminée
averageFilledPrice	string	Prix d'exécution moyen pour la transaction

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

Paramètres de réponse aux transactions de transaction

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

: Type de paramètre
string
Définition
Identifiant de la transaction
: Type de paramètre
string
Définition
Rôle dans le commerceOptions disponibles:- taker- maker
: Type de paramètre
string
Définition
Prix indiqué pour la transaction
: Type de paramètre
string
Définition
Montant exécuté dans la devise de base
: Type de paramètre
string
Définition
Montant exécuté dans la devise de cotation
: Type de paramètre
string
Définition
Frais de transaction
: Type de paramètre
string
Définition
Devise dans laquelle les frais sont facturés
: Type de paramètre
string
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