FINGER TRADER

brokerageDocsPage.orders

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

API ฝั่งโบรกเกอร์สำหรับตรวจสอบสถานะและประวัติคำสั่งของลูกค้า รายการคำสั่งตลาด และการดำเนินการที่ได้รับอนุญาต

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

การยืนยันตัวตนและสิทธิ์เข้าถึง

ต้องใช้เซสชันพนักงานโบรกเกอร์/ร้านค้าที่ผ่านการยืนยันตัวตนและสิทธิ์ backend ที่เกี่ยวข้อง Token ของผู้ใช้แอปซื้อขายทั่วไปใช้ยืนยันตัวตนที่นี่ไม่ได้ โปรดยืนยันสิทธิ์กับผู้ดูแลโบรกเกอร์

ส่งคำขอ POST แบบ JSON ไปยังสภาพแวดล้อม Merchant BFF ที่เลือก Finger Admin ส่ง Access Token ของพนักงานโบรกเกอร์ที่เข้าสู่ระบบในส่วนหัว Authorization ในรูปแบบ Bearer

https://dev-api.fingertrading.com/finger-bff-merchant
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.

POST/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.

POST/mer-api/v1/order/market-data-list

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

{
  "page": 1,
  "pageSize": 20,
  "query": {
    "marketType": 0
  }
}

ฟิลด์คำขอ

pagenumber
pageSizenumber
queryobject

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

ค่าเป็นตัวอย่าง โปรดแทนรหัสด้วยค่าจากบัญชีที่ได้รับสิทธิ์ โครงสร้างการตอบกลับเป็นตัวอย่างที่อนุมานจากการใช้งาน 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.

POST/mer-api/v1/order/get-user-order-holding-list

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

{
  "page": 1,
  "pageSize": 20,
  "query": {
    "userNumber": "",
    "brokerNumber": "",
    "marketType": 0,
    "startTime": "",
    "endTime": ""
  }
}

ฟิลด์คำขอ

pagenumber
pageSizenumber
queryobject

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

ค่าเป็นตัวอย่าง โปรดแทนรหัสด้วยค่าจากบัญชีที่ได้รับสิทธิ์ โครงสร้างการตอบกลับเป็นตัวอย่างที่อนุมานจากการใช้งาน 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.

POST/mer-api/v1/order/get-user-order-history-list

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

{
  "page": 1,
  "pageSize": 20,
  "query": {
    "userNumber": "",
    "brokerNumber": "",
    "marketType": 0,
    "startTime": "",
    "endTime": ""
  }
}

ฟิลด์คำขอ

pagenumber
pageSizenumber
queryobject

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

ค่าเป็นตัวอย่าง โปรดแทนรหัสด้วยค่าจากบัญชีที่ได้รับสิทธิ์ โครงสร้างการตอบกลับเป็นตัวอย่างที่อนุมานจากการใช้งาน 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.

POST/mer-api/v1/order/get-user-order-history-grouped-list

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

{
  "page": 1,
  "pageSize": 20,
  "query": {
    "userNumber": "",
    "brokerNumber": "",
    "marketType": 0,
    "startTime": "",
    "endTime": ""
  }
}

ฟิลด์คำขอ

pagenumber
pageSizenumber
queryobject

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

ค่าเป็นตัวอย่าง โปรดแทนรหัสด้วยค่าจากบัญชีที่ได้รับสิทธิ์ โครงสร้างการตอบกลับเป็นตัวอย่างที่อนุมานจากการใช้งาน 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.

POST/mer-api/v1/order/get-user-order-history-stat

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

{
  "brokerNumber": "",
  "userName": "",
  "userNumber": "",
  "timezone": "UTC",
  "marketType": 0,
  "orderType": 0,
  "coinType": 0,
  "orderSide": 0,
  "startTime": "",
  "endTime": ""
}

ฟิลด์คำขอ

brokerNumberstring
userNamestring
userNumberstring
timezonestring
marketTypenumber
orderTypenumber
coinTypenumber
orderSidenumber
startTimestring
endTimestring

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

ค่าเป็นตัวอย่าง โปรดแทนรหัสด้วยค่าจากบัญชีที่ได้รับสิทธิ์ โครงสร้างการตอบกลับเป็นตัวอย่างที่อนุมานจากการใช้งาน 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.

POST/mer-api/v1/order/get-broker-order-history-list

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

{
  "page": 1,
  "pageSize": 20,
  "query": {
    "userNumber": "",
    "brokerNumber": "",
    "marketType": 0,
    "startTime": "",
    "endTime": ""
  }
}

ฟิลด์คำขอ

pagenumber
pageSizenumber
queryobject

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

ค่าเป็นตัวอย่าง โปรดแทนรหัสด้วยค่าจากบัญชีที่ได้รับสิทธิ์ โครงสร้างการตอบกลับเป็นตัวอย่างที่อนุมานจากการใช้งาน 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.

POST/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 เมื่อเสร็จแล้ว