Historial de pedidos completados

get

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

COPIAR

Pedido

Parámetros de consulta

Nombre	Tipo de parámetro	Definición
market	string	Filtrar por par comercial (por ejemplo, `TRX_USDT`)
direction	string	Filtrar por direcciónOpciones Disponibles:• buy• sell
order_id	string	Filtrar por ID de pedido en el libro de pedidos
client_order_id	string	Filtrar por ID de pedido del cliente
limit	string	Un parámetro especial que establece el número máximo de registros que devolverá la solicitud.
offset	string	Un parámetro especial que indica el número de registros a omitir.

Tipo de parámetro

string

Definición

Filtrar por par comercial (por ejemplo, `TRX_USDT`)

Tipo de parámetro

string

Definición

Filtrar por direcciónOpciones Disponibles:- buy- sell

Tipo de parámetro

string

Definición

Filtrar por ID de pedido en el libro de pedidos

Tipo de parámetro

string

Definición

Filtrar por ID de pedido del cliente

Tipo de parámetro

string

Definición

Un parámetro especial que establece el número máximo de registros que devolverá la solicitud.

Tipo de parámetro

string

Definición

Un parámetro especial que indica el número de registros a omitir.

Respuesta

Parámetros de respuesta del pedido

Nombre	Definición
id	ID de pedido en el libro de pedidos
type	Tipo de ordenOpciones Disponibles:• buy• sell
direction	Dirección del pedidoOpciones Disponibles:• buy• sell
symbol	Filtrar por par comercial (por ejemplo, `TRX_USDT`)
quantity	Cantidad solicitada del activo base
filledQuantity	Cantidad llenada de activo base
filledValue	Cantidad completada de activo de cotización
state	Estado actual del pedido (por ejemplo, "completado")
internalState	Estado interno del pedido (por ejemplo, "completado")
createdAt	Hora en que se creó el pedido
finishedAt	Hora en que se completó el pedido
stopLossPrice	El precio umbral de mercado del activo, al alcanzar el cual la orden se cancelará automáticamente.

: Definición
ID de pedido en el libro de pedidos
: Definición
Tipo de ordenOpciones Disponibles:- buy- sell
: Definición
Dirección del pedidoOpciones Disponibles:- buy- sell
: Definición
Filtrar por par comercial (por ejemplo, `TRX_USDT`)
: Definición
Cantidad solicitada del activo base
: Definición
Cantidad llenada de activo base
: Definición
Cantidad completada de activo de cotización
: Definición
Estado actual del pedido (por ejemplo, "completado")
: Definición
Estado interno del pedido (por ejemplo, "completado")
: Definición
Hora en que se creó el pedido
: Definición
Hora en que se completó el pedido
: Definición
El precio umbral de mercado del activo, al alcanzar el cual la orden se cancelará automáticamente.

Parámetros de respuesta al trato

Nombre	Definición
id	ID de transacción
state	Estado comercial (por ejemplo, "completado")
createdAt	Hora en que se creó el comercio
completedAt	Hora en que se completó la operación
averageFilledPrice	Precio promedio ejecutado para el comercio.

: Definición
ID de transacción
: Definición
Estado comercial (por ejemplo, "completado")
: Definición
Hora en que se creó el comercio
: Definición
Hora en que se completó la operación
: Definición
Precio promedio ejecutado para el comercio.

Parámetros de respuesta de transacción de trato

Nombre	Definición
id	Identificación de transacción
tradeRole	Papel en el comercioOpciones Disponibles:• taker• maker
filledPrice	Precio completado para la transacción.
filledQuantity	Monto ejecutado en la moneda base
filledValue	Monto ejecutado en la moneda cotizada
fee	Tarifa de transacción
feeCurrency	Moneda en la que se cobra la tarifa
committedAt	Hora de ejecución de la transacción

: Definición
Identificación de transacción
: Definición
Papel en el comercioOpciones Disponibles:- taker- maker
: Definición
Precio completado para la transacción.
: Definición
Monto ejecutado en la moneda base
: Definición
Monto ejecutado en la moneda cotizada
: Definición
Tarifa de transacción
: Definición
Moneda en la que se cobra la tarifa
: Definición
Hora de ejecución de la transacción

Ejemplo de respuesta


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

COPIAR

Posibles códigos

404: Usuario o recurso no encontrado

422: datos de entrada no válidos

500: error interno del servidor

Posibles combinaciones

Nombre	Definición	estado_interno
completed	El pedido está completado y completamente completado.	completado
canceled	El pedido no fue completado y fue cancelado por el usuario.	vacío
canceled_by_stop_loss	La orden no se completó y se canceló automáticamente debido a que el mercado alcanzó el precio stop_loss	vacío
canceled	El pedido fue parcialmente completado y luego cancelado por el usuario.	parcialmente lleno
canceled_by_stop_loss	La orden se completó parcialmente y luego se canceló automáticamente debido a que el mercado alcanzó el precio stop_loss	parcialmente lleno

: Definición
El pedido está completado y completamente completado.
: Definición
El pedido no fue completado y fue cancelado por el usuario.
: Definición
La orden no se completó y se canceló automáticamente debido a que el mercado alcanzó el precio stop_loss
: Definición
El pedido fue parcialmente completado y luego cancelado por el usuario.
: Definición
La orden se completó parcialmente y luego se canceló automáticamente debido a que el mercado alcanzó el precio stop_loss

Posibles errores

Respuestas de ejemplo:


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

COPIAR

Ejemplo de respuesta con error


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}

COPIAR