tradingOrdersDocsPage.orderManagement
API ส่งและจัดการคำสั่ง
สร้าง ปิด ยกเลิก และแก้ไขคำสั่งผ่านเอนด์พอยต์การซื้อขาย Finger Trader ที่ยืนยันตัวตนแล้ว
เอนด์พอยต์เขียนคำสั่ง
เอนด์พอยต์เหล่านี้อาจส่งหรือเปลี่ยนคำสั่งจริง โปรดยืนยันบัญชี ตลาด ตราสาร ปริมาณ และกฎของโบรกเกอร์ก่อนทดลอง
คำขอ 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/create-order
ส่งคำขอสร้างคำสั่งใหม่
ตัวอย่างคำขอ
ค่าเหล่านี้ใช้เพื่ออธิบายเท่านั้น โปรดแทน ticker ตลาด รหัสบัญชี/คำสั่ง และรหัสโบรกเกอร์ด้วยค่าจากบัญชีของคุณ และยืนยันฟิลด์ที่จำเป็นกับโบรกเกอร์ก่อนส่ง
{
"ticker": "EURUSD",
"orderType": 1,
"orderSide": 1,
"qty": "1000",
"coinType": 0,
"walletType": 2,
"price": "1.08500",
"marginRate": 10,
"stopLoss": "1.07500",
"takeProfit": "1.09500",
"marketType": 0
}| พารามิเตอร์ | ชนิด | DTO ฝั่งไคลเอนต์ | อ้างอิง |
|---|---|---|---|
ticker | string | เป็น Null ได้ | Ticker / Symbol ที่โบรกเกอร์รองรับ |
orderType | integer | เป็น Null ได้ | ค่า enum การซื้อขาย |
orderSide | integer | เป็น Null ได้ | ค่า enum การซื้อขาย |
qty | decimal string | เป็น Null ได้ | — |
coinType | integer | เป็น Null ได้ | ค่า enum การซื้อขาย |
walletType | integer | เป็น Null ได้ | ค่า enum การซื้อขาย |
price | decimal string | เป็น Null ได้ | — |
marginRate | integer | เป็น Null ได้ | — |
stopLoss | decimal string | เป็น Null ได้ | — |
takeProfit | decimal string | เป็น Null ได้ | — |
marketType | integer | เป็น Null ได้ | ตลาดที่รองรับและรหัส marketType |
brokerId | integer | เป็น Null ได้ | — |
หมายความว่า Flutter DTO อนุญาตค่า null หรือไม่ส่ง ID บางรายการที่เป็นตัวเลือก ไม่ได้ยืนยันกฎตรวจสอบฝั่งเซิร์ฟเวอร์ โปรดยืนยันฟิลด์ที่จำเป็นกับโบรกเกอร์/ผู้ให้บริการ
ตัวอย่างการตอบกลับ
{"code":0,"data":true,"msg":""}ไคลเอนต์คาดว่า data จะเป็นผลลัพธ์ boolean
Try จะส่งคำขอจริงไปยังสภาพแวดล้อมที่เลือก และอาจสร้าง ปิด ยกเลิก หรือแก้ไขคำสั่ง โปรดใช้บัญชีทดสอบและสภาพแวดล้อมทดสอบที่โบรกเกอร์อนุมัติ
ทดลองส่งคำขอ REST · /app-api/v1/order/create-order
ป้อน Access Token และแก้ไขพารามิเตอร์คำขอ เมื่อส่งคำขอ เบราว์เซอร์จะเรียกสภาพแวดล้อม BFF อย่างเป็นทางการของ Finger Trader ที่เลือกโดยตรง
Try จะส่งคำขอจริงไปยังสภาพแวดล้อมที่เลือก และอาจสร้าง ปิด ยกเลิก หรือแก้ไขคำสั่ง โปรดใช้บัญชีทดสอบและสภาพแวดล้อมทดสอบที่โบรกเกอร์อนุมัติ
พร้อมใช้งาน จะไม่มีการส่งข้อมูลจนกว่าคุณจะกดส่งคำขอ
การตอบกลับจะแสดงที่นี่
Access Token จะอยู่ในหน่วยความจำของหน้านี้เท่านั้น ไม่บันทึกในพื้นที่จัดเก็บของเบราว์เซอร์หรือส่งไปยังเซิร์ฟเวอร์เว็บไซต์ Finger Trader ระบบจะส่ง Token ไปยัง API อย่างเป็นทางการที่เลือกหลังจากคุณกดส่งคำขอเท่านั้น
ปิดคำสั่ง
POST /app-api/v1/order/close-order
ส่งคำขอปิดสถานะ
ตัวอย่างคำขอ
ค่าเหล่านี้ใช้เพื่ออธิบายเท่านั้น โปรดแทน ticker ตลาด รหัสบัญชี/คำสั่ง และรหัสโบรกเกอร์ด้วยค่าจากบัญชีของคุณ และยืนยันฟิลด์ที่จำเป็นกับโบรกเกอร์ก่อนส่ง
{
"userId": "user_demo_12345",
"orderId": "order_demo_20250101_001",
"qty": "500",
"marketType": 0,
"brokerId": 10001,
"brokerPositionId": "position_demo_001",
"symbol": "EURUSD"
}| พารามิเตอร์ | ชนิด | DTO ฝั่งไคลเอนต์ | อ้างอิง |
|---|---|---|---|
userId | string | เป็น Null ได้ | — |
orderId | string | เป็น Null ได้ | — |
qty | decimal string | เป็น Null ได้ | — |
marketType | integer | เป็น Null ได้ | ตลาดที่รองรับและรหัส marketType |
brokerId | integer | เป็น Null ได้ | — |
brokerPositionId | string | เป็น Null ได้ | — |
symbol | string | เป็น Null ได้ | Ticker / Symbol ที่โบรกเกอร์รองรับ |
หมายความว่า Flutter DTO อนุญาตค่า null หรือไม่ส่ง ID บางรายการที่เป็นตัวเลือก ไม่ได้ยืนยันกฎตรวจสอบฝั่งเซิร์ฟเวอร์ โปรดยืนยันฟิลด์ที่จำเป็นกับโบรกเกอร์/ผู้ให้บริการ
ตัวอย่างการตอบกลับ
{"code":0,"data":true,"msg":""}ไคลเอนต์คาดว่า data จะเป็นผลลัพธ์ boolean
Try จะส่งคำขอจริงไปยังสภาพแวดล้อมที่เลือก และอาจสร้าง ปิด ยกเลิก หรือแก้ไขคำสั่ง โปรดใช้บัญชีทดสอบและสภาพแวดล้อมทดสอบที่โบรกเกอร์อนุมัติ
ทดลองส่งคำขอ REST · /app-api/v1/order/close-order
ป้อน Access Token และแก้ไขพารามิเตอร์คำขอ เมื่อส่งคำขอ เบราว์เซอร์จะเรียกสภาพแวดล้อม BFF อย่างเป็นทางการของ Finger Trader ที่เลือกโดยตรง
Try จะส่งคำขอจริงไปยังสภาพแวดล้อมที่เลือก และอาจสร้าง ปิด ยกเลิก หรือแก้ไขคำสั่ง โปรดใช้บัญชีทดสอบและสภาพแวดล้อมทดสอบที่โบรกเกอร์อนุมัติ
พร้อมใช้งาน จะไม่มีการส่งข้อมูลจนกว่าคุณจะกดส่งคำขอ
การตอบกลับจะแสดงที่นี่
Access Token จะอยู่ในหน่วยความจำของหน้านี้เท่านั้น ไม่บันทึกในพื้นที่จัดเก็บของเบราว์เซอร์หรือส่งไปยังเซิร์ฟเวอร์เว็บไซต์ Finger Trader ระบบจะส่ง Token ไปยัง API อย่างเป็นทางการที่เลือกหลังจากคุณกดส่งคำขอเท่านั้น
ยกเลิกคำสั่ง Limit
POST /app-api/v1/order/cancel-order
ส่งคำขอยกเลิกคำสั่ง Limit
ตัวอย่างคำขอ
ค่าเหล่านี้ใช้เพื่ออธิบายเท่านั้น โปรดแทน ticker ตลาด รหัสบัญชี/คำสั่ง และรหัสโบรกเกอร์ด้วยค่าจากบัญชีของคุณ และยืนยันฟิลด์ที่จำเป็นกับโบรกเกอร์ก่อนส่ง
{
"userId": "user_demo_12345",
"orderId": "order_demo_20250101_002",
"marketType": 0,
"brokerId": 10001,
"brokerOrderId": "broker_order_demo_002",
"clientOrderId": "client_order_demo_002"
}| พารามิเตอร์ | ชนิด | DTO ฝั่งไคลเอนต์ | อ้างอิง |
|---|---|---|---|
userId | string | เป็น Null ได้ | — |
orderId | string | เป็น Null ได้ | — |
marketType | integer | เป็น Null ได้ | ตลาดที่รองรับและรหัส marketType |
brokerId | integer | เป็น Null ได้ | — |
brokerOrderId | string | เป็น Null ได้ | — |
clientOrderId | string | เป็น Null ได้ | — |
หมายความว่า Flutter DTO อนุญาตค่า null หรือไม่ส่ง ID บางรายการที่เป็นตัวเลือก ไม่ได้ยืนยันกฎตรวจสอบฝั่งเซิร์ฟเวอร์ โปรดยืนยันฟิลด์ที่จำเป็นกับโบรกเกอร์/ผู้ให้บริการ
ตัวอย่างการตอบกลับ
{"code":0,"data":true,"msg":""}ไคลเอนต์คาดว่า data จะเป็นผลลัพธ์ boolean
Try จะส่งคำขอจริงไปยังสภาพแวดล้อมที่เลือก และอาจสร้าง ปิด ยกเลิก หรือแก้ไขคำสั่ง โปรดใช้บัญชีทดสอบและสภาพแวดล้อมทดสอบที่โบรกเกอร์อนุมัติ
ทดลองส่งคำขอ REST · /app-api/v1/order/cancel-order
ป้อน Access Token และแก้ไขพารามิเตอร์คำขอ เมื่อส่งคำขอ เบราว์เซอร์จะเรียกสภาพแวดล้อม BFF อย่างเป็นทางการของ Finger Trader ที่เลือกโดยตรง
Try จะส่งคำขอจริงไปยังสภาพแวดล้อมที่เลือก และอาจสร้าง ปิด ยกเลิก หรือแก้ไขคำสั่ง โปรดใช้บัญชีทดสอบและสภาพแวดล้อมทดสอบที่โบรกเกอร์อนุมัติ
พร้อมใช้งาน จะไม่มีการส่งข้อมูลจนกว่าคุณจะกดส่งคำขอ
การตอบกลับจะแสดงที่นี่
Access Token จะอยู่ในหน่วยความจำของหน้านี้เท่านั้น ไม่บันทึกในพื้นที่จัดเก็บของเบราว์เซอร์หรือส่งไปยังเซิร์ฟเวอร์เว็บไซต์ Finger Trader ระบบจะส่ง Token ไปยัง API อย่างเป็นทางการที่เลือกหลังจากคุณกดส่งคำขอเท่านั้น
แก้ไข Stop Loss / Take Profit
POST /app-api/v1/order/modify-stop-profit-loss
ส่งคำขอแก้ไข Stop Loss หรือ Take Profit
ตัวอย่างคำขอ
ค่าเหล่านี้ใช้เพื่ออธิบายเท่านั้น โปรดแทน ticker ตลาด รหัสบัญชี/คำสั่ง และรหัสโบรกเกอร์ด้วยค่าจากบัญชีของคุณ และยืนยันฟิลด์ที่จำเป็นกับโบรกเกอร์ก่อนส่ง
{
"userId": "user_demo_12345",
"orderId": "order_demo_20250101_003",
"qty": "1000",
"price": "1.08600",
"stopLose": "1.07600",
"stopProfit": "1.09600",
"clearStopLoss": false,
"clearTakeProfit": false
}| พารามิเตอร์ | ชนิด | DTO ฝั่งไคลเอนต์ | อ้างอิง |
|---|---|---|---|
userId | string | เป็น Null ได้ | — |
orderId | string | เป็น Null ได้ | — |
qty | decimal string | เป็น Null ได้ | — |
price | decimal string | เป็น Null ได้ | — |
stopLose | decimal string | เป็น Null ได้ | — |
stopProfit | decimal string | เป็น Null ได้ | — |
clearStopLoss | boolean | เป็น Null ได้ | — |
clearTakeProfit | boolean | เป็น Null ได้ | — |
หมายความว่า Flutter DTO อนุญาตค่า null หรือไม่ส่ง ID บางรายการที่เป็นตัวเลือก ไม่ได้ยืนยันกฎตรวจสอบฝั่งเซิร์ฟเวอร์ โปรดยืนยันฟิลด์ที่จำเป็นกับโบรกเกอร์/ผู้ให้บริการ
ตัวอย่างการตอบกลับ
{"code":0,"data":true,"msg":""}ไคลเอนต์คาดว่า data จะเป็นผลลัพธ์ boolean
Try จะส่งคำขอจริงไปยังสภาพแวดล้อมที่เลือก และอาจสร้าง ปิด ยกเลิก หรือแก้ไขคำสั่ง โปรดใช้บัญชีทดสอบและสภาพแวดล้อมทดสอบที่โบรกเกอร์อนุมัติ
ทดลองส่งคำขอ REST · /app-api/v1/order/modify-stop-profit-loss
ป้อน Access Token และแก้ไขพารามิเตอร์คำขอ เมื่อส่งคำขอ เบราว์เซอร์จะเรียกสภาพแวดล้อม BFF อย่างเป็นทางการของ Finger Trader ที่เลือกโดยตรง
Try จะส่งคำขอจริงไปยังสภาพแวดล้อมที่เลือก และอาจสร้าง ปิด ยกเลิก หรือแก้ไขคำสั่ง โปรดใช้บัญชีทดสอบและสภาพแวดล้อมทดสอบที่โบรกเกอร์อนุมัติ
พร้อมใช้งาน จะไม่มีการส่งข้อมูลจนกว่าคุณจะกดส่งคำขอ
การตอบกลับจะแสดงที่นี่
Access Token จะอยู่ในหน่วยความจำของหน้านี้เท่านั้น ไม่บันทึกในพื้นที่จัดเก็บของเบราว์เซอร์หรือส่งไปยังเซิร์ฟเวอร์เว็บไซต์ Finger Trader ระบบจะส่ง Token ไปยัง API อย่างเป็นทางการที่เลือกหลังจากคุณกดส่งคำขอเท่านั้น