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

: Tipo de parámetro
string
Definición
ID de pedido en el libro de pedidos
: Tipo de parámetro
string
Definición
Tipo de ordenOpciones Disponibles:- buy- sell
: Tipo de parámetro
string
Definición
Dirección del pedidoOpciones Disponibles:- buy- sell
: Tipo de parámetro
string
Definición
Filtrar por par comercial (por ejemplo, `TRX_USDT`)
: Tipo de parámetro
string|null
Definición
Cantidad solicitada del activo base
: Tipo de parámetro
string
Definición
Cantidad llenada de activo base
: Tipo de parámetro
string
Definición
Cantidad completada de activo de cotización
: Tipo de parámetro
string
Definición
Estado actual del pedido (por ejemplo, "completado")
: Tipo de parámetro
string
Definición
Estado interno del pedido (por ejemplo, "completado")
: Tipo de parámetro
string
Definición
Hora en que se creó el pedido
: Tipo de parámetro
string
Definición
Hora en que se completó el pedido
: Tipo de parámetro
string|null
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	Tipo de parámetro	Definición
id	string	ID de transacción
state	string	Estado comercial (por ejemplo, "completado")
createdAt	string	Hora en que se creó el comercio
completedAt	string	Hora en que se completó la operación
averageFilledPrice	string	Precio promedio ejecutado para el comercio.

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

Parámetros de respuesta de transacción de trato

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

: Tipo de parámetro
string
Definición
Identificación de transacción
: Tipo de parámetro
string
Definición
Papel en el comercioOpciones Disponibles:- taker- maker
: Tipo de parámetro
string
Definición
Precio completado para la transacción.
: Tipo de parámetro
string
Definición
Monto ejecutado en la moneda base
: Tipo de parámetro
string
Definición
Monto ejecutado en la moneda cotizada
: Tipo de parámetro
string
Definición
Tarifa de transacción
: Tipo de parámetro
string
Definición
Moneda en la que se cobra la tarifa
: Tipo de parámetro
string
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

Ejemplos de respuestas:


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