tradingOrdersDocsPage.orders
API ค้นหาคำสั่ง
ใช้ API การซื้อขายที่ยืนยันตัวตนแล้วเพื่อดูสถานะที่ถืออยู่ ประวัติการซื้อขาย คำสั่งที่เสร็จแล้ว และสถิติ
เอนด์พอยต์ค้นหาคำสั่ง
คำขอรายการใช้ page, pageSize และออบเจ็กต์ query แบบซ้อนกัน การตอบกลับมี items และข้อมูลการแบ่งหน้า ตัวกรองและข้อมูลที่บัญชีดูได้ขึ้นกับการตั้งค่าของโบรกเกอร์และบริการ
โมเดล PageQuery ของไคลเอนต์กำหนดให้มี page และ pageSize ส่วนตัวกรอง query เป็น null ได้ ขนาดหน้าสูงสุดและการทำงานของ cursor ขึ้นกับการตั้งค่าบริการ
คำขอ POST พร้อม Bearer Access Token และเนื้อหา JSON แอป Flutter เรียก Finger Trader App BFF ที่ยืนยันตัวตนแล้ว เริ่มต้นใช้งาน: การยืนยันตัวตน
https://prod-api.fingertrader.com/finger-bff-appส่วนหัวการยืนยันตัวตนAuthorization: Bearer <ACCESS_TOKEN>ต้องเปิดใช้งานบัญชี Finger Trader และเปิดบัญชีกับโบรกเกอร์ในระบบนิเวศ Finger ใช้ Bearer Access Token ตามเอกสาร Getting Started
การตอบกลับสำเร็จใช้โครงสร้างมาตรฐานของ Finger Trader ได้แก่ code, data และ msg ตัวอย่างแต่ละเอนด์พอยต์แสดงโครงสร้าง data ที่ Flutter client อ่าน
สถานะที่ถืออยู่
POST /app-api/v1/order/get-holding-orders
ส่งคืนหน้ารายการสถานะที่ถืออยู่ของบัญชี
ตัวอย่างคำขอ
ค่าเหล่านี้ใช้เพื่ออธิบายเท่านั้น โปรดแทน ticker ตลาด รหัสบัญชี/คำสั่ง และรหัสโบรกเกอร์ด้วยค่าจากบัญชีของคุณ และยืนยันฟิลด์ที่จำเป็นกับโบรกเกอร์ก่อนส่ง
{
"page": 1,
"pageSize": 20,
"query": {
"walletType": 2,
"marketType": 0,
"orderType": 1,
"coinType": 0,
"orderSide": 1,
"startTime": 1735689600000,
"endTime": 1735776000000
}
}| พารามิเตอร์ | ชนิด | DTO ฝั่งไคลเอนต์ | อ้างอิง |
|---|---|---|---|
page | integer | จำเป็นตามโมเดลไคลเอนต์ | — |
pageSize | integer | จำเป็นตามโมเดลไคลเอนต์ | — |
query | object | จำเป็นตามโมเดลไคลเอนต์ | — |
query.nextCursor | string | null | เป็น Null ได้ | — |
query.brokerId | integer | null | เป็น Null ได้ | — |
query.walletType | integer | null | เป็น Null ได้ | ค่า enum การซื้อขาย |
query.marketType | integer | null | เป็น Null ได้ | ตลาดที่รองรับและรหัส marketType |
query.orderType | integer | null | เป็น Null ได้ | ค่า enum การซื้อขาย |
query.coinType | integer | null | เป็น Null ได้ | ค่า enum การซื้อขาย |
query.orderSide | integer | null | เป็น Null ได้ | ค่า enum การซื้อขาย |
query.startTime | integer | null | เป็น Null ได้ | — |
query.endTime | integer | null | เป็น Null ได้ | — |
หมายความว่า Flutter DTO อนุญาตค่า null หรือไม่ส่ง ID บางรายการที่เป็นตัวเลือก ไม่ได้ยืนยันกฎตรวจสอบฝั่งเซิร์ฟเวอร์ โปรดยืนยันฟิลด์ที่จำเป็นกับโบรกเกอร์/ผู้ให้บริการ
ตัวอย่างการตอบกลับ
{"code":0,"data":{"total":1,"items":[{
"ticker": "<broker-supported ticker>",
"orderId": "<order id>",
"marketType": 0,
"orderType": 0,
"orderSide": 1,
"qty": "<decimal>",
"price": "<decimal>",
"status": "<broker response status>",
"filledQuantity": "<decimal>",
"averagePrice": "<decimal>",
"createTime": 0
}],"page":1,"pageSize":20,"nextCursor":null},"msg":""}data เป็นผลลัพธ์แบบแบ่งหน้าที่มี total, items, page, pageSize และ nextCursor แต่ละรายการอาจมีค่า null และฟิลด์ของโบรกเกอร์
ทดลองส่งคำขอ REST · /app-api/v1/order/get-holding-orders
ป้อน Access Token และแก้ไขพารามิเตอร์คำขอ เมื่อส่งคำขอ เบราว์เซอร์จะเรียกสภาพแวดล้อม BFF อย่างเป็นทางการของ Finger Trader ที่เลือกโดยตรง
พร้อมใช้งาน จะไม่มีการส่งข้อมูลจนกว่าคุณจะกดส่งคำขอ
การตอบกลับจะแสดงที่นี่
Access Token จะอยู่ในหน่วยความจำของหน้านี้เท่านั้น ไม่บันทึกในพื้นที่จัดเก็บของเบราว์เซอร์หรือส่งไปยังเซิร์ฟเวอร์เว็บไซต์ Finger Trader ระบบจะส่ง Token ไปยัง API อย่างเป็นทางการที่เลือกหลังจากคุณกดส่งคำขอเท่านั้น
ประวัติการซื้อขาย
POST /app-api/v1/order/trade-history
ส่งคืนหน้าประวัติการซื้อขายของบัญชี
ตัวอย่างคำขอ
ค่าเหล่านี้ใช้เพื่ออธิบายเท่านั้น โปรดแทน ticker ตลาด รหัสบัญชี/คำสั่ง และรหัสโบรกเกอร์ด้วยค่าจากบัญชีของคุณ และยืนยันฟิลด์ที่จำเป็นกับโบรกเกอร์ก่อนส่ง
{
"page": 1,
"pageSize": 20,
"query": {
"walletType": 2,
"marketType": 0,
"orderType": 1,
"coinType": 0,
"orderSide": 1,
"startTime": 1735689600000,
"endTime": 1735776000000
}
}| พารามิเตอร์ | ชนิด | DTO ฝั่งไคลเอนต์ | อ้างอิง |
|---|---|---|---|
page | integer | จำเป็นตามโมเดลไคลเอนต์ | — |
pageSize | integer | จำเป็นตามโมเดลไคลเอนต์ | — |
query | object | จำเป็นตามโมเดลไคลเอนต์ | — |
query.nextCursor | string | null | เป็น Null ได้ | — |
query.brokerId | integer | null | เป็น Null ได้ | — |
query.walletType | integer | null | เป็น Null ได้ | ค่า enum การซื้อขาย |
query.marketType | integer | null | เป็น Null ได้ | ตลาดที่รองรับและรหัส marketType |
query.orderType | integer | null | เป็น Null ได้ | ค่า enum การซื้อขาย |
query.coinType | integer | null | เป็น Null ได้ | ค่า enum การซื้อขาย |
query.orderSide | integer | null | เป็น Null ได้ | ค่า enum การซื้อขาย |
query.startTime | integer | null | เป็น Null ได้ | — |
query.endTime | integer | null | เป็น Null ได้ | — |
หมายความว่า Flutter DTO อนุญาตค่า null หรือไม่ส่ง ID บางรายการที่เป็นตัวเลือก ไม่ได้ยืนยันกฎตรวจสอบฝั่งเซิร์ฟเวอร์ โปรดยืนยันฟิลด์ที่จำเป็นกับโบรกเกอร์/ผู้ให้บริการ
ตัวอย่างการตอบกลับ
{"code":0,"data":{"total":1,"items":[{
"ticker": "<broker-supported ticker>",
"orderId": "<order id>",
"marketType": 0,
"orderType": 0,
"orderSide": 1,
"qty": "<decimal>",
"price": "<decimal>",
"status": "<broker response status>",
"filledQuantity": "<decimal>",
"averagePrice": "<decimal>",
"createTime": 0
}],"page":1,"pageSize":20,"nextCursor":null},"msg":""}data เป็นผลลัพธ์แบบแบ่งหน้าที่มี total, items, page, pageSize และ nextCursor แต่ละรายการอาจมีค่า null และฟิลด์ของโบรกเกอร์
ทดลองส่งคำขอ REST · /app-api/v1/order/trade-history
ป้อน Access Token และแก้ไขพารามิเตอร์คำขอ เมื่อส่งคำขอ เบราว์เซอร์จะเรียกสภาพแวดล้อม BFF อย่างเป็นทางการของ Finger Trader ที่เลือกโดยตรง
พร้อมใช้งาน จะไม่มีการส่งข้อมูลจนกว่าคุณจะกดส่งคำขอ
การตอบกลับจะแสดงที่นี่
Access Token จะอยู่ในหน่วยความจำของหน้านี้เท่านั้น ไม่บันทึกในพื้นที่จัดเก็บของเบราว์เซอร์หรือส่งไปยังเซิร์ฟเวอร์เว็บไซต์ Finger Trader ระบบจะส่ง Token ไปยัง API อย่างเป็นทางการที่เลือกหลังจากคุณกดส่งคำขอเท่านั้น
คำสั่งที่เสร็จแล้ว
POST /app-api/v1/order/completed-orders
ส่งคืนหน้าคำสั่งที่เสร็จแล้วของบัญชี
ตัวอย่างคำขอ
ค่าเหล่านี้ใช้เพื่ออธิบายเท่านั้น โปรดแทน ticker ตลาด รหัสบัญชี/คำสั่ง และรหัสโบรกเกอร์ด้วยค่าจากบัญชีของคุณ และยืนยันฟิลด์ที่จำเป็นกับโบรกเกอร์ก่อนส่ง
{
"page": 1,
"pageSize": 20,
"query": {
"walletType": 2,
"marketType": 0,
"orderType": 1,
"coinType": 0,
"orderSide": 1,
"startTime": 1735689600000,
"endTime": 1735776000000
}
}| พารามิเตอร์ | ชนิด | DTO ฝั่งไคลเอนต์ | อ้างอิง |
|---|---|---|---|
page | integer | จำเป็นตามโมเดลไคลเอนต์ | — |
pageSize | integer | จำเป็นตามโมเดลไคลเอนต์ | — |
query | object | จำเป็นตามโมเดลไคลเอนต์ | — |
query.nextCursor | string | null | เป็น Null ได้ | — |
query.brokerId | integer | null | เป็น Null ได้ | — |
query.walletType | integer | null | เป็น Null ได้ | ค่า enum การซื้อขาย |
query.marketType | integer | null | เป็น Null ได้ | ตลาดที่รองรับและรหัส marketType |
query.orderType | integer | null | เป็น Null ได้ | ค่า enum การซื้อขาย |
query.coinType | integer | null | เป็น Null ได้ | ค่า enum การซื้อขาย |
query.orderSide | integer | null | เป็น Null ได้ | ค่า enum การซื้อขาย |
query.startTime | integer | null | เป็น Null ได้ | — |
query.endTime | integer | null | เป็น Null ได้ | — |
หมายความว่า Flutter DTO อนุญาตค่า null หรือไม่ส่ง ID บางรายการที่เป็นตัวเลือก ไม่ได้ยืนยันกฎตรวจสอบฝั่งเซิร์ฟเวอร์ โปรดยืนยันฟิลด์ที่จำเป็นกับโบรกเกอร์/ผู้ให้บริการ
ตัวอย่างการตอบกลับ
{"code":0,"data":{"total":1,"items":[{
"ticker": "<broker-supported ticker>",
"orderId": "<order id>",
"marketType": 0,
"orderType": 0,
"orderSide": 1,
"qty": "<decimal>",
"price": "<decimal>",
"status": "<broker response status>",
"filledQuantity": "<decimal>",
"averagePrice": "<decimal>",
"createTime": 0
}],"page":1,"pageSize":20,"nextCursor":null},"msg":""}data เป็นผลลัพธ์แบบแบ่งหน้าที่มี total, items, page, pageSize และ nextCursor แต่ละรายการอาจมีค่า null และฟิลด์ของโบรกเกอร์
ทดลองส่งคำขอ REST · /app-api/v1/order/completed-orders
ป้อน Access Token และแก้ไขพารามิเตอร์คำขอ เมื่อส่งคำขอ เบราว์เซอร์จะเรียกสภาพแวดล้อม BFF อย่างเป็นทางการของ Finger Trader ที่เลือกโดยตรง
พร้อมใช้งาน จะไม่มีการส่งข้อมูลจนกว่าคุณจะกดส่งคำขอ
การตอบกลับจะแสดงที่นี่
Access Token จะอยู่ในหน่วยความจำของหน้านี้เท่านั้น ไม่บันทึกในพื้นที่จัดเก็บของเบราว์เซอร์หรือส่งไปยังเซิร์ฟเวอร์เว็บไซต์ Finger Trader ระบบจะส่ง Token ไปยัง API อย่างเป็นทางการที่เลือกหลังจากคุณกดส่งคำขอเท่านั้น
สถิติประวัติการซื้อขาย
POST /app-api/v1/order/trade-history-stat
ส่งคืนออบเจ็กต์สถิติประวัติการซื้อขาย
ตัวอย่างคำขอ
ค่าเหล่านี้ใช้เพื่ออธิบายเท่านั้น โปรดแทน ticker ตลาด รหัสบัญชี/คำสั่ง และรหัสโบรกเกอร์ด้วยค่าจากบัญชีของคุณ และยืนยันฟิลด์ที่จำเป็นกับโบรกเกอร์ก่อนส่ง
{
"walletType": 2,
"marketType": 0,
"orderType": 1,
"coinType": 0,
"orderSide": 1,
"startTime": 1735689600000,
"endTime": 1735776000000
}| พารามิเตอร์ | ชนิด | DTO ฝั่งไคลเอนต์ | อ้างอิง |
|---|---|---|---|
query.nextCursor | string | null | เป็น Null ได้ | — |
query.brokerId | integer | null | เป็น Null ได้ | — |
query.walletType | integer | null | เป็น Null ได้ | ค่า enum การซื้อขาย |
query.marketType | integer | null | เป็น Null ได้ | ตลาดที่รองรับและรหัส marketType |
query.orderType | integer | null | เป็น Null ได้ | ค่า enum การซื้อขาย |
query.coinType | integer | null | เป็น Null ได้ | ค่า enum การซื้อขาย |
query.orderSide | integer | null | เป็น Null ได้ | ค่า enum การซื้อขาย |
query.startTime | integer | null | เป็น Null ได้ | — |
query.endTime | integer | null | เป็น Null ได้ | — |
Flutter client แปลง startTime และ endTime เป็น Unix timestamp UTC หน่วยมิลลิวินาที
หมายความว่า Flutter DTO อนุญาตค่า null หรือไม่ส่ง ID บางรายการที่เป็นตัวเลือก ไม่ได้ยืนยันกฎตรวจสอบฝั่งเซิร์ฟเวอร์ โปรดยืนยันฟิลด์ที่จำเป็นกับโบรกเกอร์/ผู้ให้บริการ
ตัวอย่างการตอบกลับ
{"code":0,"data":{"totalProfile":"<decimal>"},"msg":""}เมื่อบริการส่งกลับ ออบเจ็กต์ data จะมี totalProfile
ทดลองส่งคำขอ REST · /app-api/v1/order/trade-history-stat
ป้อน Access Token และแก้ไขพารามิเตอร์คำขอ เมื่อส่งคำขอ เบราว์เซอร์จะเรียกสภาพแวดล้อม BFF อย่างเป็นทางการของ Finger Trader ที่เลือกโดยตรง
พร้อมใช้งาน จะไม่มีการส่งข้อมูลจนกว่าคุณจะกดส่งคำขอ
การตอบกลับจะแสดงที่นี่
Access Token จะอยู่ในหน่วยความจำของหน้านี้เท่านั้น ไม่บันทึกในพื้นที่จัดเก็บของเบราว์เซอร์หรือส่งไปยังเซิร์ฟเวอร์เว็บไซต์ Finger Trader ระบบจะส่ง Token ไปยัง API อย่างเป็นทางการที่เลือกหลังจากคุณกดส่งคำขอเท่านั้น