FINGER TRADER

brokerageDocsPage.tradingConfiguration

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 ในหมวดนี้

Broker-side settings for market matching, trading schedules, margin, fees, interest, and fee records.

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

Set user matching configuration

Updates the user matching configuration.

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

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

{
  "marketType": 0,
  "userId": "demo-user-id",
  "value": {
    "status": 1,
    "orderSide": 0,
    "rate": 1,
    "followOrderFirst": false
  }
}

ฟิลด์คำขอ

marketTypenumber
userIdstring
valueobject

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

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

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

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

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

การตอบกลับ
—

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

Set trading time schedule

Updates market trading time slots.

POST/mer-api/v1/trade/set-trading-time-config

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

{
  "marketType": 0,
  "userId": "demo-user-id",
  "value": [
    {
      "type": 0,
      "ruleValue": "WEEKDAY",
      "startTime": {
        "hour": 9,
        "minute": 0,
        "second": 0,
        "nano": 0
      },
      "endTime": {
        "hour": 17,
        "minute": 0,
        "second": 0,
        "nano": 0
      },
      "startDate": "2026-01-01",
      "endDate": "2026-12-31",
      "priority": 1
    }
  ]
}

ฟิลด์คำขอ

marketTypenumber
userIdstring
valueobject

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

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

{
  "code": 0,
  "data": true,
  "msg": "success"
}
ลองส่งคำขอนี้ · /mer-api/v1/trade/set-trading-time-config

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

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

การตอบกลับ
—

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

Set margin

Updates margin values for a market.

POST/mer-api/v1/trade/set-margin

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

{
  "marketType": 0,
  "userId": "demo-user-id",
  "value": [
    1,
    2
  ]
}

ฟิลด์คำขอ

marketTypenumber
userIdstring
valueobject

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

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

{
  "code": 0,
  "data": true,
  "msg": "success"
}
ลองส่งคำขอนี้ · /mer-api/v1/trade/set-margin

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

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

การตอบกลับ
—

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

Set open fee

Updates opening fee configuration.

POST/mer-api/v1/trade/set-open-fee

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

{
  "marketType": 0,
  "userId": "demo-user-id",
  "value": "0.001"
}

ฟิลด์คำขอ

marketTypenumber
userIdstring
valuestring

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

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

{
  "code": 0,
  "data": true,
  "msg": "success"
}
ลองส่งคำขอนี้ · /mer-api/v1/trade/set-open-fee

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

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

การตอบกลับ
—

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

Set close fee

Updates closing fee configuration.

POST/mer-api/v1/trade/set-close-fee

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

{
  "marketType": 0,
  "userId": "demo-user-id",
  "value": "0.001"
}

ฟิลด์คำขอ

marketTypenumber
userIdstring
valuestring

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

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

{
  "code": 0,
  "data": true,
  "msg": "success"
}
ลองส่งคำขอนี้ · /mer-api/v1/trade/set-close-fee

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

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

การตอบกลับ
—

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

Set broker fee

Updates a broker fee configuration.

POST/mer-api/v1/trade/broker-fee-config-set

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

{
  "marketType": 0,
  "userId": "demo-user-id",
  "value": 0.001
}

ฟิลด์คำขอ

marketTypenumber
userIdstring
valuenumber

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

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

{
  "code": 0,
  "data": true,
  "msg": "success"
}
ลองส่งคำขอนี้ · /mer-api/v1/trade/broker-fee-config-set

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

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

การตอบกลับ
—

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

Interest configuration list

Queries configured interest by market and ticker.

POST/mer-api/v1/trade/interest-config-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/trade/interest-config-list

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

การตอบกลับ
—

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

Set interest configuration

Updates ticker buy/sell interest settings.

POST/mer-api/v1/trade/interest-config-set

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

{
  "ticker": "EURUSD",
  "buy": 0,
  "sell": 0
}

ฟิลด์คำขอ

tickerstring
buynumber
sellnumber

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

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

{
  "code": 0,
  "data": true,
  "msg": "success"
}
ลองส่งคำขอนี้ · /mer-api/v1/trade/interest-config-set

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

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

การตอบกลับ
—

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

Fee records

Paged fee record query.

POST/mer-api/v1/trade/fee-records

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

{
  "page": 1,
  "pageSize": 20,
  "query": {
    "userId": "demo-user-id",
    "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/trade/fee-records

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

การตอบกลับ
—

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