FINGER TRADER

brokerageDocsPage.tradingConfiguration

Trading Configuration APIs

Broker APIs for market matching, schedules, margin, fees, interest, and related configuration records.

Documentation framework · Overview

Authentication and access

These interfaces require an authorized broker or merchant staff session and the relevant backend permissions. They are not authenticated by an ordinary end-customer trading-app token. Confirm access with the broker administrator.

Send JSON POST requests to the selected merchant BFF environment. The Finger Admin client sends its signed-in broker-staff access token in the Authorization header as a Bearer token.

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

Examples are illustrative. Replace identifiers with values from your authorized account. Response payload shapes are examples inferred from Finger Admin client usage; confirm the exact contract with your broker. Configuration and order-action requests can change live data.

Endpoints in this section

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

Request example

{
  "marketType": 0
}

Request fields

marketTypenumber

Response example

Examples are illustrative. Replace identifiers with values from your authorized account. Response payload shapes are examples inferred from Finger Admin client usage; confirm the exact contract with your broker. Configuration and order-action requests can change live data.

{
  "code": 0,
  "data": {
    "id": "sample-id",
    "status": 1
  },
  "msg": "success"
}
Try this request · /mer-api/v1/trade/user-match-config

Ready. The request is not sent until you press Send.

Response
—

The token is held only in this page session and is not saved by this documentation page. Avoid shared devices and clear the token when finished.

Set user matching configuration

Updates the user matching configuration.

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

Request example

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

Request fields

marketTypenumber
userIdstring
valueobject

Response example

Examples are illustrative. Replace identifiers with values from your authorized account. Response payload shapes are examples inferred from Finger Admin client usage; confirm the exact contract with your broker. Configuration and order-action requests can change live data.

{
  "code": 0,
  "data": true,
  "msg": "success"
}
Try this request · /mer-api/v1/trade/user-match-config-set

This endpoint changes broker data or order state. Try sends a real request; it is not a simulation. Use an approved test account and environment.

Ready. The request is not sent until you press Send.

Response
—

The token is held only in this page session and is not saved by this documentation page. Avoid shared devices and clear the token when finished.

Set trading time schedule

Updates market trading time slots.

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

Request example

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

Request fields

marketTypenumber
userIdstring
valueobject

Response example

Examples are illustrative. Replace identifiers with values from your authorized account. Response payload shapes are examples inferred from Finger Admin client usage; confirm the exact contract with your broker. Configuration and order-action requests can change live data.

{
  "code": 0,
  "data": true,
  "msg": "success"
}
Try this request · /mer-api/v1/trade/set-trading-time-config

This endpoint changes broker data or order state. Try sends a real request; it is not a simulation. Use an approved test account and environment.

Ready. The request is not sent until you press Send.

Response
—

The token is held only in this page session and is not saved by this documentation page. Avoid shared devices and clear the token when finished.

Set margin

Updates margin values for a market.

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

Request example

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

Request fields

marketTypenumber
userIdstring
valueobject

Response example

Examples are illustrative. Replace identifiers with values from your authorized account. Response payload shapes are examples inferred from Finger Admin client usage; confirm the exact contract with your broker. Configuration and order-action requests can change live data.

{
  "code": 0,
  "data": true,
  "msg": "success"
}
Try this request · /mer-api/v1/trade/set-margin

This endpoint changes broker data or order state. Try sends a real request; it is not a simulation. Use an approved test account and environment.

Ready. The request is not sent until you press Send.

Response
—

The token is held only in this page session and is not saved by this documentation page. Avoid shared devices and clear the token when finished.

Set open fee

Updates opening fee configuration.

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

Request example

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

Request fields

marketTypenumber
userIdstring
valuestring

Response example

Examples are illustrative. Replace identifiers with values from your authorized account. Response payload shapes are examples inferred from Finger Admin client usage; confirm the exact contract with your broker. Configuration and order-action requests can change live data.

{
  "code": 0,
  "data": true,
  "msg": "success"
}
Try this request · /mer-api/v1/trade/set-open-fee

This endpoint changes broker data or order state. Try sends a real request; it is not a simulation. Use an approved test account and environment.

Ready. The request is not sent until you press Send.

Response
—

The token is held only in this page session and is not saved by this documentation page. Avoid shared devices and clear the token when finished.

Set close fee

Updates closing fee configuration.

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

Request example

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

Request fields

marketTypenumber
userIdstring
valuestring

Response example

Examples are illustrative. Replace identifiers with values from your authorized account. Response payload shapes are examples inferred from Finger Admin client usage; confirm the exact contract with your broker. Configuration and order-action requests can change live data.

{
  "code": 0,
  "data": true,
  "msg": "success"
}
Try this request · /mer-api/v1/trade/set-close-fee

This endpoint changes broker data or order state. Try sends a real request; it is not a simulation. Use an approved test account and environment.

Ready. The request is not sent until you press Send.

Response
—

The token is held only in this page session and is not saved by this documentation page. Avoid shared devices and clear the token when finished.

Set broker fee

Updates a broker fee configuration.

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

Request example

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

Request fields

marketTypenumber
userIdstring
valuenumber

Response example

Examples are illustrative. Replace identifiers with values from your authorized account. Response payload shapes are examples inferred from Finger Admin client usage; confirm the exact contract with your broker. Configuration and order-action requests can change live data.

{
  "code": 0,
  "data": true,
  "msg": "success"
}
Try this request · /mer-api/v1/trade/broker-fee-config-set

This endpoint changes broker data or order state. Try sends a real request; it is not a simulation. Use an approved test account and environment.

Ready. The request is not sent until you press Send.

Response
—

The token is held only in this page session and is not saved by this documentation page. Avoid shared devices and clear the token when finished.

Interest configuration list

Queries configured interest by market and ticker.

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

Request example

{
  "marketType": 0
}

Request fields

marketTypenumber

Response example

Examples are illustrative. Replace identifiers with values from your authorized account. Response payload shapes are examples inferred from Finger Admin client usage; confirm the exact contract with your broker. Configuration and order-action requests can change live data.

{
  "code": 0,
  "data": {
    "total": 1,
    "items": [
      {
        "id": "sample-id",
        "userNumber": "U10001",
        "status": 1
      }
    ]
  },
  "msg": "success"
}
Try this request · /mer-api/v1/trade/interest-config-list

Ready. The request is not sent until you press Send.

Response
—

The token is held only in this page session and is not saved by this documentation page. Avoid shared devices and clear the token when finished.

Set interest configuration

Updates ticker buy/sell interest settings.

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

Request example

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

Request fields

tickerstring
buynumber
sellnumber

Response example

Examples are illustrative. Replace identifiers with values from your authorized account. Response payload shapes are examples inferred from Finger Admin client usage; confirm the exact contract with your broker. Configuration and order-action requests can change live data.

{
  "code": 0,
  "data": true,
  "msg": "success"
}
Try this request · /mer-api/v1/trade/interest-config-set

This endpoint changes broker data or order state. Try sends a real request; it is not a simulation. Use an approved test account and environment.

Ready. The request is not sent until you press Send.

Response
—

The token is held only in this page session and is not saved by this documentation page. Avoid shared devices and clear the token when finished.

Fee records

Paged fee record query.

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

Request example

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

Request fields

pagenumber
pageSizenumber
queryobject

Response example

Examples are illustrative. Replace identifiers with values from your authorized account. Response payload shapes are examples inferred from Finger Admin client usage; confirm the exact contract with your broker. Configuration and order-action requests can change live data.

{
  "code": 0,
  "data": {
    "total": 1,
    "items": [
      {
        "id": "sample-id",
        "userNumber": "U10001",
        "status": 1
      }
    ]
  },
  "msg": "success"
}
Try this request · /mer-api/v1/trade/fee-records

Ready. The request is not sent until you press Send.

Response
—

The token is held only in this page session and is not saved by this documentation page. Avoid shared devices and clear the token when finished.