FINGER TRADER

tradingOrdersDocsPage.orderManagement

API ส่งและจัดการคำสั่ง

สร้าง ปิด ยกเลิก และแก้ไขคำสั่งผ่านเอนด์พอยต์การซื้อขาย Finger Trader ที่ยืนยันตัวตนแล้ว

โครงสร้างเอกสาร · ภาพรวม

เอนด์พอยต์เขียนคำสั่ง

เอนด์พอยต์เหล่านี้อาจส่งหรือเปลี่ยนคำสั่งจริง โปรดยืนยันบัญชี ตลาด ตราสาร ปริมาณ และกฎของโบรกเกอร์ก่อนทดลอง

คำขอ POST พร้อม Bearer Access Token และเนื้อหา JSON แอป Flutter เรียก Finger Trader App BFF ที่ยืนยันตัวตนแล้ว เริ่มต้นใช้งาน: การยืนยันตัวตน

Base URL App BFF สำหรับ productionhttps://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

POST

ส่งคำขอสร้างคำสั่งใหม่

ตัวอย่างคำขอ

ค่าเหล่านี้ใช้เพื่ออธิบายเท่านั้น โปรดแทน 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 ฝั่งไคลเอนต์อ้างอิง
tickerstringเป็น Null ได้Ticker / Symbol ที่โบรกเกอร์รองรับ
orderTypeintegerเป็น Null ได้ค่า enum การซื้อขาย
orderSideintegerเป็น Null ได้ค่า enum การซื้อขาย
qtydecimal stringเป็น Null ได้—
coinTypeintegerเป็น Null ได้ค่า enum การซื้อขาย
walletTypeintegerเป็น Null ได้ค่า enum การซื้อขาย
pricedecimal stringเป็น Null ได้—
marginRateintegerเป็น Null ได้—
stopLossdecimal stringเป็น Null ได้—
takeProfitdecimal stringเป็น Null ได้—
marketTypeintegerเป็น Null ได้ตลาดที่รองรับและรหัส marketType
brokerIdintegerเป็น 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

POST

ส่งคำขอปิดสถานะ

ตัวอย่างคำขอ

ค่าเหล่านี้ใช้เพื่ออธิบายเท่านั้น โปรดแทน ticker ตลาด รหัสบัญชี/คำสั่ง และรหัสโบรกเกอร์ด้วยค่าจากบัญชีของคุณ และยืนยันฟิลด์ที่จำเป็นกับโบรกเกอร์ก่อนส่ง

{
  "userId": "user_demo_12345",
  "orderId": "order_demo_20250101_001",
  "qty": "500",
  "marketType": 0,
  "brokerId": 10001,
  "brokerPositionId": "position_demo_001",
  "symbol": "EURUSD"
}
พารามิเตอร์คำขอ
พารามิเตอร์ชนิดDTO ฝั่งไคลเอนต์อ้างอิง
userIdstringเป็น Null ได้—
orderIdstringเป็น Null ได้—
qtydecimal stringเป็น Null ได้—
marketTypeintegerเป็น Null ได้ตลาดที่รองรับและรหัส marketType
brokerIdintegerเป็น Null ได้—
brokerPositionIdstringเป็น Null ได้—
symbolstringเป็น 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

POST

ส่งคำขอยกเลิกคำสั่ง 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 ฝั่งไคลเอนต์อ้างอิง
userIdstringเป็น Null ได้—
orderIdstringเป็น Null ได้—
marketTypeintegerเป็น Null ได้ตลาดที่รองรับและรหัส marketType
brokerIdintegerเป็น Null ได้—
brokerOrderIdstringเป็น Null ได้—
clientOrderIdstringเป็น 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

POST

ส่งคำขอแก้ไข 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 ฝั่งไคลเอนต์อ้างอิง
userIdstringเป็น Null ได้—
orderIdstringเป็น Null ได้—
qtydecimal stringเป็น Null ได้—
pricedecimal stringเป็น Null ได้—
stopLosedecimal stringเป็น Null ได้—
stopProfitdecimal stringเป็น Null ได้—
clearStopLossbooleanเป็น Null ได้—
clearTakeProfitbooleanเป็น 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 อย่างเป็นทางการที่เลือกหลังจากคุณกดส่งคำขอเท่านั้น