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

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

คำนิยาม

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

การตอบสนอง

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

ชื่อประเภทพารามิเตอร์คำนิยาม
idstringรหัสคำสั่งซื้อในสมุดคำสั่งซื้อ
typestringประเภทคำสั่งซื้อตัวเลือกที่มี:• buy• sell
directionstringทิศทางการสั่งซื้อตัวเลือกที่มี:• buy• sell
symbolstringกรองตามคู่การซื้อขาย (เช่น `TRX_USDT`)
quantitystring|nullปริมาณสินทรัพย์ฐานที่ร้องขอ
filledQuantitystringปริมาณสินทรัพย์ฐานที่เติม
filledValuestringปริมาณสินทรัพย์ที่เสนอราคาเต็ม
statestringสถานะปัจจุบันของคำสั่งซื้อ (เช่น 'เสร็จสมบูรณ์')
internalStatestringสถานะภายในของคำสั่งซื้อ (เช่น 'เติมแล้ว')
createdAtstringเวลาที่คำสั่งซื้อถูกสร้างขึ้น
finishedAtstringเวลาที่คำสั่งซื้อเสร็จสมบูรณ์
stopLossPricestring|nullราคาตลาดขั้นต่ำของสินทรัพย์ เมื่อถึงเกณฑ์ดังกล่าว คำสั่งจะถูกยกเลิกโดยอัตโนมัติ

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

string

คำนิยาม

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

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

string

คำนิยาม

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

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

string

คำนิยาม

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

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

string

คำนิยาม

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

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

string|null

คำนิยาม

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

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

string

คำนิยาม

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

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

string

คำนิยาม

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

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

string

คำนิยาม

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

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

string

คำนิยาม

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

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

string

คำนิยาม

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

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

string

คำนิยาม

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

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

string|null

คำนิยาม

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

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

ชื่อประเภทพารามิเตอร์คำนิยาม
idstringรหัสการค้า
statestringสถานะการค้า (เช่น 'เสร็จสมบูรณ์')
createdAtstringเวลาที่การค้าถูกสร้างขึ้น
completedAtstringเวลาที่การซื้อขายเสร็จสิ้น
averageFilledPricestringราคาเฉลี่ยของการซื้อขาย

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

string

คำนิยาม

รหัสการค้า

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

string

คำนิยาม

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

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

string

คำนิยาม

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

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

string

คำนิยาม

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

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

string

คำนิยาม

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

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

ชื่อประเภทพารามิเตอร์คำนิยาม
idstringรหัสธุรกรรม
tradeRolestringบทบาทในการค้าตัวเลือกที่มี:• taker• maker
filledPricestringราคาที่กรอกสำหรับการทำธุรกรรม
filledQuantitystringจำนวนเงินที่ดำเนินการในสกุลเงินฐาน
filledValuestringจำนวนเงินที่ดำเนินการในสกุลเงินอ้างอิง
feestringค่าธรรมเนียมการทำธุรกรรม
feeCurrencystringสกุลเงินที่ใช้ในการเรียกเก็บค่าธรรมเนียม
committedAtstringเวลาของการดำเนินการธุรกรรม

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

string

คำนิยาม

รหัสธุรกรรม

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

string

คำนิยาม

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

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

string

คำนิยาม

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

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

string

คำนิยาม

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

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

string

คำนิยาม

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

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

string

คำนิยาม

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

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

string

คำนิยาม

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

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

string

คำนิยาม

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

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


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