tradingOrdersDocsPage.orderManagement
주문 및 관리 API
인증된 Finger Trader 거래 엔드포인트로 주문 생성, 청산, 취소 및 수정을 수행합니다.
주문 변경 엔드포인트
실제 주문을 제출하거나 변경할 수 있습니다. 시도하기 전에 계정, 시장, 종목, 수량 및 브로커별 규칙을 확인하세요.
Bearer Access Token과 JSON 본문을 사용하는 POST 요청입니다. Flutter 클라이언트는 인증된 Finger Trader App BFF를 호출합니다. 시작하기: 인증
https://prod-api.fingertrader.com/finger-bff-app인증 요청 헤더Authorization: Bearer <ACCESS_TOKEN>Finger Trader 계정을 활성화하고 Finger 생태계 브로커에 계좌를 개설해야 합니다. Getting Started에 설명된 Bearer Access Token을 사용하세요.
성공 응답은 Finger Trader 표준 형식인 code, data, msg를 사용합니다. 각 엔드포인트 예시에 Flutter 클라이언트가 파싱하는 data 구조가 있습니다.
주문 생성
POST /app-api/v1/order/create-order
새 주문 요청을 제출합니다.
요청 예시
설명용 예시 값입니다. ticker, 시장, 계정/주문 ID, 브로커 ID를 본인 계정에서 확인한 값으로 바꾸고 전송 전에 필요한 필드를 브로커에 확인하세요.
{
"ticker": "EURUSD",
"orderType": 1,
"orderSide": 1,
"qty": "1000",
"coinType": 0,
"walletType": 2,
"price": "1.08500",
"marginRate": 10,
"stopLoss": "1.07500",
"takeProfit": "1.09500",
"marketType": 0
}| 파라미터 | 유형 | 클라이언트 DTO | 참고 |
|---|---|---|---|
ticker | string | null 가능 | 브로커 지원 Ticker / Symbol |
orderType | integer | null 가능 | Trading enum values |
orderSide | integer | null 가능 | Trading enum values |
qty | decimal string | null 가능 | — |
coinType | integer | null 가능 | Trading enum values |
walletType | integer | null 가능 | Trading enum values |
price | decimal string | null 가능 | — |
marginRate | integer | null 가능 | — |
stopLoss | decimal string | null 가능 | — |
takeProfit | decimal string | null 가능 | — |
marketType | integer | null 가능 | 지원 시장 및 marketType 코드 |
brokerId | integer | null 가능 | — |
Flutter DTO에서 null을 허용하거나 일부 선택 ID를 생략할 수 있다는 뜻이며 서버 검증 규칙을 의미하지는 않습니다. 필수 필드는 브로커/서비스에 확인하세요.
응답 예시
{"code":0,"data":true,"msg":""}클라이언트는 data가 boolean 결과일 것으로 예상합니다.
Try는 선택한 환경에 실제 요청을 보내며 주문 생성, 청산, 취소 또는 수정을 수행할 수 있습니다. 테스트 계정 및 브로커가 승인한 테스트 환경을 사용하세요.
REST 요청 테스트 · /app-api/v1/order/create-order
Access Token을 입력하고 요청 필드를 수정하세요. 요청을 보내면 브라우저에서 선택한 Finger Trader 공식 BFF 환경으로 직접 전송됩니다.
Try는 선택한 환경에 실제 요청을 보내며 주문 생성, 청산, 취소 또는 수정을 수행할 수 있습니다. 테스트 계정 및 브로커가 승인한 테스트 환경을 사용하세요.
준비되었습니다. 요청 보내기를 누르기 전까지 전송되지 않습니다.
응답이 여기에 표시됩니다.
Access Token은 이 페이지 메모리에만 보관되며 브라우저 저장소나 Finger Trader 웹사이트 서버로 전송되지 않습니다. 요청 버튼을 누른 후 선택한 공식 API 환경으로만 전송됩니다.
주문 청산
POST /app-api/v1/order/close-order
포지션 청산 요청을 제출합니다.
요청 예시
설명용 예시 값입니다. ticker, 시장, 계정/주문 ID, 브로커 ID를 본인 계정에서 확인한 값으로 바꾸고 전송 전에 필요한 필드를 브로커에 확인하세요.
{
"userId": "user_demo_12345",
"orderId": "order_demo_20250101_001",
"qty": "500",
"marketType": 0,
"brokerId": 10001,
"brokerPositionId": "position_demo_001",
"symbol": "EURUSD"
}| 파라미터 | 유형 | 클라이언트 DTO | 참고 |
|---|---|---|---|
userId | string | null 가능 | — |
orderId | string | null 가능 | — |
qty | decimal string | null 가능 | — |
marketType | integer | null 가능 | 지원 시장 및 marketType 코드 |
brokerId | integer | null 가능 | — |
brokerPositionId | string | null 가능 | — |
symbol | string | null 가능 | 브로커 지원 Ticker / Symbol |
Flutter DTO에서 null을 허용하거나 일부 선택 ID를 생략할 수 있다는 뜻이며 서버 검증 규칙을 의미하지는 않습니다. 필수 필드는 브로커/서비스에 확인하세요.
응답 예시
{"code":0,"data":true,"msg":""}클라이언트는 data가 boolean 결과일 것으로 예상합니다.
Try는 선택한 환경에 실제 요청을 보내며 주문 생성, 청산, 취소 또는 수정을 수행할 수 있습니다. 테스트 계정 및 브로커가 승인한 테스트 환경을 사용하세요.
REST 요청 테스트 · /app-api/v1/order/close-order
Access Token을 입력하고 요청 필드를 수정하세요. 요청을 보내면 브라우저에서 선택한 Finger Trader 공식 BFF 환경으로 직접 전송됩니다.
Try는 선택한 환경에 실제 요청을 보내며 주문 생성, 청산, 취소 또는 수정을 수행할 수 있습니다. 테스트 계정 및 브로커가 승인한 테스트 환경을 사용하세요.
준비되었습니다. 요청 보내기를 누르기 전까지 전송되지 않습니다.
응답이 여기에 표시됩니다.
Access Token은 이 페이지 메모리에만 보관되며 브라우저 저장소나 Finger Trader 웹사이트 서버로 전송되지 않습니다. 요청 버튼을 누른 후 선택한 공식 API 환경으로만 전송됩니다.
지정가 주문 취소
POST /app-api/v1/order/cancel-order
지정가 주문 취소 요청을 제출합니다.
요청 예시
설명용 예시 값입니다. ticker, 시장, 계정/주문 ID, 브로커 ID를 본인 계정에서 확인한 값으로 바꾸고 전송 전에 필요한 필드를 브로커에 확인하세요.
{
"userId": "user_demo_12345",
"orderId": "order_demo_20250101_002",
"marketType": 0,
"brokerId": 10001,
"brokerOrderId": "broker_order_demo_002",
"clientOrderId": "client_order_demo_002"
}| 파라미터 | 유형 | 클라이언트 DTO | 참고 |
|---|---|---|---|
userId | string | null 가능 | — |
orderId | string | null 가능 | — |
marketType | integer | null 가능 | 지원 시장 및 marketType 코드 |
brokerId | integer | null 가능 | — |
brokerOrderId | string | null 가능 | — |
clientOrderId | string | null 가능 | — |
Flutter DTO에서 null을 허용하거나 일부 선택 ID를 생략할 수 있다는 뜻이며 서버 검증 규칙을 의미하지는 않습니다. 필수 필드는 브로커/서비스에 확인하세요.
응답 예시
{"code":0,"data":true,"msg":""}클라이언트는 data가 boolean 결과일 것으로 예상합니다.
Try는 선택한 환경에 실제 요청을 보내며 주문 생성, 청산, 취소 또는 수정을 수행할 수 있습니다. 테스트 계정 및 브로커가 승인한 테스트 환경을 사용하세요.
REST 요청 테스트 · /app-api/v1/order/cancel-order
Access Token을 입력하고 요청 필드를 수정하세요. 요청을 보내면 브라우저에서 선택한 Finger Trader 공식 BFF 환경으로 직접 전송됩니다.
Try는 선택한 환경에 실제 요청을 보내며 주문 생성, 청산, 취소 또는 수정을 수행할 수 있습니다. 테스트 계정 및 브로커가 승인한 테스트 환경을 사용하세요.
준비되었습니다. 요청 보내기를 누르기 전까지 전송되지 않습니다.
응답이 여기에 표시됩니다.
Access Token은 이 페이지 메모리에만 보관되며 브라우저 저장소나 Finger Trader 웹사이트 서버로 전송되지 않습니다. 요청 버튼을 누른 후 선택한 공식 API 환경으로만 전송됩니다.
손절 / 익절 수정
POST /app-api/v1/order/modify-stop-profit-loss
손절 또는 익절 수정 요청을 제출합니다.
요청 예시
설명용 예시 값입니다. ticker, 시장, 계정/주문 ID, 브로커 ID를 본인 계정에서 확인한 값으로 바꾸고 전송 전에 필요한 필드를 브로커에 확인하세요.
{
"userId": "user_demo_12345",
"orderId": "order_demo_20250101_003",
"qty": "1000",
"price": "1.08600",
"stopLose": "1.07600",
"stopProfit": "1.09600",
"clearStopLoss": false,
"clearTakeProfit": false
}| 파라미터 | 유형 | 클라이언트 DTO | 참고 |
|---|---|---|---|
userId | string | null 가능 | — |
orderId | string | null 가능 | — |
qty | decimal string | null 가능 | — |
price | decimal string | null 가능 | — |
stopLose | decimal string | null 가능 | — |
stopProfit | decimal string | null 가능 | — |
clearStopLoss | boolean | null 가능 | — |
clearTakeProfit | boolean | null 가능 | — |
Flutter DTO에서 null을 허용하거나 일부 선택 ID를 생략할 수 있다는 뜻이며 서버 검증 규칙을 의미하지는 않습니다. 필수 필드는 브로커/서비스에 확인하세요.
응답 예시
{"code":0,"data":true,"msg":""}클라이언트는 data가 boolean 결과일 것으로 예상합니다.
Try는 선택한 환경에 실제 요청을 보내며 주문 생성, 청산, 취소 또는 수정을 수행할 수 있습니다. 테스트 계정 및 브로커가 승인한 테스트 환경을 사용하세요.
REST 요청 테스트 · /app-api/v1/order/modify-stop-profit-loss
Access Token을 입력하고 요청 필드를 수정하세요. 요청을 보내면 브라우저에서 선택한 Finger Trader 공식 BFF 환경으로 직접 전송됩니다.
Try는 선택한 환경에 실제 요청을 보내며 주문 생성, 청산, 취소 또는 수정을 수행할 수 있습니다. 테스트 계정 및 브로커가 승인한 테스트 환경을 사용하세요.
준비되었습니다. 요청 보내기를 누르기 전까지 전송되지 않습니다.
응답이 여기에 표시됩니다.
Access Token은 이 페이지 메모리에만 보관되며 브라우저 저장소나 Finger Trader 웹사이트 서버로 전송되지 않습니다. 요청 버튼을 누른 후 선택한 공식 API 환경으로만 전송됩니다.