Historia zrealizowanych zamówień

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

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

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

Parametry odpowiedzi na ofertę

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

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

Parametry odpowiedzi na transakcję

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

: Typ parametru
string
Definicja
Identyfikator transakcji
: Typ parametru
string
Definicja
Rola w handluDostępne opcje:- taker- maker
: Typ parametru
string
Definicja
Wypełniona cena za transakcję
: Typ parametru
string
Definicja
Wykonana kwota w walucie bazowej
: Typ parametru
string
Definicja
Wykonana kwota w walucie kwotowanej
: Typ parametru
string
Definicja
Opłata transakcyjna
: Typ parametru
string
Definicja
Waluta, w której naliczana jest opłata
: Typ parametru
string
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

Kopia

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}

Kopia

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}

Kopia