FINGER TRADER

brokerageDocsPage.tradingConfiguration

거래 설정 API

시장 매칭, 거래 시간, 증거금, 수수료, 이자 및 관련 기록을 위한 브로커 API.

문서 프레임워크 · 개요

인증 및 접근 권한

인증된 브로커/가맹점 직원 세션과 해당 백엔드 권한이 필요합니다. 일반 고객 거래 앱 Token으로는 인증할 수 없습니다. 권한은 브로커 관리자에게 확인하세요.

선택한 Merchant BFF 환경으로 JSON POST 요청을 보냅니다. Finger Admin 클라이언트는 로그인한 브로커 직원 Access Token을 Bearer 형식으로 Authorization 헤더에 넣습니다.

https://dev-api.fingertrading.com/finger-bff-merchant
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.

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은 현재 페이지 세션에서만 사용하고 저장하지 않습니다. 공용 기기에서는 사용하지 말고 완료 후 지우세요.

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은 현재 페이지 세션에서만 사용하고 저장하지 않습니다. 공용 기기에서는 사용하지 말고 완료 후 지우세요.

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은 현재 페이지 세션에서만 사용하고 저장하지 않습니다. 공용 기기에서는 사용하지 말고 완료 후 지우세요.

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은 현재 페이지 세션에서만 사용하고 저장하지 않습니다. 공용 기기에서는 사용하지 말고 완료 후 지우세요.

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은 현재 페이지 세션에서만 사용하고 저장하지 않습니다. 공용 기기에서는 사용하지 말고 완료 후 지우세요.

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은 현재 페이지 세션에서만 사용하고 저장하지 않습니다. 공용 기기에서는 사용하지 말고 완료 후 지우세요.

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은 현재 페이지 세션에서만 사용하고 저장하지 않습니다. 공용 기기에서는 사용하지 말고 완료 후 지우세요.

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은 현재 페이지 세션에서만 사용하고 저장하지 않습니다. 공용 기기에서는 사용하지 말고 완료 후 지우세요.

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은 현재 페이지 세션에서만 사용하고 저장하지 않습니다. 공용 기기에서는 사용하지 말고 완료 후 지우세요.

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은 현재 페이지 세션에서만 사용하고 저장하지 않습니다. 공용 기기에서는 사용하지 말고 완료 후 지우세요.