Lịch sử đơn hàng đã hoàn thành

get https://api.cryptomus.com/v2/user-api/exchange/orders/history Sao chép

Lời yêu cầu

Tham số truy vấn

TênKiểu tham sốSự định nghĩa
marketstringLọc theo cặp giao dịch (ví dụ: `TRX_USDT`)
directionstringLọc theo hướngCác tùy chọn có sẵn:• buy• sell
order_idstringLọc theo ID đơn hàng trong sổ đơn hàng
client_order_idstringLọc theo ID đơn hàng của khách hàng
limitstringMộ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ề
offsetstringMột tham số đặc biệt chỉ ra số lượng bản ghi cần bỏ qua

Kiểu tham số

string

Sự định nghĩa

Lọc theo cặp giao dịch (ví dụ: `TRX_USDT`)

Kiểu tham số

string

Sự định nghĩa

Lọc theo hướngCác tùy chọn có sẵn:- buy- sell

Kiểu tham số

string

Sự định nghĩa

Lọc theo ID đơn hàng trong sổ đơn hàng

Kiểu tham số

string

Sự định nghĩa

Lọc theo ID đơn hàng của khách hàng

Kiểu tham số

string

Sự đị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ố

string

Sự đị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ênKiểu tham sốSự định nghĩa
idstringID đơn hàng trong sổ lệnh
typestringLoại lệnhCác tùy chọn có sẵn:• buy• sell
directionstringHướng đặt hàngCác tùy chọn có sẵn:• buy• sell
symbolstringLọc theo cặp giao dịch (ví dụ: `TRX_USDT`)
quantitystring|nullSố lượng tài sản cơ sở được yêu cầu
filledQuantitystringSố lượng tài sản cơ sở đã được lấp đầy
filledValuestringSố lượng tài sản báo giá đã điền đầy đủ
statestringTrạng thái hiện tại của đơn hàng (ví dụ: 'đã hoàn thành')
internalStatestringTrạng thái bên trong của đơn hàng (ví dụ: 'đã hoàn thành')
createdAtstringThời gian tạo đơn hàng
finishedAtstringThời gian hoàn thành đơn hàng
stopLossPricestring|nullGiá 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

Kiểu tham số

string

Sự định nghĩa

ID đơn hàng trong sổ lệnh

Kiểu tham số

string

Sự định nghĩa

Loại lệnhCác tùy chọn có sẵn:- buy- sell

Kiểu tham số

string

Sự định nghĩa

Hướng đặt hàngCác tùy chọn có sẵn:- buy- sell

Kiểu tham số

string

Sự định nghĩa

Lọc theo cặp giao dịch (ví dụ: `TRX_USDT`)

Kiểu tham số

string|null

Sự định nghĩa

Số lượng tài sản cơ sở được yêu cầu

Kiểu tham số

string

Sự định nghĩa

Số lượng tài sản cơ sở đã được lấp đầy

Kiểu tham số

string

Sự định nghĩa

Số lượng tài sản báo giá đã điền đầy đủ

Kiểu tham số

string

Sự định nghĩa

Trạng thái hiện tại của đơn hàng (ví dụ: 'đã hoàn thành')

Kiểu tham số

string

Sự định nghĩa

Trạng thái bên trong của đơn hàng (ví dụ: 'đã hoàn thành')

Kiểu tham số

string

Sự định nghĩa

Thời gian tạo đơn hàng

Kiểu tham số

string

Sự định nghĩa

Thời gian hoàn thành đơn hàng

Kiểu tham số

string|null

Sự đị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ênKiểu tham sốSự định nghĩa
idstringMã giao dịch
statestringTrạng thái giao dịch (ví dụ: `đã hoàn thành`)
createdAtstringThời điểm giao dịch được tạo ra
completedAtstringThời gian giao dịch hoàn tất
averageFilledPricestringGiá trung bình đã hoàn thành cho giao dịch

Kiểu tham số

string

Sự định nghĩa

Mã giao dịch

Kiểu tham số

string

Sự định nghĩa

Trạng thái giao dịch (ví dụ: `đã hoàn thành`)

Kiểu tham số

string

Sự định nghĩa

Thời điểm giao dịch được tạo ra

Kiểu tham số

string

Sự định nghĩa

Thời gian giao dịch hoàn tất

Kiểu tham số

string

Sự đị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ênKiểu tham sốSự định nghĩa
idstringMã giao dịch
tradeRolestringVai trò trong thương mạiCác tùy chọn có sẵn:• taker• maker
filledPricestringGiá đã điền cho giao dịch
filledQuantitystringSố tiền thực hiện bằng tiền tệ cơ sở
filledValuestringSố tiền thực hiện theo đơn vị tiền tệ được báo giá
feestringPhí giao dịch
feeCurrencystringTiền tệ được tính phí
committedAtstringThời gian thực hiện giao dịch

Kiểu tham số

string

Sự định nghĩa

Mã giao dịch

Kiểu tham số

string

Sự định nghĩa

Vai trò trong thương mạiCác tùy chọn có sẵn:- taker- maker

Kiểu tham số

string

Sự định nghĩa

Giá đã điền cho giao dịch

Kiểu tham số

string

Sự định nghĩa

Số tiền thực hiện bằng tiền tệ cơ sở

Kiểu tham số

string

Sự định nghĩa

Số tiền thực hiện theo đơn vị tiền tệ được báo giá

Kiểu tham số

string

Sự định nghĩa

Phí giao dịch

Kiểu tham số

string

Sự định nghĩa

Tiền tệ được tính phí

Kiểu tham số

string

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
Sao chép

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ênSự định nghĩatrạ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ủytrống
canceled_by_stop_lossLệ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_lossLệ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ủy

Sự đị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ủy

Sự đị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}
Sao chép

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}
Sao chép