FINGER TRADER

brokerageDocsPage.tradingConfiguration

交易配置 API

經紀商市場撮合、交易時段、保證金、手續費、倉息及相關配置記錄 API。

文檔架構 · 概覽

認證與存取權限

這些介面需要已授權的經紀商/商戶員工會話及相應後端權限;一般終端客戶交易 App Token 無法用於此處。請向券商管理員確認權限。

向所選商戶 BFF 環境發送 JSON POST 請求。Finger Admin 用戶端會在 Authorization 請求標頭中傳送已登入的經紀商員工 Access Token,格式為 Bearer Token。

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

範例值僅供說明,請替換為授權帳戶取得的識別碼。回應本文結構是依 Finger Admin 用戶端使用方式模擬,確切規格請向券商確認。配置及訂單操作可能變更實際資料。

本分類介面

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

回應範例

範例值僅供說明,請替換為授權帳戶取得的識別碼。回應本文結構是依 Finger Admin 用戶端使用方式模擬,確切規格請向券商確認。配置及訂單操作可能變更實際資料。

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

回應範例

範例值僅供說明,請替換為授權帳戶取得的識別碼。回應本文結構是依 Finger Admin 用戶端使用方式模擬,確切規格請向券商確認。配置及訂單操作可能變更實際資料。

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

回應範例

範例值僅供說明,請替換為授權帳戶取得的識別碼。回應本文結構是依 Finger Admin 用戶端使用方式模擬,確切規格請向券商確認。配置及訂單操作可能變更實際資料。

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

回應範例

範例值僅供說明,請替換為授權帳戶取得的識別碼。回應本文結構是依 Finger Admin 用戶端使用方式模擬,確切規格請向券商確認。配置及訂單操作可能變更實際資料。

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

回應範例

範例值僅供說明,請替換為授權帳戶取得的識別碼。回應本文結構是依 Finger Admin 用戶端使用方式模擬,確切規格請向券商確認。配置及訂單操作可能變更實際資料。

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

回應範例

範例值僅供說明,請替換為授權帳戶取得的識別碼。回應本文結構是依 Finger Admin 用戶端使用方式模擬,確切規格請向券商確認。配置及訂單操作可能變更實際資料。

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

回應範例

範例值僅供說明,請替換為授權帳戶取得的識別碼。回應本文結構是依 Finger Admin 用戶端使用方式模擬,確切規格請向券商確認。配置及訂單操作可能變更實際資料。

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

回應範例

範例值僅供說明,請替換為授權帳戶取得的識別碼。回應本文結構是依 Finger Admin 用戶端使用方式模擬,確切規格請向券商確認。配置及訂單操作可能變更實際資料。

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

回應範例

範例值僅供說明,請替換為授權帳戶取得的識別碼。回應本文結構是依 Finger Admin 用戶端使用方式模擬,確切規格請向券商確認。配置及訂單操作可能變更實際資料。

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

回應範例

範例值僅供說明,請替換為授權帳戶取得的識別碼。回應本文結構是依 Finger Admin 用戶端使用方式模擬,確切規格請向券商確認。配置及訂單操作可能變更實際資料。

{
  "code": 0,
  "data": {
    "total": 1,
    "items": [
      {
        "id": "sample-id",
        "userNumber": "U10001",
        "status": 1
      }
    ]
  },
  "msg": "success"
}
試用此請求 · /mer-api/v1/trade/fee-records

就緒。按下「發送請求」前不會送出請求。

回應
—

本頁只在目前頁面工作階段暫存 Token,不會保存。請勿在共用裝置上使用,完成後清除 Token。