brokerageDocsPage.tradingConfiguration
Trading Configuration APIs
Broker APIs for market matching, schedules, margin, fees, interest, and related configuration records.
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.
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.
/mer-api/v1/trade/user-match-configRequest example
{
"marketType": 0
}Request fields
marketTypenumberResponse 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.
/mer-api/v1/trade/user-match-config-setRequest example
{
"marketType": 0,
"userId": "demo-user-id",
"value": {
"status": 1,
"orderSide": 0,
"rate": 1,
"followOrderFirst": false
}
}Request fields
marketTypenumberuserIdstringvalueobjectResponse 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.
/mer-api/v1/trade/set-trading-time-configRequest 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
marketTypenumberuserIdstringvalueobjectResponse 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.
/mer-api/v1/trade/set-marginRequest example
{
"marketType": 0,
"userId": "demo-user-id",
"value": [
1,
2
]
}Request fields
marketTypenumberuserIdstringvalueobjectResponse 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.
/mer-api/v1/trade/set-open-feeRequest example
{
"marketType": 0,
"userId": "demo-user-id",
"value": "0.001"
}Request fields
marketTypenumberuserIdstringvaluestringResponse 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.
/mer-api/v1/trade/set-close-feeRequest example
{
"marketType": 0,
"userId": "demo-user-id",
"value": "0.001"
}Request fields
marketTypenumberuserIdstringvaluestringResponse 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.
/mer-api/v1/trade/broker-fee-config-setRequest example
{
"marketType": 0,
"userId": "demo-user-id",
"value": 0.001
}Request fields
marketTypenumberuserIdstringvaluenumberResponse 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.
/mer-api/v1/trade/interest-config-listRequest example
{
"marketType": 0
}Request fields
marketTypenumberResponse 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.
/mer-api/v1/trade/interest-config-setRequest example
{
"ticker": "EURUSD",
"buy": 0,
"sell": 0
}Request fields
tickerstringbuynumbersellnumberResponse 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.
/mer-api/v1/trade/fee-recordsRequest example
{
"page": 1,
"pageSize": 20,
"query": {
"userId": "demo-user-id",
"startTime": "",
"endTime": ""
}
}Request fields
pagenumberpageSizenumberqueryobjectResponse 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.