brokerageDocsPage.tradingConfiguration
거래 설정 API
시장 매칭, 거래 시간, 증거금, 수수료, 이자 및 관련 기록을 위한 브로커 API.
인증 및 접근 권한
인증된 브로커/가맹점 직원 세션과 해당 백엔드 권한이 필요합니다. 일반 고객 거래 앱 Token으로는 인증할 수 없습니다. 권한은 브로커 관리자에게 확인하세요.
선택한 Merchant BFF 환경으로 JSON POST 요청을 보냅니다. Finger Admin 클라이언트는 로그인한 브로커 직원 Access Token을 Bearer 형식으로 Authorization 헤더에 넣습니다.
Authorization: Bearer <BROKER_STAFF_ACCESS_TOKEN>
값은 예시입니다. 식별자는 권한이 있는 계정의 값으로 바꾸세요. 응답 본문은 Finger Admin 클라이언트 사용 방식에서 추정한 예시이므로 정확한 규격은 브로커에 확인하세요. 설정 및 주문 요청은 실제 데이터를 변경할 수 있습니다.
이 분류의 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.
/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은 현재 페이지 세션에서만 사용하고 저장하지 않습니다. 공용 기기에서는 사용하지 말고 완료 후 지우세요.
Set user matching configuration
Updates the user matching configuration.
/mer-api/v1/trade/user-match-config-set요청 예시
{
"marketType": 0,
"userId": "demo-user-id",
"value": {
"status": 1,
"orderSide": 0,
"rate": 1,
"followOrderFirst": false
}
}요청 필드
marketTypenumberuserIdstringvalueobject응답 예시
값은 예시입니다. 식별자는 권한이 있는 계정의 값으로 바꾸세요. 응답 본문은 Finger Admin 클라이언트 사용 방식에서 추정한 예시이므로 정확한 규격은 브로커에 확인하세요. 설정 및 주문 요청은 실제 데이터를 변경할 수 있습니다.
{
"code": 0,
"data": true,
"msg": "success"
}요청 테스트 · /mer-api/v1/trade/user-match-config-set
이 엔드포인트는 브로커 데이터 또는 주문 상태를 변경합니다. Try는 실제 요청을 보내며 시뮬레이션이 아닙니다. 승인된 테스트 계정과 환경만 사용하세요.
준비됨. 보내기 버튼을 누르기 전에는 요청이 전송되지 않습니다.
응답—
Token은 현재 페이지 세션에서만 사용하고 저장하지 않습니다. 공용 기기에서는 사용하지 말고 완료 후 지우세요.
Set trading time schedule
Updates market trading time slots.
/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
}
]
}요청 필드
marketTypenumberuserIdstringvalueobject응답 예시
값은 예시입니다. 식별자는 권한이 있는 계정의 값으로 바꾸세요. 응답 본문은 Finger Admin 클라이언트 사용 방식에서 추정한 예시이므로 정확한 규격은 브로커에 확인하세요. 설정 및 주문 요청은 실제 데이터를 변경할 수 있습니다.
{
"code": 0,
"data": true,
"msg": "success"
}요청 테스트 · /mer-api/v1/trade/set-trading-time-config
이 엔드포인트는 브로커 데이터 또는 주문 상태를 변경합니다. Try는 실제 요청을 보내며 시뮬레이션이 아닙니다. 승인된 테스트 계정과 환경만 사용하세요.
준비됨. 보내기 버튼을 누르기 전에는 요청이 전송되지 않습니다.
응답—
Token은 현재 페이지 세션에서만 사용하고 저장하지 않습니다. 공용 기기에서는 사용하지 말고 완료 후 지우세요.
Set margin
Updates margin values for a market.
/mer-api/v1/trade/set-margin요청 예시
{
"marketType": 0,
"userId": "demo-user-id",
"value": [
1,
2
]
}요청 필드
marketTypenumberuserIdstringvalueobject응답 예시
값은 예시입니다. 식별자는 권한이 있는 계정의 값으로 바꾸세요. 응답 본문은 Finger Admin 클라이언트 사용 방식에서 추정한 예시이므로 정확한 규격은 브로커에 확인하세요. 설정 및 주문 요청은 실제 데이터를 변경할 수 있습니다.
{
"code": 0,
"data": true,
"msg": "success"
}요청 테스트 · /mer-api/v1/trade/set-margin
이 엔드포인트는 브로커 데이터 또는 주문 상태를 변경합니다. Try는 실제 요청을 보내며 시뮬레이션이 아닙니다. 승인된 테스트 계정과 환경만 사용하세요.
준비됨. 보내기 버튼을 누르기 전에는 요청이 전송되지 않습니다.
응답—
Token은 현재 페이지 세션에서만 사용하고 저장하지 않습니다. 공용 기기에서는 사용하지 말고 완료 후 지우세요.
Set open fee
Updates opening fee configuration.
/mer-api/v1/trade/set-open-fee요청 예시
{
"marketType": 0,
"userId": "demo-user-id",
"value": "0.001"
}요청 필드
marketTypenumberuserIdstringvaluestring응답 예시
값은 예시입니다. 식별자는 권한이 있는 계정의 값으로 바꾸세요. 응답 본문은 Finger Admin 클라이언트 사용 방식에서 추정한 예시이므로 정확한 규격은 브로커에 확인하세요. 설정 및 주문 요청은 실제 데이터를 변경할 수 있습니다.
{
"code": 0,
"data": true,
"msg": "success"
}요청 테스트 · /mer-api/v1/trade/set-open-fee
이 엔드포인트는 브로커 데이터 또는 주문 상태를 변경합니다. Try는 실제 요청을 보내며 시뮬레이션이 아닙니다. 승인된 테스트 계정과 환경만 사용하세요.
준비됨. 보내기 버튼을 누르기 전에는 요청이 전송되지 않습니다.
응답—
Token은 현재 페이지 세션에서만 사용하고 저장하지 않습니다. 공용 기기에서는 사용하지 말고 완료 후 지우세요.
Set close fee
Updates closing fee configuration.
/mer-api/v1/trade/set-close-fee요청 예시
{
"marketType": 0,
"userId": "demo-user-id",
"value": "0.001"
}요청 필드
marketTypenumberuserIdstringvaluestring응답 예시
값은 예시입니다. 식별자는 권한이 있는 계정의 값으로 바꾸세요. 응답 본문은 Finger Admin 클라이언트 사용 방식에서 추정한 예시이므로 정확한 규격은 브로커에 확인하세요. 설정 및 주문 요청은 실제 데이터를 변경할 수 있습니다.
{
"code": 0,
"data": true,
"msg": "success"
}요청 테스트 · /mer-api/v1/trade/set-close-fee
이 엔드포인트는 브로커 데이터 또는 주문 상태를 변경합니다. Try는 실제 요청을 보내며 시뮬레이션이 아닙니다. 승인된 테스트 계정과 환경만 사용하세요.
준비됨. 보내기 버튼을 누르기 전에는 요청이 전송되지 않습니다.
응답—
Token은 현재 페이지 세션에서만 사용하고 저장하지 않습니다. 공용 기기에서는 사용하지 말고 완료 후 지우세요.
Set broker fee
Updates a broker fee configuration.
/mer-api/v1/trade/broker-fee-config-set요청 예시
{
"marketType": 0,
"userId": "demo-user-id",
"value": 0.001
}요청 필드
marketTypenumberuserIdstringvaluenumber응답 예시
값은 예시입니다. 식별자는 권한이 있는 계정의 값으로 바꾸세요. 응답 본문은 Finger Admin 클라이언트 사용 방식에서 추정한 예시이므로 정확한 규격은 브로커에 확인하세요. 설정 및 주문 요청은 실제 데이터를 변경할 수 있습니다.
{
"code": 0,
"data": true,
"msg": "success"
}요청 테스트 · /mer-api/v1/trade/broker-fee-config-set
이 엔드포인트는 브로커 데이터 또는 주문 상태를 변경합니다. Try는 실제 요청을 보내며 시뮬레이션이 아닙니다. 승인된 테스트 계정과 환경만 사용하세요.
준비됨. 보내기 버튼을 누르기 전에는 요청이 전송되지 않습니다.
응답—
Token은 현재 페이지 세션에서만 사용하고 저장하지 않습니다. 공용 기기에서는 사용하지 말고 완료 후 지우세요.
Interest configuration list
Queries configured interest by market and ticker.
/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은 현재 페이지 세션에서만 사용하고 저장하지 않습니다. 공용 기기에서는 사용하지 말고 완료 후 지우세요.
Set interest configuration
Updates ticker buy/sell interest settings.
/mer-api/v1/trade/interest-config-set요청 예시
{
"ticker": "EURUSD",
"buy": 0,
"sell": 0
}요청 필드
tickerstringbuynumbersellnumber응답 예시
값은 예시입니다. 식별자는 권한이 있는 계정의 값으로 바꾸세요. 응답 본문은 Finger Admin 클라이언트 사용 방식에서 추정한 예시이므로 정확한 규격은 브로커에 확인하세요. 설정 및 주문 요청은 실제 데이터를 변경할 수 있습니다.
{
"code": 0,
"data": true,
"msg": "success"
}요청 테스트 · /mer-api/v1/trade/interest-config-set
이 엔드포인트는 브로커 데이터 또는 주문 상태를 변경합니다. Try는 실제 요청을 보내며 시뮬레이션이 아닙니다. 승인된 테스트 계정과 환경만 사용하세요.
준비됨. 보내기 버튼을 누르기 전에는 요청이 전송되지 않습니다.
응답—
Token은 현재 페이지 세션에서만 사용하고 저장하지 않습니다. 공용 기기에서는 사용하지 말고 완료 후 지우세요.
Fee records
Paged fee record query.
/mer-api/v1/trade/fee-records요청 예시
{
"page": 1,
"pageSize": 20,
"query": {
"userId": "demo-user-id",
"startTime": "",
"endTime": ""
}
}요청 필드
pagenumberpageSizenumberqueryobject응답 예시
값은 예시입니다. 식별자는 권한이 있는 계정의 값으로 바꾸세요. 응답 본문은 Finger Admin 클라이언트 사용 방식에서 추정한 예시이므로 정확한 규격은 브로커에 확인하세요. 설정 및 주문 요청은 실제 데이터를 변경할 수 있습니다.
{
"code": 0,
"data": {
"total": 1,
"items": [
{
"id": "sample-id",
"userNumber": "U10001",
"status": 1
}
]
},
"msg": "success"
}요청 테스트 · /mer-api/v1/trade/fee-records
준비됨. 보내기 버튼을 누르기 전에는 요청이 전송되지 않습니다.
응답—
Token은 현재 페이지 세션에서만 사용하고 저장하지 않습니다. 공용 기기에서는 사용하지 말고 완료 후 지우세요.