Ordens concluídas

get https://api.cryptomus.com/v2/user-api/exchange/orders/history Cópia

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

: Tipo de parâmetro
string
Definição
ID do pedido no livro de pedidos
: Tipo de parâmetro
string
Definição
Tipo de pedidoOpções disponíveis:- buy- sell
: Tipo de parâmetro
string
Definição
Direção do pedidoOpções disponíveis:- buy- sell
: Tipo de parâmetro
string
Definição
Filtrar por par de negociação (por exemplo, `TRX_USDT`)
: Tipo de parâmetro
string|null
Definição
Quantidade solicitada do ativo base
: Tipo de parâmetro
string
Definição
Quantidade preenchida do ativo base
: Tipo de parâmetro
string
Definição
Quantidade preenchida de ativo de cotação
: Tipo de parâmetro
string
Definição
Estado atual do pedido (por exemplo, 'concluído')
: Tipo de parâmetro
string
Definição
Estado interno do pedido (por exemplo, 'preenchido')
: Tipo de parâmetro
string
Definição
Hora em que o pedido foi criado
: Tipo de parâmetro
string
Definição
Hora em que o pedido foi concluído
: Tipo de parâmetro
string|null
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	Tipo de parâmetro	Definição
id	string	ID da transação
state	string	Estado comercial (por exemplo, `concluído`)
createdAt	string	Momento em que o comércio foi criado
completedAt	string	Hora em que a negociação foi concluída
averageFilledPrice	string	Preço médio preenchido para a negociação

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

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

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

: Tipo de parâmetro
string
Definição
ID da transação
: Tipo de parâmetro
string
Definição
Papel no comércioOpções disponíveis:- taker- maker
: Tipo de parâmetro
string
Definição
Preço preenchido para a transação
: Tipo de parâmetro
string
Definição
Valor executado na moeda base
: Tipo de parâmetro
string
Definição
Valor executado na moeda de cotação
: Tipo de parâmetro
string
Definição
Taxa de transação
: Tipo de parâmetro
string
Definição
Moeda em que a taxa é cobrada
: Tipo de parâmetro
string
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

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

exemplos de respostas:


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

Cópia

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