Lịch sử đơn hàng đã hoàn thành
get
https://api.cryptomus.com/v2/user-api/exchange/orders/history
Lời yêu cầu
Tham số truy vấn
| Tên | Kiểu tham số | Sự định nghĩa |
|---|---|---|
| market | string | Lọc theo cặp giao dịch (ví dụ: `TRX_USDT`) |
| direction | string | Lọc theo hướngCác tùy chọn có sẵn:• buy• sell |
| order_id | string | Lọc theo ID đơn hàng trong sổ đơn hàng |
| client_order_id | string | Lọc theo ID đơn hàng của khách hàng |
| limit | string | Một tham số đặc biệt thiết lập số lượng bản ghi tối đa mà yêu cầu sẽ trả về |
| offset | string | Một tham số đặc biệt chỉ ra số lượng bản ghi cần bỏ qua |
Kiểu tham số
stringSự định nghĩa
Lọc theo cặp giao dịch (ví dụ: `TRX_USDT`)Kiểu tham số
stringSự định nghĩa
Lọc theo hướngCác tùy chọn có sẵn:- buy- sellKiểu tham số
stringSự định nghĩa
Lọc theo ID đơn hàng trong sổ đơn hàngKiểu tham số
stringSự định nghĩa
Lọc theo ID đơn hàng của khách hàngKiểu tham số
stringSự định nghĩa
Một tham số đặc biệt thiết lập số lượng bản ghi tối đa mà yêu cầu sẽ trả vềKiểu tham số
stringSự định nghĩa
Một tham số đặc biệt chỉ ra số lượng bản ghi cần bỏ qua
Phản ứng
Tham số phản hồi đơn hàng
| Tên | Sự định nghĩa |
|---|---|
| id | ID đơn hàng trong sổ lệnh |
| type | Loại lệnhCác tùy chọn có sẵn:• buy• sell |
| direction | Hướng đặt hàngCác tùy chọn có sẵn:• buy• sell |
| symbol | Lọc theo cặp giao dịch (ví dụ: `TRX_USDT`) |
| quantity | Số lượng tài sản cơ sở được yêu cầu |
| filledQuantity | Số lượng tài sản cơ sở đã được lấp đầy |
| filledValue | Số lượng tài sản báo giá đã điền đầy đủ |
| state | Trạng thái hiện tại của đơn hàng (ví dụ: 'đã hoàn thành') |
| internalState | Trạng thái bên trong của đơn hàng (ví dụ: 'đã hoàn thành') |
| createdAt | Thời gian tạo đơn hàng |
| finishedAt | Thời gian hoàn thành đơn hàng |
| stopLossPrice | Giá thị trường ngưỡng của tài sản, khi đạt đến giá này lệnh sẽ tự động bị hủy |
Sự định nghĩa
ID đơn hàng trong sổ lệnhSự định nghĩa
Loại lệnhCác tùy chọn có sẵn:- buy- sellSự định nghĩa
Hướng đặt hàngCác tùy chọn có sẵn:- buy- sellSự định nghĩa
Lọc theo cặp giao dịch (ví dụ: `TRX_USDT`)Sự định nghĩa
Số lượng tài sản cơ sở được yêu cầuSự định nghĩa
Số lượng tài sản cơ sở đã được lấp đầySự định nghĩa
Số lượng tài sản báo giá đã điền đầy đủSự định nghĩa
Trạng thái hiện tại của đơn hàng (ví dụ: 'đã hoàn thành')Sự định nghĩa
Trạng thái bên trong của đơn hàng (ví dụ: 'đã hoàn thành')Sự định nghĩa
Thời gian tạo đơn hàngSự định nghĩa
Thời gian hoàn thành đơn hàngSự định nghĩa
Giá thị trường ngưỡng của tài sản, khi đạt đến giá này lệnh sẽ tự động bị hủy
Các thông số phản hồi giao dịch
| Tên | Sự định nghĩa |
|---|---|
| id | Mã giao dịch |
| state | Trạng thái giao dịch (ví dụ: `đã hoàn thành`) |
| createdAt | Thời điểm giao dịch được tạo ra |
| completedAt | Thời gian giao dịch hoàn tất |
| averageFilledPrice | Giá trung bình đã hoàn thành cho giao dịch |
Sự định nghĩa
Mã giao dịchSự định nghĩa
Trạng thái giao dịch (ví dụ: `đã hoàn thành`)Sự định nghĩa
Thời điểm giao dịch được tạo raSự định nghĩa
Thời gian giao dịch hoàn tấtSự định nghĩa
Giá trung bình đã hoàn thành cho giao dịch
Tham số phản hồi giao dịch thỏa thuận
| Tên | Sự định nghĩa |
|---|---|
| id | Mã giao dịch |
| tradeRole | Vai trò trong thương mạiCác tùy chọn có sẵn:• taker• maker |
| filledPrice | Giá đã điền cho giao dịch |
| filledQuantity | Số tiền thực hiện bằng tiền tệ cơ sở |
| filledValue | Số tiền thực hiện theo đơn vị tiền tệ được báo giá |
| fee | Phí giao dịch |
| feeCurrency | Tiền tệ được tính phí |
| committedAt | Thời gian thực hiện giao dịch |
Sự định nghĩa
Mã giao dịchSự định nghĩa
Vai trò trong thương mạiCác tùy chọn có sẵn:- taker- makerSự định nghĩa
Giá đã điền cho giao dịchSự định nghĩa
Số tiền thực hiện bằng tiền tệ cơ sởSự định nghĩa
Số tiền thực hiện theo đơn vị tiền tệ được báo giáSự định nghĩa
Phí giao dịchSự định nghĩa
Tiền tệ được tính phíSự định nghĩa
Thời gian thực hiện giao dịch
Ví dụ phản hồi
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 Mã có thể
404: Không tìm thấy người dùng hoặc tài nguyên
422: Dữ liệu đầu vào không hợp lệ
500: Lỗi máy chủ nội bộ
Các kết hợp có thể
| Tên | Sự định nghĩa | trạng thái_nội_bối |
|---|---|---|
| completed | Đơn hàng đã hoàn thành và được điền đầy đủ | điền |
| canceled | Đơn hàng không được thực hiện và đã bị người dùng hủy | trống |
| canceled_by_stop_loss | Lệnh không được thực hiện và tự động bị hủy do thị trường đạt đến mức giá dừng lỗ | trống |
| canceled | Đơn hàng đã được thực hiện một phần và sau đó bị người dùng hủy | đã được lấp đầy một phần |
| canceled_by_stop_loss | Lệnh đã được thực hiện một phần và sau đó tự động bị hủy do thị trường đạt đến mức giá dừng lỗ | đã được lấp đầy một phần |
Sự định nghĩa
Đơn hàng đã hoàn thành và được điền đầy đủSự định nghĩa
Đơn hàng không được thực hiện và đã bị người dùng hủySự định nghĩa
Lệnh không được thực hiện và tự động bị hủy do thị trường đạt đến mức giá dừng lỗSự định nghĩa
Đơn hàng đã được thực hiện một phần và sau đó bị người dùng hủySự định nghĩa
Lệnh đã được thực hiện một phần và sau đó tự động bị hủy do thị trường đạt đến mức giá dừng lỗ
Lỗi có thể xảy ra
ví dụ phản hồi:
1{
2 "state": 0,
3 "message": "Standard validation error"
4}Ví dụ phản hồi có lỗi
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}