Historia zrealizowanych zamówień

get

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

KOPIUJ

Wniosek

Parametry zapytania

Nazwa	Typ parametru	Definicja
market	string	Filtruj według pary handlowej (np. „TRX_USDT”)
direction	string	Filtruj według kierunkuDostępne opcje:• buy• sell
order_id	string	Filtruj według identyfikatora zamówienia w arkuszu zamówień
client_order_id	string	Filtruj według identyfikatora zamówienia klienta
limit	string	Specjalny parametr określający maksymalną liczbę rekordów zwróconych przez żądanie
offset	string	Specjalny parametr wskazujący liczbę rekordów do pominięcia

Typ parametru

string

Definicja

Filtruj według pary handlowej (np. „TRX_USDT”)

Typ parametru

string

Definicja

Filtruj według kierunkuDostępne opcje:- buy- sell

Typ parametru

string

Definicja

Filtruj według identyfikatora zamówienia w arkuszu zamówień

Typ parametru

string

Definicja

Filtruj według identyfikatora zamówienia klienta

Typ parametru

string

Definicja

Specjalny parametr określający maksymalną liczbę rekordów zwróconych przez żądanie

Typ parametru

string

Definicja

Specjalny parametr wskazujący liczbę rekordów do pominięcia

Odpowiedź

Parametry odpowiedzi na zamówienie

Nazwa	Definicja
id	Identyfikator zamówienia w księdze zamówień
type	Typ zamówieniaDostępne opcje:• buy• sell
direction	Kierunek zamówieniaDostępne opcje:• buy• sell
symbol	Filtruj według pary handlowej (np. „TRX_USDT”)
quantity	Żądana ilość zasobu podstawowego
filledQuantity	Wypełniona ilość zasobu podstawowego
filledValue	Wypełniona ilość zasobu wyceny
state	Aktualny stan zamówienia (np. „zrealizowane”)
internalState	Wewnętrzny stan zamówienia (np. „wypełnione”)
createdAt	Godzina utworzenia zamówienia
finishedAt	Czas realizacji zamówienia
stopLossPrice	Próg ceny rynkowej aktywa, po osiągnięciu którego zlecenie zostanie automatycznie anulowane

: Definicja
Identyfikator zamówienia w księdze zamówień
: Definicja
Typ zamówieniaDostępne opcje:- buy- sell
: Definicja
Kierunek zamówieniaDostępne opcje:- buy- sell
: Definicja
Filtruj według pary handlowej (np. „TRX_USDT”)
: Definicja
Żądana ilość zasobu podstawowego
: Definicja
Wypełniona ilość zasobu podstawowego
: Definicja
Wypełniona ilość zasobu wyceny
: Definicja
Aktualny stan zamówienia (np. „zrealizowane”)
: Definicja
Wewnętrzny stan zamówienia (np. „wypełnione”)
: Definicja
Godzina utworzenia zamówienia
: Definicja
Czas realizacji zamówienia
: Definicja
Próg ceny rynkowej aktywa, po osiągnięciu którego zlecenie zostanie automatycznie anulowane

Parametry odpowiedzi na ofertę

Nazwa	Definicja
id	ID transakcji
state	Stan handlu (np. „zakończony”)
createdAt	Czas utworzenia transakcji
completedAt	Czas zakończenia transakcji
averageFilledPrice	Średnia wypełniona cena dla transakcji

: Definicja
ID transakcji
: Definicja
Stan handlu (np. „zakończony”)
: Definicja
Czas utworzenia transakcji
: Definicja
Czas zakończenia transakcji
: Definicja
Średnia wypełniona cena dla transakcji

Parametry odpowiedzi na transakcję

Nazwa	Definicja
id	Identyfikator transakcji
tradeRole	Rola w handluDostępne opcje:• taker• maker
filledPrice	Wypełniona cena za transakcję
filledQuantity	Wykonana kwota w walucie bazowej
filledValue	Wykonana kwota w walucie kwotowanej
fee	Opłata transakcyjna
feeCurrency	Waluta, w której naliczana jest opłata
committedAt	Czas realizacji transakcji

: Definicja
Identyfikator transakcji
: Definicja
Rola w handluDostępne opcje:- taker- maker
: Definicja
Wypełniona cena za transakcję
: Definicja
Wykonana kwota w walucie bazowej
: Definicja
Wykonana kwota w walucie kwotowanej
: Definicja
Opłata transakcyjna
: Definicja
Waluta, w której naliczana jest opłata
: Definicja
Czas realizacji transakcji

Przykład odpowiedzi


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

KOPIUJ

Możliwe kody

404: Nie znaleziono użytkownika lub zasobu

422: Nieprawidłowe dane wejściowe

500: Wewnętrzny błąd serwera

Możliwe kombinacje

Nazwa	Definicja	stan_wewnętrzny
completed	Zamówienie jest skompletowane i w pełni wypełnione	wypełniony
canceled	Zamówienie nie zostało zrealizowane i zostało anulowane przez użytkownika	pusty
canceled_by_stop_loss	Zlecenie nie zostało zrealizowane i zostało automatycznie anulowane w związku z osiągnięciem przez rynek ceny stop_loss	pusty
canceled	Zamówienie zostało częściowo zrealizowane, a następnie anulowane przez użytkownika	częściowo_wypełniony
canceled_by_stop_loss	Zlecenie zostało częściowo zrealizowane, a następnie automatycznie anulowane w związku z osiągnięciem przez rynek ceny stop_loss	częściowo_wypełniony

: Definicja
Zamówienie jest skompletowane i w pełni wypełnione
: Definicja
Zamówienie nie zostało zrealizowane i zostało anulowane przez użytkownika
: Definicja
Zlecenie nie zostało zrealizowane i zostało automatycznie anulowane w związku z osiągnięciem przez rynek ceny stop_loss
: Definicja
Zamówienie zostało częściowo zrealizowane, a następnie anulowane przez użytkownika
: Definicja
Zlecenie zostało częściowo zrealizowane, a następnie automatycznie anulowane w związku z osiągnięciem przez rynek ceny stop_loss

Możliwe błędy

Przykładowe odpowiedzi:


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

KOPIUJ

Przykład odpowiedzi z błędem


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}

KOPIUJ