브로커 API 문서
브로커 API 문서
Finger Admin의 고객, 주문, 리스크 관리 흐름에서 사용하는 /mer-api/v1 인터페이스를 정리합니다. Merchant BFF가 제공하며 사용 가능 여부와 권한은 브로커 계정 및 할당 권한에 따라 달라집니다.
브로커 API 문서
Finger Admin의 고객, 주문, 리스크 관리 흐름에서 사용하는 /mer-api/v1 인터페이스를 정리합니다. Merchant BFF가 제공하며 사용 가능 여부와 권한은 브로커 계정 및 할당 권한에 따라 달라집니다.
Merchant BFF 기본 URL 및 인증
선택한 Merchant BFF 환경으로 JSON POST 요청을 보냅니다. Finger Admin 클라이언트는 로그인한 브로커 직원 Access Token을 Bearer 형식으로 Authorization 헤더에 넣습니다.
Authorization: Bearer <BROKER_STAFF_ACCESS_TOKEN>
API 분류별 보기
Customer list
Paged customer search; query keys are based on UserQueryDTO.
/mer-api/v1/customer/list요청 예시
{
"page": 1,
"pageSize": 20,
"query": {
"userNumber": "",
"brokerNumber": "",
"marketType": 0,
"startTime": "",
"endTime": ""
}
}요청 필드
pagenumberpageSizenumberqueryobject응답 예시
값은 예시입니다. 식별자는 권한이 있는 계정의 값으로 바꾸세요. 응답 본문은 Finger Admin 클라이언트 사용 방식에서 추정한 예시이므로 정확한 규격은 브로커에 확인하세요. 설정 및 주문 요청은 실제 데이터를 변경할 수 있습니다.
{
"code": 0,
"data": {
"total": 1,
"items": [
{
"id": "sample-id",
"userNumber": "U10001",
"status": 1
}
]
},
"msg": "success"
}요청 테스트 · /mer-api/v1/customer/list
준비됨. 보내기 버튼을 누르기 전에는 요청이 전송되지 않습니다.
응답—
Token은 현재 페이지 세션에서만 사용하고 저장하지 않습니다. 공용 기기에서는 사용하지 말고 완료 후 지우세요.
Market order pool
Queries the market order pool using MarketQueryDTO.
/mer-api/v1/order/market-order-list요청 예시
{
"marketType": 0
}요청 필드
marketTypenumber응답 예시
값은 예시입니다. 식별자는 권한이 있는 계정의 값으로 바꾸세요. 응답 본문은 Finger Admin 클라이언트 사용 방식에서 추정한 예시이므로 정확한 규격은 브로커에 확인하세요. 설정 및 주문 요청은 실제 데이터를 변경할 수 있습니다.
{
"code": 0,
"data": {
"total": 1,
"items": [
{
"id": "sample-id",
"userNumber": "U10001",
"status": 1
}
]
},
"msg": "success"
}요청 테스트 · /mer-api/v1/order/market-order-list
준비됨. 보내기 버튼을 누르기 전에는 요청이 전송되지 않습니다.
응답—
Token은 현재 페이지 세션에서만 사용하고 저장하지 않습니다. 공용 기기에서는 사용하지 말고 완료 후 지우세요.
Customer open positions
Paged customer holdings query.
/mer-api/v1/order/get-user-order-holding-list요청 예시
{
"page": 1,
"pageSize": 20,
"query": {
"userNumber": "",
"brokerNumber": "",
"marketType": 0,
"startTime": "",
"endTime": ""
}
}요청 필드
pagenumberpageSizenumberqueryobject응답 예시
값은 예시입니다. 식별자는 권한이 있는 계정의 값으로 바꾸세요. 응답 본문은 Finger Admin 클라이언트 사용 방식에서 추정한 예시이므로 정확한 규격은 브로커에 확인하세요. 설정 및 주문 요청은 실제 데이터를 변경할 수 있습니다.
{
"code": 0,
"data": {
"total": 1,
"items": [
{
"id": "sample-id",
"userNumber": "U10001",
"status": 1
}
]
},
"msg": "success"
}요청 테스트 · /mer-api/v1/order/get-user-order-holding-list
준비됨. 보내기 버튼을 누르기 전에는 요청이 전송되지 않습니다.
응답—
Token은 현재 페이지 세션에서만 사용하고 저장하지 않습니다. 공용 기기에서는 사용하지 말고 완료 후 지우세요.
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은 현재 페이지 세션에서만 사용하고 저장하지 않습니다. 공용 기기에서는 사용하지 말고 완료 후 지우세요.