Histórico de pedidos concluídos

get

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

CÓPIA DE

Solicitar

Parâmetros de consulta

Nome	Tipo de parâmetro	Definição
market	string	Filtrar por par de negociação (por exemplo, `TRX_USDT`)
direction	string	Filtrar por direçãoOpções disponíveis:• buy• sell
order_id	string	Filtrar por ID do pedido na carteira de pedidos
client_order_id	string	Filtrar por ID do pedido do cliente
limit	string	Um parâmetro especial que define o número máximo de registros que a solicitação retornará
offset	string	Um parâmetro especial que indica o número de registros a serem ignorados

Tipo de parâmetro

string

Definição

Filtrar por par de negociação (por exemplo, `TRX_USDT`)

Tipo de parâmetro

string

Definição

Filtrar por direçãoOpções disponíveis:- buy- sell

Tipo de parâmetro

string

Definição

Filtrar por ID do pedido na carteira de pedidos

Tipo de parâmetro

string

Definição

Filtrar por ID do pedido do cliente

Tipo de parâmetro

string

Definição

Um parâmetro especial que define o número máximo de registros que a solicitação retornará

Tipo de parâmetro

string

Definição

Um parâmetro especial que indica o número de registros a serem ignorados

Resposta

Parâmetros de resposta do pedido

Nome	Definição
id	ID do pedido no livro de pedidos
type	Tipo de pedidoOpções disponíveis:• buy• sell
direction	Direção do pedidoOpções disponíveis:• buy• sell
symbol	Filtrar por par de negociação (por exemplo, `TRX_USDT`)
quantity	Quantidade solicitada do ativo base
filledQuantity	Quantidade preenchida do ativo base
filledValue	Quantidade preenchida de ativo de cotação
state	Estado atual do pedido (por exemplo, 'concluído')
internalState	Estado interno do pedido (por exemplo, 'preenchido')
createdAt	Hora em que o pedido foi criado
finishedAt	Hora em que o pedido foi concluído
stopLossPrice	O preço limite de mercado do ativo, ao atingir o qual a ordem será automaticamente cancelada

: Definição
ID do pedido no livro de pedidos
: Definição
Tipo de pedidoOpções disponíveis:- buy- sell
: Definição
Direção do pedidoOpções disponíveis:- buy- sell
: Definição
Filtrar por par de negociação (por exemplo, `TRX_USDT`)
: Definição
Quantidade solicitada do ativo base
: Definição
Quantidade preenchida do ativo base
: Definição
Quantidade preenchida de ativo de cotação
: Definição
Estado atual do pedido (por exemplo, 'concluído')
: Definição
Estado interno do pedido (por exemplo, 'preenchido')
: Definição
Hora em que o pedido foi criado
: Definição
Hora em que o pedido foi concluído
: Definição
O preço limite de mercado do ativo, ao atingir o qual a ordem será automaticamente cancelada

Parâmetros de resposta da transação

Nome	Definição
id	ID da transação
state	Estado comercial (por exemplo, `concluído`)
createdAt	Momento em que o comércio foi criado
completedAt	Hora em que a negociação foi concluída
averageFilledPrice	Preço médio preenchido para a negociação

: Definição
ID da transação
: Definição
Estado comercial (por exemplo, `concluído`)
: Definição
Momento em que o comércio foi criado
: Definição
Hora em que a negociação foi concluída
: Definição
Preço médio preenchido para a negociação

Parâmetros de resposta de transação de negócio

Nome	Definição
id	ID da transação
tradeRole	Papel no comércioOpções disponíveis:• taker• maker
filledPrice	Preço preenchido para a transação
filledQuantity	Valor executado na moeda base
filledValue	Valor executado na moeda de cotação
fee	Taxa de transação
feeCurrency	Moeda em que a taxa é cobrada
committedAt	Tempo de execução da transação

: Definição
ID da transação
: Definição
Papel no comércioOpções disponíveis:- taker- maker
: Definição
Preço preenchido para a transação
: Definição
Valor executado na moeda base
: Definição
Valor executado na moeda de cotação
: Definição
Taxa de transação
: Definição
Moeda em que a taxa é cobrada
: Definição
Tempo de execução da transação

Exemplo de resposta


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

CÓPIA DE

Códigos possíveis

404: Usuário ou recurso não encontrado

422: Dados de entrada inválidos

500: Erro interno do servidor

Combinações possíveis

Nome	Definição	estado_interno
completed	O pedido foi concluído e totalmente atendido	preenchido
canceled	O pedido não foi atendido e foi cancelado pelo usuário	vazio
canceled_by_stop_loss	A ordem não foi atendida e foi automaticamente cancelada porque o mercado atingiu o preço stop_loss	vazio
canceled	O pedido foi parcialmente atendido e depois cancelado pelo usuário	parcialmente_preenchido
canceled_by_stop_loss	A ordem foi parcialmente preenchida e depois cancelada automaticamente porque o mercado atingiu o preço stop_loss	parcialmente_preenchido

: Definição
O pedido foi concluído e totalmente atendido
: Definição
O pedido não foi atendido e foi cancelado pelo usuário
: Definição
A ordem não foi atendida e foi automaticamente cancelada porque o mercado atingiu o preço stop_loss
: Definição
O pedido foi parcialmente atendido e depois cancelado pelo usuário
: Definição
A ordem foi parcialmente preenchida e depois cancelada automaticamente porque o mercado atingiu o preço stop_loss

Possíveis erros

Exemplo de respostas:


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

CÓPIA DE

Exemplo de resposta com erro


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}

CÓPIA DE