FINGER TRADER

เอกสาร API โบรกเกอร์

เอกสาร API โบรกเกอร์

จัดกลุ่มอินเทอร์เฟซ /mer-api/v1 ที่ Finger Admin ใช้ในขั้นตอนลูกค้า คำสั่ง และควบคุมความเสี่ยง โดย Merchant BFF เป็นผู้ให้บริการ การเข้าถึงขึ้นอยู่กับบัญชีโบรกเกอร์และสิทธิ์ที่กำหนด

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

เอกสาร API โบรกเกอร์

จัดกลุ่มอินเทอร์เฟซ /mer-api/v1 ที่ Finger Admin ใช้ในขั้นตอนลูกค้า คำสั่ง และควบคุมความเสี่ยง โดย Merchant BFF เป็นผู้ให้บริการ การเข้าถึงขึ้นอยู่กับบัญชีโบรกเกอร์และสิทธิ์ที่กำหนด

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

Base URL และการยืนยันตัวตน Merchant BFF

ส่งคำขอ 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

Customer list

Paged customer search; query keys are based on UserQueryDTO.

POST/mer-api/v1/customer/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/customer/list

พร้อมใช้งาน คำขอจะยังไม่ถูกส่งจนกว่าจะกดส่ง

การตอบกลับ
—

Token ใช้เฉพาะในเซสชันหน้านี้และเอกสารจะไม่บันทึกไว้ หลีกเลี่ยงอุปกรณ์สาธารณะและล้าง Token เมื่อเสร็จแล้ว

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

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

User matching configuration

Reads the matching configuration for a market/user context.

POST/mer-api/v1/trade/user-match-config

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

{
  "marketType": 0
}

ฟิลด์คำขอ

marketTypenumber

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

ค่าเป็นตัวอย่าง โปรดแทนรหัสด้วยค่าจากบัญชีที่ได้รับสิทธิ์ โครงสร้างการตอบกลับเป็นตัวอย่างที่อนุมานจากการใช้งาน API ของ Finger Admin โปรดยืนยันสัญญา API ที่ถูกต้องกับโบรกเกอร์ คำขอตั้งค่าหรือคำสั่งอาจเปลี่ยนข้อมูลจริง

{
  "code": 0,
  "data": {
    "id": "sample-id",
    "status": 1
  },
  "msg": "success"
}
ลองส่งคำขอนี้ · /mer-api/v1/trade/user-match-config

พร้อมใช้งาน คำขอจะยังไม่ถูกส่งจนกว่าจะกดส่ง

การตอบกลับ
—

Token ใช้เฉพาะในเซสชันหน้านี้และเอกสารจะไม่บันทึกไว้ หลีกเลี่ยงอุปกรณ์สาธารณะและล้าง Token เมื่อเสร็จแล้ว