brokerageDocsPage.orders
API จัดการคำสั่ง
API ฝั่งโบรกเกอร์สำหรับตรวจสอบสถานะและประวัติคำสั่งของลูกค้า รายการคำสั่งตลาด และการดำเนินการที่ได้รับอนุญาต
การยืนยันตัวตนและสิทธิ์เข้าถึง
ต้องใช้เซสชันพนักงานโบรกเกอร์/ร้านค้าที่ผ่านการยืนยันตัวตนและสิทธิ์ backend ที่เกี่ยวข้อง Token ของผู้ใช้แอปซื้อขายทั่วไปใช้ยืนยันตัวตนที่นี่ไม่ได้ โปรดยืนยันสิทธิ์กับผู้ดูแลโบรกเกอร์
ส่งคำขอ POST แบบ JSON ไปยังสภาพแวดล้อม Merchant BFF ที่เลือก Finger Admin ส่ง Access Token ของพนักงานโบรกเกอร์ที่เข้าสู่ระบบในส่วนหัว Authorization ในรูปแบบ Bearer
Authorization: Bearer <BROKER_STAFF_ACCESS_TOKEN>
ค่าเป็นตัวอย่าง โปรดแทนรหัสด้วยค่าจากบัญชีที่ได้รับสิทธิ์ โครงสร้างการตอบกลับเป็นตัวอย่างที่อนุมานจากการใช้งาน API ของ Finger Admin โปรดยืนยันสัญญา API ที่ถูกต้องกับโบรกเกอร์ คำขอตั้งค่าหรือคำสั่งอาจเปลี่ยนข้อมูลจริง
API ในหมวดนี้
Order pool, customer positions and history, grouped history, export, and order action endpoints used by Finger Admin.
Market order pool
Queries the market order pool using MarketQueryDTO.
/mer-api/v1/order/market-order-listตัวอย่างคำขอ
{
"marketType": 0
}ฟิลด์คำขอ
marketTypenumberตัวอย่างการตอบกลับ
ค่าเป็นตัวอย่าง โปรดแทนรหัสด้วยค่าจากบัญชีที่ได้รับสิทธิ์ โครงสร้างการตอบกลับเป็นตัวอย่างที่อนุมานจากการใช้งาน API ของ Finger Admin โปรดยืนยันสัญญา API ที่ถูกต้องกับโบรกเกอร์ คำขอตั้งค่าหรือคำสั่งอาจเปลี่ยนข้อมูลจริง
{
"code": 0,
"data": {
"total": 1,
"items": [
{
"id": "sample-id",
"userNumber": "U10001",
"status": 1
}
]
},
"msg": "success"
}ลองส่งคำขอนี้ · /mer-api/v1/order/market-order-list
พร้อมใช้งาน คำขอจะยังไม่ถูกส่งจนกว่าจะกดส่ง
การตอบกลับ—
Token ใช้เฉพาะในเซสชันหน้านี้และเอกสารจะไม่บันทึกไว้ หลีกเลี่ยงอุปกรณ์สาธารณะและล้าง Token เมื่อเสร็จแล้ว
Market ticker/order data
Paged market data list; TickerListQueryDTO filters by marketType.
/mer-api/v1/order/market-data-listตัวอย่างคำขอ
{
"page": 1,
"pageSize": 20,
"query": {
"marketType": 0
}
}ฟิลด์คำขอ
pagenumberpageSizenumberqueryobjectตัวอย่างการตอบกลับ
ค่าเป็นตัวอย่าง โปรดแทนรหัสด้วยค่าจากบัญชีที่ได้รับสิทธิ์ โครงสร้างการตอบกลับเป็นตัวอย่างที่อนุมานจากการใช้งาน API ของ Finger Admin โปรดยืนยันสัญญา API ที่ถูกต้องกับโบรกเกอร์ คำขอตั้งค่าหรือคำสั่งอาจเปลี่ยนข้อมูลจริง
{
"code": 0,
"data": {
"total": 1,
"items": [
{
"id": "sample-id",
"userNumber": "U10001",
"status": 1
}
]
},
"msg": "success"
}ลองส่งคำขอนี้ · /mer-api/v1/order/market-data-list
พร้อมใช้งาน คำขอจะยังไม่ถูกส่งจนกว่าจะกดส่ง
การตอบกลับ—
Token ใช้เฉพาะในเซสชันหน้านี้และเอกสารจะไม่บันทึกไว้ หลีกเลี่ยงอุปกรณ์สาธารณะและล้าง Token เมื่อเสร็จแล้ว
Customer open positions
Paged customer holdings query.
/mer-api/v1/order/get-user-order-holding-listตัวอย่างคำขอ
{
"page": 1,
"pageSize": 20,
"query": {
"userNumber": "",
"brokerNumber": "",
"marketType": 0,
"startTime": "",
"endTime": ""
}
}ฟิลด์คำขอ
pagenumberpageSizenumberqueryobjectตัวอย่างการตอบกลับ
ค่าเป็นตัวอย่าง โปรดแทนรหัสด้วยค่าจากบัญชีที่ได้รับสิทธิ์ โครงสร้างการตอบกลับเป็นตัวอย่างที่อนุมานจากการใช้งาน API ของ Finger Admin โปรดยืนยันสัญญา API ที่ถูกต้องกับโบรกเกอร์ คำขอตั้งค่าหรือคำสั่งอาจเปลี่ยนข้อมูลจริง
{
"code": 0,
"data": {
"total": 1,
"items": [
{
"id": "sample-id",
"userNumber": "U10001",
"status": 1
}
]
},
"msg": "success"
}ลองส่งคำขอนี้ · /mer-api/v1/order/get-user-order-holding-list
พร้อมใช้งาน คำขอจะยังไม่ถูกส่งจนกว่าจะกดส่ง
การตอบกลับ—
Token ใช้เฉพาะในเซสชันหน้านี้และเอกสารจะไม่บันทึกไว้ หลีกเลี่ยงอุปกรณ์สาธารณะและล้าง Token เมื่อเสร็จแล้ว
Customer order history
Paged order history for a customer or broker query.
/mer-api/v1/order/get-user-order-history-listตัวอย่างคำขอ
{
"page": 1,
"pageSize": 20,
"query": {
"userNumber": "",
"brokerNumber": "",
"marketType": 0,
"startTime": "",
"endTime": ""
}
}ฟิลด์คำขอ
pagenumberpageSizenumberqueryobjectตัวอย่างการตอบกลับ
ค่าเป็นตัวอย่าง โปรดแทนรหัสด้วยค่าจากบัญชีที่ได้รับสิทธิ์ โครงสร้างการตอบกลับเป็นตัวอย่างที่อนุมานจากการใช้งาน API ของ Finger Admin โปรดยืนยันสัญญา API ที่ถูกต้องกับโบรกเกอร์ คำขอตั้งค่าหรือคำสั่งอาจเปลี่ยนข้อมูลจริง
{
"code": 0,
"data": {
"total": 1,
"items": [
{
"id": "sample-id",
"userNumber": "U10001",
"status": 1
}
]
},
"msg": "success"
}ลองส่งคำขอนี้ · /mer-api/v1/order/get-user-order-history-list
พร้อมใช้งาน คำขอจะยังไม่ถูกส่งจนกว่าจะกดส่ง
การตอบกลับ—
Token ใช้เฉพาะในเซสชันหน้านี้และเอกสารจะไม่บันทึกไว้ หลีกเลี่ยงอุปกรณ์สาธารณะและล้าง Token เมื่อเสร็จแล้ว
Grouped customer order history
Paged grouped history query.
/mer-api/v1/order/get-user-order-history-grouped-listตัวอย่างคำขอ
{
"page": 1,
"pageSize": 20,
"query": {
"userNumber": "",
"brokerNumber": "",
"marketType": 0,
"startTime": "",
"endTime": ""
}
}ฟิลด์คำขอ
pagenumberpageSizenumberqueryobjectตัวอย่างการตอบกลับ
ค่าเป็นตัวอย่าง โปรดแทนรหัสด้วยค่าจากบัญชีที่ได้รับสิทธิ์ โครงสร้างการตอบกลับเป็นตัวอย่างที่อนุมานจากการใช้งาน API ของ Finger Admin โปรดยืนยันสัญญา API ที่ถูกต้องกับโบรกเกอร์ คำขอตั้งค่าหรือคำสั่งอาจเปลี่ยนข้อมูลจริง
{
"code": 0,
"data": {
"total": 1,
"items": [
{
"id": "sample-id",
"userNumber": "U10001",
"status": 1
}
]
},
"msg": "success"
}ลองส่งคำขอนี้ · /mer-api/v1/order/get-user-order-history-grouped-list
พร้อมใช้งาน คำขอจะยังไม่ถูกส่งจนกว่าจะกดส่ง
การตอบกลับ—
Token ใช้เฉพาะในเซสชันหน้านี้และเอกสารจะไม่บันทึกไว้ หลีกเลี่ยงอุปกรณ์สาธารณะและล้าง Token เมื่อเสร็จแล้ว
Customer order history statistics
Aggregate history statistics using OrderListQueryWithUserDTO.
/mer-api/v1/order/get-user-order-history-statตัวอย่างคำขอ
{
"brokerNumber": "",
"userName": "",
"userNumber": "",
"timezone": "UTC",
"marketType": 0,
"orderType": 0,
"coinType": 0,
"orderSide": 0,
"startTime": "",
"endTime": ""
}ฟิลด์คำขอ
brokerNumberstringuserNamestringuserNumberstringtimezonestringmarketTypenumberorderTypenumbercoinTypenumberorderSidenumberstartTimestringendTimestringตัวอย่างการตอบกลับ
ค่าเป็นตัวอย่าง โปรดแทนรหัสด้วยค่าจากบัญชีที่ได้รับสิทธิ์ โครงสร้างการตอบกลับเป็นตัวอย่างที่อนุมานจากการใช้งาน API ของ Finger Admin โปรดยืนยันสัญญา API ที่ถูกต้องกับโบรกเกอร์ คำขอตั้งค่าหรือคำสั่งอาจเปลี่ยนข้อมูลจริง
{
"code": 0,
"data": {
"total": 0,
"buyCount": 0,
"sellCount": 0
},
"msg": "success"
}ลองส่งคำขอนี้ · /mer-api/v1/order/get-user-order-history-stat
พร้อมใช้งาน คำขอจะยังไม่ถูกส่งจนกว่าจะกดส่ง
การตอบกลับ—
Token ใช้เฉพาะในเซสชันหน้านี้และเอกสารจะไม่บันทึกไว้ หลีกเลี่ยงอุปกรณ์สาธารณะและล้าง Token เมื่อเสร็จแล้ว
Broker order history
Paged broker order history query.
/mer-api/v1/order/get-broker-order-history-listตัวอย่างคำขอ
{
"page": 1,
"pageSize": 20,
"query": {
"userNumber": "",
"brokerNumber": "",
"marketType": 0,
"startTime": "",
"endTime": ""
}
}ฟิลด์คำขอ
pagenumberpageSizenumberqueryobjectตัวอย่างการตอบกลับ
ค่าเป็นตัวอย่าง โปรดแทนรหัสด้วยค่าจากบัญชีที่ได้รับสิทธิ์ โครงสร้างการตอบกลับเป็นตัวอย่างที่อนุมานจากการใช้งาน API ของ Finger Admin โปรดยืนยันสัญญา API ที่ถูกต้องกับโบรกเกอร์ คำขอตั้งค่าหรือคำสั่งอาจเปลี่ยนข้อมูลจริง
{
"code": 0,
"data": {
"total": 1,
"items": [
{
"id": "sample-id",
"userNumber": "U10001",
"status": 1
}
]
},
"msg": "success"
}ลองส่งคำขอนี้ · /mer-api/v1/order/get-broker-order-history-list
พร้อมใช้งาน คำขอจะยังไม่ถูกส่งจนกว่าจะกดส่ง
การตอบกลับ—
Token ใช้เฉพาะในเซสชันหน้านี้และเอกสารจะไม่บันทึกไว้ หลีกเลี่ยงอุปกรณ์สาธารณะและล้าง Token เมื่อเสร็จแล้ว
Close order
Closes the order identified by IDDTO.
/mer-api/v1/order/close-orderตัวอย่างคำขอ
{
"id": "demo-record-id"
}ฟิลด์คำขอ
idstringตัวอย่างการตอบกลับ
ค่าเป็นตัวอย่าง โปรดแทนรหัสด้วยค่าจากบัญชีที่ได้รับสิทธิ์ โครงสร้างการตอบกลับเป็นตัวอย่างที่อนุมานจากการใช้งาน API ของ Finger Admin โปรดยืนยันสัญญา API ที่ถูกต้องกับโบรกเกอร์ คำขอตั้งค่าหรือคำสั่งอาจเปลี่ยนข้อมูลจริง
{
"code": 0,
"data": true,
"msg": "success"
}ลองส่งคำขอนี้ · /mer-api/v1/order/close-order
เอนด์พอยต์นี้เปลี่ยนข้อมูลโบรกเกอร์หรือสถานะคำสั่ง Try จะส่งคำขอจริง ไม่ใช่การจำลอง ใช้บัญชีและสภาพแวดล้อมทดสอบที่ได้รับอนุมัติเท่านั้น
พร้อมใช้งาน คำขอจะยังไม่ถูกส่งจนกว่าจะกดส่ง
การตอบกลับ—
Token ใช้เฉพาะในเซสชันหน้านี้และเอกสารจะไม่บันทึกไว้ หลีกเลี่ยงอุปกรณ์สาธารณะและล้าง Token เมื่อเสร็จแล้ว