FINGER TRADER

tradingOrdersDocsPage.orderManagement

주문 및 관리 API

인증된 Finger Trader 거래 엔드포인트로 주문 생성, 청산, 취소 및 수정을 수행합니다.

문서 프레임워크 · 개요

주문 변경 엔드포인트

실제 주문을 제출하거나 변경할 수 있습니다. 시도하기 전에 계정, 시장, 종목, 수량 및 브로커별 규칙을 확인하세요.

Bearer Access Token과 JSON 본문을 사용하는 POST 요청입니다. Flutter 클라이언트는 인증된 Finger Trader App BFF를 호출합니다. 시작하기: 인증

운영 App BFF 기본 URLhttps://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

POST

새 주문 요청을 제출합니다.

요청 예시

설명용 예시 값입니다. 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참고
tickerstringnull 가능브로커 지원 Ticker / Symbol
orderTypeintegernull 가능Trading enum values
orderSideintegernull 가능Trading enum values
qtydecimal stringnull 가능—
coinTypeintegernull 가능Trading enum values
walletTypeintegernull 가능Trading enum values
pricedecimal stringnull 가능—
marginRateintegernull 가능—
stopLossdecimal stringnull 가능—
takeProfitdecimal stringnull 가능—
marketTypeintegernull 가능지원 시장 및 marketType 코드
brokerIdintegernull 가능—

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

POST

포지션 청산 요청을 제출합니다.

요청 예시

설명용 예시 값입니다. 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참고
userIdstringnull 가능—
orderIdstringnull 가능—
qtydecimal stringnull 가능—
marketTypeintegernull 가능지원 시장 및 marketType 코드
brokerIdintegernull 가능—
brokerPositionIdstringnull 가능—
symbolstringnull 가능브로커 지원 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

POST

지정가 주문 취소 요청을 제출합니다.

요청 예시

설명용 예시 값입니다. 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참고
userIdstringnull 가능—
orderIdstringnull 가능—
marketTypeintegernull 가능지원 시장 및 marketType 코드
brokerIdintegernull 가능—
brokerOrderIdstringnull 가능—
clientOrderIdstringnull 가능—

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

POST

손절 또는 익절 수정 요청을 제출합니다.

요청 예시

설명용 예시 값입니다. 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참고
userIdstringnull 가능—
orderIdstringnull 가능—
qtydecimal stringnull 가능—
pricedecimal stringnull 가능—
stopLosedecimal stringnull 가능—
stopProfitdecimal stringnull 가능—
clearStopLossbooleannull 가능—
clearTakeProfitbooleannull 가능—

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 환경으로만 전송됩니다.