FINGER TRADER

brokerageDocsPage.tradingConfiguration

API cấu hình giao dịch

API broker cho ghép lệnh theo thị trường, lịch giao dịch, ký quỹ, phí, lãi và bản ghi cấu hình liên quan.

Khung tài liệu · Tổng quan

Xác thực và quyền truy cập

Các giao diện này yêu cầu phiên nhân viên broker/merchant đã xác thực và quyền backend tương ứng. Token của người dùng cuối ứng dụng giao dịch thông thường không dùng được. Hãy xác nhận quyền với quản trị viên broker.

Gửi yêu cầu POST JSON đến môi trường Merchant BFF đã chọn. Finger Admin gửi Access Token của nhân viên broker đã đăng nhập trong header Authorization theo dạng Bearer.

https://dev-api.fingertrading.com/finger-bff-merchant
Authorization: Bearer <BROKER_STAFF_ACCESS_TOKEN>

Giá trị chỉ để minh họa; hãy thay mã bằng dữ liệu từ tài khoản được cấp quyền. Cấu trúc phản hồi là ví dụ suy ra từ cách Finger Admin sử dụng API; hãy xác nhận hợp đồng chính xác với broker. Yêu cầu cấu hình hoặc thao tác lệnh có thể thay đổi dữ liệu thật.

API trong mục này

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

Ví dụ yêu cầu

{
  "marketType": 0
}

Trường yêu cầu

marketTypenumber

Ví dụ phản hồi

Giá trị chỉ để minh họa; hãy thay mã bằng dữ liệu từ tài khoản được cấp quyền. Cấu trúc phản hồi là ví dụ suy ra từ cách Finger Admin sử dụng API; hãy xác nhận hợp đồng chính xác với broker. Yêu cầu cấu hình hoặc thao tác lệnh có thể thay đổi dữ liệu thật.

{
  "code": 0,
  "data": {
    "id": "sample-id",
    "status": 1
  },
  "msg": "success"
}
Thử yêu cầu này · /mer-api/v1/trade/user-match-config

Sẵn sàng. Yêu cầu chưa được gửi cho đến khi bạn nhấn Gửi.

Phản hồi
—

Token chỉ được giữ trong phiên trang hiện tại và không được lưu bởi trang tài liệu. Tránh dùng thiết bị chung và xóa Token sau khi xong.

Set user matching configuration

Updates the user matching configuration.

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

Ví dụ yêu cầu

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

Trường yêu cầu

marketTypenumber
userIdstring
valueobject

Ví dụ phản hồi

Giá trị chỉ để minh họa; hãy thay mã bằng dữ liệu từ tài khoản được cấp quyền. Cấu trúc phản hồi là ví dụ suy ra từ cách Finger Admin sử dụng API; hãy xác nhận hợp đồng chính xác với broker. Yêu cầu cấu hình hoặc thao tác lệnh có thể thay đổi dữ liệu thật.

{
  "code": 0,
  "data": true,
  "msg": "success"
}
Thử yêu cầu này · /mer-api/v1/trade/user-match-config-set

Endpoint này thay đổi dữ liệu broker hoặc trạng thái lệnh. Try gửi yêu cầu thật, không phải mô phỏng. Chỉ dùng tài khoản và môi trường kiểm thử được phê duyệt.

Sẵn sàng. Yêu cầu chưa được gửi cho đến khi bạn nhấn Gửi.

Phản hồi
—

Token chỉ được giữ trong phiên trang hiện tại và không được lưu bởi trang tài liệu. Tránh dùng thiết bị chung và xóa Token sau khi xong.

Set trading time schedule

Updates market trading time slots.

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

Ví dụ yêu cầu

{
  "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
    }
  ]
}

Trường yêu cầu

marketTypenumber
userIdstring
valueobject

Ví dụ phản hồi

Giá trị chỉ để minh họa; hãy thay mã bằng dữ liệu từ tài khoản được cấp quyền. Cấu trúc phản hồi là ví dụ suy ra từ cách Finger Admin sử dụng API; hãy xác nhận hợp đồng chính xác với broker. Yêu cầu cấu hình hoặc thao tác lệnh có thể thay đổi dữ liệu thật.

{
  "code": 0,
  "data": true,
  "msg": "success"
}
Thử yêu cầu này · /mer-api/v1/trade/set-trading-time-config

Endpoint này thay đổi dữ liệu broker hoặc trạng thái lệnh. Try gửi yêu cầu thật, không phải mô phỏng. Chỉ dùng tài khoản và môi trường kiểm thử được phê duyệt.

Sẵn sàng. Yêu cầu chưa được gửi cho đến khi bạn nhấn Gửi.

Phản hồi
—

Token chỉ được giữ trong phiên trang hiện tại và không được lưu bởi trang tài liệu. Tránh dùng thiết bị chung và xóa Token sau khi xong.

Set margin

Updates margin values for a market.

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

Ví dụ yêu cầu

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

Trường yêu cầu

marketTypenumber
userIdstring
valueobject

Ví dụ phản hồi

Giá trị chỉ để minh họa; hãy thay mã bằng dữ liệu từ tài khoản được cấp quyền. Cấu trúc phản hồi là ví dụ suy ra từ cách Finger Admin sử dụng API; hãy xác nhận hợp đồng chính xác với broker. Yêu cầu cấu hình hoặc thao tác lệnh có thể thay đổi dữ liệu thật.

{
  "code": 0,
  "data": true,
  "msg": "success"
}
Thử yêu cầu này · /mer-api/v1/trade/set-margin

Endpoint này thay đổi dữ liệu broker hoặc trạng thái lệnh. Try gửi yêu cầu thật, không phải mô phỏng. Chỉ dùng tài khoản và môi trường kiểm thử được phê duyệt.

Sẵn sàng. Yêu cầu chưa được gửi cho đến khi bạn nhấn Gửi.

Phản hồi
—

Token chỉ được giữ trong phiên trang hiện tại và không được lưu bởi trang tài liệu. Tránh dùng thiết bị chung và xóa Token sau khi xong.

Set open fee

Updates opening fee configuration.

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

Ví dụ yêu cầu

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

Trường yêu cầu

marketTypenumber
userIdstring
valuestring

Ví dụ phản hồi

Giá trị chỉ để minh họa; hãy thay mã bằng dữ liệu từ tài khoản được cấp quyền. Cấu trúc phản hồi là ví dụ suy ra từ cách Finger Admin sử dụng API; hãy xác nhận hợp đồng chính xác với broker. Yêu cầu cấu hình hoặc thao tác lệnh có thể thay đổi dữ liệu thật.

{
  "code": 0,
  "data": true,
  "msg": "success"
}
Thử yêu cầu này · /mer-api/v1/trade/set-open-fee

Endpoint này thay đổi dữ liệu broker hoặc trạng thái lệnh. Try gửi yêu cầu thật, không phải mô phỏng. Chỉ dùng tài khoản và môi trường kiểm thử được phê duyệt.

Sẵn sàng. Yêu cầu chưa được gửi cho đến khi bạn nhấn Gửi.

Phản hồi
—

Token chỉ được giữ trong phiên trang hiện tại và không được lưu bởi trang tài liệu. Tránh dùng thiết bị chung và xóa Token sau khi xong.

Set close fee

Updates closing fee configuration.

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

Ví dụ yêu cầu

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

Trường yêu cầu

marketTypenumber
userIdstring
valuestring

Ví dụ phản hồi

Giá trị chỉ để minh họa; hãy thay mã bằng dữ liệu từ tài khoản được cấp quyền. Cấu trúc phản hồi là ví dụ suy ra từ cách Finger Admin sử dụng API; hãy xác nhận hợp đồng chính xác với broker. Yêu cầu cấu hình hoặc thao tác lệnh có thể thay đổi dữ liệu thật.

{
  "code": 0,
  "data": true,
  "msg": "success"
}
Thử yêu cầu này · /mer-api/v1/trade/set-close-fee

Endpoint này thay đổi dữ liệu broker hoặc trạng thái lệnh. Try gửi yêu cầu thật, không phải mô phỏng. Chỉ dùng tài khoản và môi trường kiểm thử được phê duyệt.

Sẵn sàng. Yêu cầu chưa được gửi cho đến khi bạn nhấn Gửi.

Phản hồi
—

Token chỉ được giữ trong phiên trang hiện tại và không được lưu bởi trang tài liệu. Tránh dùng thiết bị chung và xóa Token sau khi xong.

Set broker fee

Updates a broker fee configuration.

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

Ví dụ yêu cầu

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

Trường yêu cầu

marketTypenumber
userIdstring
valuenumber

Ví dụ phản hồi

Giá trị chỉ để minh họa; hãy thay mã bằng dữ liệu từ tài khoản được cấp quyền. Cấu trúc phản hồi là ví dụ suy ra từ cách Finger Admin sử dụng API; hãy xác nhận hợp đồng chính xác với broker. Yêu cầu cấu hình hoặc thao tác lệnh có thể thay đổi dữ liệu thật.

{
  "code": 0,
  "data": true,
  "msg": "success"
}
Thử yêu cầu này · /mer-api/v1/trade/broker-fee-config-set

Endpoint này thay đổi dữ liệu broker hoặc trạng thái lệnh. Try gửi yêu cầu thật, không phải mô phỏng. Chỉ dùng tài khoản và môi trường kiểm thử được phê duyệt.

Sẵn sàng. Yêu cầu chưa được gửi cho đến khi bạn nhấn Gửi.

Phản hồi
—

Token chỉ được giữ trong phiên trang hiện tại và không được lưu bởi trang tài liệu. Tránh dùng thiết bị chung và xóa Token sau khi xong.

Interest configuration list

Queries configured interest by market and ticker.

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

Ví dụ yêu cầu

{
  "marketType": 0
}

Trường yêu cầu

marketTypenumber

Ví dụ phản hồi

Giá trị chỉ để minh họa; hãy thay mã bằng dữ liệu từ tài khoản được cấp quyền. Cấu trúc phản hồi là ví dụ suy ra từ cách Finger Admin sử dụng API; hãy xác nhận hợp đồng chính xác với broker. Yêu cầu cấu hình hoặc thao tác lệnh có thể thay đổi dữ liệu thật.

{
  "code": 0,
  "data": {
    "total": 1,
    "items": [
      {
        "id": "sample-id",
        "userNumber": "U10001",
        "status": 1
      }
    ]
  },
  "msg": "success"
}
Thử yêu cầu này · /mer-api/v1/trade/interest-config-list

Sẵn sàng. Yêu cầu chưa được gửi cho đến khi bạn nhấn Gửi.

Phản hồi
—

Token chỉ được giữ trong phiên trang hiện tại và không được lưu bởi trang tài liệu. Tránh dùng thiết bị chung và xóa Token sau khi xong.

Set interest configuration

Updates ticker buy/sell interest settings.

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

Ví dụ yêu cầu

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

Trường yêu cầu

tickerstring
buynumber
sellnumber

Ví dụ phản hồi

Giá trị chỉ để minh họa; hãy thay mã bằng dữ liệu từ tài khoản được cấp quyền. Cấu trúc phản hồi là ví dụ suy ra từ cách Finger Admin sử dụng API; hãy xác nhận hợp đồng chính xác với broker. Yêu cầu cấu hình hoặc thao tác lệnh có thể thay đổi dữ liệu thật.

{
  "code": 0,
  "data": true,
  "msg": "success"
}
Thử yêu cầu này · /mer-api/v1/trade/interest-config-set

Endpoint này thay đổi dữ liệu broker hoặc trạng thái lệnh. Try gửi yêu cầu thật, không phải mô phỏng. Chỉ dùng tài khoản và môi trường kiểm thử được phê duyệt.

Sẵn sàng. Yêu cầu chưa được gửi cho đến khi bạn nhấn Gửi.

Phản hồi
—

Token chỉ được giữ trong phiên trang hiện tại và không được lưu bởi trang tài liệu. Tránh dùng thiết bị chung và xóa Token sau khi xong.

Fee records

Paged fee record query.

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

Ví dụ yêu cầu

{
  "page": 1,
  "pageSize": 20,
  "query": {
    "userId": "demo-user-id",
    "startTime": "",
    "endTime": ""
  }
}

Trường yêu cầu

pagenumber
pageSizenumber
queryobject

Ví dụ phản hồi

Giá trị chỉ để minh họa; hãy thay mã bằng dữ liệu từ tài khoản được cấp quyền. Cấu trúc phản hồi là ví dụ suy ra từ cách Finger Admin sử dụng API; hãy xác nhận hợp đồng chính xác với broker. Yêu cầu cấu hình hoặc thao tác lệnh có thể thay đổi dữ liệu thật.

{
  "code": 0,
  "data": {
    "total": 1,
    "items": [
      {
        "id": "sample-id",
        "userNumber": "U10001",
        "status": 1
      }
    ]
  },
  "msg": "success"
}
Thử yêu cầu này · /mer-api/v1/trade/fee-records

Sẵn sàng. Yêu cầu chưa được gửi cho đến khi bạn nhấn Gửi.

Phản hồi
—

Token chỉ được giữ trong phiên trang hiện tại và không được lưu bởi trang tài liệu. Tránh dùng thiết bị chung và xóa Token sau khi xong.