ประวัติการสั่งซื้อที่เสร็จสมบูรณ์

get
https://api.cryptomus.com/v2/user-api/exchange/orders/history
สำเนา

ขอ

พารามิเตอร์การค้นหา

ชื่อประเภทพารามิเตอร์คำนิยาม
marketstringกรองตามคู่การซื้อขาย (เช่น `TRX_USDT`)
directionstringกรองตามทิศทางตัวเลือกที่มี:• buy• sell
order_idstringกรองตามรหัสคำสั่งซื้อในสมุดคำสั่งซื้อ
client_order_idstringกรองตามรหัสคำสั่งซื้อของลูกค้า
limitstringพารามิเตอร์พิเศษที่กำหนดจำนวนสูงสุดของระเบียนที่คำขอจะส่งกลับ
offsetstringพารามิเตอร์พิเศษที่ระบุจำนวนเรคคอร์ดที่จะข้าม

ประเภทพารามิเตอร์

string

คำนิยาม

กรองตามคู่การซื้อขาย (เช่น `TRX_USDT`)

ประเภทพารามิเตอร์

string

คำนิยาม

กรองตามทิศทางตัวเลือกที่มี:- buy- sell

ประเภทพารามิเตอร์

string

คำนิยาม

กรองตามรหัสคำสั่งซื้อในสมุดคำสั่งซื้อ

ประเภทพารามิเตอร์

string

คำนิยาม

กรองตามรหัสคำสั่งซื้อของลูกค้า

ประเภทพารามิเตอร์

string

คำนิยาม

พารามิเตอร์พิเศษที่กำหนดจำนวนสูงสุดของระเบียนที่คำขอจะส่งกลับ

ประเภทพารามิเตอร์

string

คำนิยาม

พารามิเตอร์พิเศษที่ระบุจำนวนเรคคอร์ดที่จะข้าม

การตอบสนอง

พารามิเตอร์การตอบสนองคำสั่งซื้อ

ชื่อคำนิยาม
idรหัสคำสั่งซื้อในสมุดคำสั่งซื้อ
typeประเภทคำสั่งซื้อตัวเลือกที่มี:• buy• sell
directionทิศทางการสั่งซื้อตัวเลือกที่มี:• buy• sell
symbolกรองตามคู่การซื้อขาย (เช่น `TRX_USDT`)
quantityปริมาณสินทรัพย์ฐานที่ร้องขอ
filledQuantityปริมาณสินทรัพย์ฐานที่เติม
filledValueปริมาณสินทรัพย์ที่เสนอราคาเต็ม
stateสถานะปัจจุบันของคำสั่งซื้อ (เช่น 'เสร็จสมบูรณ์')
internalStateสถานะภายในของคำสั่งซื้อ (เช่น 'เติมแล้ว')
createdAtเวลาที่คำสั่งซื้อถูกสร้างขึ้น
finishedAtเวลาที่คำสั่งซื้อเสร็จสมบูรณ์
stopLossPriceราคาตลาดขั้นต่ำของสินทรัพย์ เมื่อถึงเกณฑ์ดังกล่าว คำสั่งจะถูกยกเลิกโดยอัตโนมัติ

คำนิยาม

รหัสคำสั่งซื้อในสมุดคำสั่งซื้อ

คำนิยาม

ประเภทคำสั่งซื้อตัวเลือกที่มี:- buy- sell

คำนิยาม

ทิศทางการสั่งซื้อตัวเลือกที่มี:- buy- sell

คำนิยาม

กรองตามคู่การซื้อขาย (เช่น `TRX_USDT`)

คำนิยาม

ปริมาณสินทรัพย์ฐานที่ร้องขอ

คำนิยาม

ปริมาณสินทรัพย์ฐานที่เติม

คำนิยาม

ปริมาณสินทรัพย์ที่เสนอราคาเต็ม

คำนิยาม

สถานะปัจจุบันของคำสั่งซื้อ (เช่น 'เสร็จสมบูรณ์')

คำนิยาม

สถานะภายในของคำสั่งซื้อ (เช่น 'เติมแล้ว')

คำนิยาม

เวลาที่คำสั่งซื้อถูกสร้างขึ้น

คำนิยาม

เวลาที่คำสั่งซื้อเสร็จสมบูรณ์

คำนิยาม

ราคาตลาดขั้นต่ำของสินทรัพย์ เมื่อถึงเกณฑ์ดังกล่าว คำสั่งจะถูกยกเลิกโดยอัตโนมัติ

พารามิเตอร์การตอบสนองข้อตกลง

ชื่อคำนิยาม
idรหัสการค้า
stateสถานะการค้า (เช่น 'เสร็จสมบูรณ์')
createdAtเวลาที่การค้าถูกสร้างขึ้น
completedAtเวลาที่การซื้อขายเสร็จสิ้น
averageFilledPriceราคาเฉลี่ยของการซื้อขาย

คำนิยาม

รหัสการค้า

คำนิยาม

สถานะการค้า (เช่น 'เสร็จสมบูรณ์')

คำนิยาม

เวลาที่การค้าถูกสร้างขึ้น

คำนิยาม

เวลาที่การซื้อขายเสร็จสิ้น

คำนิยาม

ราคาเฉลี่ยของการซื้อขาย

พารามิเตอร์การตอบสนองธุรกรรมข้อตกลง

ชื่อคำนิยาม
idรหัสธุรกรรม
tradeRoleบทบาทในการค้าตัวเลือกที่มี:• taker• maker
filledPriceราคาที่กรอกสำหรับการทำธุรกรรม
filledQuantityจำนวนเงินที่ดำเนินการในสกุลเงินฐาน
filledValueจำนวนเงินที่ดำเนินการในสกุลเงินอ้างอิง
feeค่าธรรมเนียมการทำธุรกรรม
feeCurrencyสกุลเงินที่ใช้ในการเรียกเก็บค่าธรรมเนียม
committedAtเวลาของการดำเนินการธุรกรรม

คำนิยาม

รหัสธุรกรรม

คำนิยาม

บทบาทในการค้าตัวเลือกที่มี:- taker- maker

คำนิยาม

ราคาที่กรอกสำหรับการทำธุรกรรม

คำนิยาม

จำนวนเงินที่ดำเนินการในสกุลเงินฐาน

คำนิยาม

จำนวนเงินที่ดำเนินการในสกุลเงินอ้างอิง

คำนิยาม

ค่าธรรมเนียมการทำธุรกรรม

คำนิยาม

สกุลเงินที่ใช้ในการเรียกเก็บค่าธรรมเนียม

คำนิยาม

เวลาของการดำเนินการธุรกรรม

ตัวอย่างการตอบกลับ


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
สำเนา

รหัสที่เป็นไปได้

404: ไม่พบผู้ใช้หรือทรัพยากร

422: ข้อมูลอินพุตไม่ถูกต้อง

500: ข้อผิดพลาดเซิร์ฟเวอร์ภายใน

การรวมกันที่เป็นไปได้

ชื่อคำนิยามสถานะภายใน
completedคำสั่งซื้อเสร็จสมบูรณ์และดำเนินการครบถ้วนเติมเต็ม
canceledคำสั่งซื้อไม่ได้รับการปฏิบัติตามและถูกยกเลิกโดยผู้ใช้ว่างเปล่า
canceled_by_stop_lossคำสั่งไม่ได้รับการเติมเต็มและถูกยกเลิกโดยอัตโนมัติเนื่องจากตลาดไปถึงราคา Stop_lossว่างเปล่า
canceledคำสั่งซื้อได้รับการกรอกบางส่วนแล้วและถูกยกเลิกโดยผู้ใช้เติมบางส่วน
canceled_by_stop_lossคำสั่งซื้อถูกดำเนินการบางส่วนแล้วและถูกยกเลิกโดยอัตโนมัติเนื่องจากตลาดไปถึงราคา Stop_lossเติมบางส่วน

คำนิยาม

คำสั่งซื้อเสร็จสมบูรณ์และดำเนินการครบถ้วน

คำนิยาม

คำสั่งซื้อไม่ได้รับการปฏิบัติตามและถูกยกเลิกโดยผู้ใช้

คำนิยาม

คำสั่งไม่ได้รับการเติมเต็มและถูกยกเลิกโดยอัตโนมัติเนื่องจากตลาดไปถึงราคา Stop_loss

คำนิยาม

คำสั่งซื้อได้รับการกรอกบางส่วนแล้วและถูกยกเลิกโดยผู้ใช้

คำนิยาม

คำสั่งซื้อถูกดำเนินการบางส่วนแล้วและถูกยกเลิกโดยอัตโนมัติเนื่องจากตลาดไปถึงราคา Stop_loss

ข้อผิดพลาดที่อาจเกิดขึ้น

ตัวอย่างคำตอบ:


1{
2  "state": 0,
3  "message": "Standard validation error"
4}
สำเนา

ตัวอย่างการตอบสนองที่มีข้อผิดพลาด


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}
สำเนา