FINGER TRADER

tradingOrdersDocsPage.orders

주문 조회 API

인증된 거래 API로 보유 포지션, 거래 내역, 완료 주문 및 내역 통계를 조회합니다.

문서 프레임워크 · 개요

주문 조회 엔드포인트

목록 요청은 page, pageSize와 중첩 query 객체를 사용합니다. 응답에는 items와 페이지 정보가 포함됩니다. 계정에서 조회할 수 있는 조건과 데이터는 브로커 및 서비스 설정에 따라 달라집니다.

클라이언트 PageQuery 모델에는 page와 pageSize가 필요하며 query 필터는 null일 수 있습니다. 서버의 최대 페이지 크기와 커서 동작은 서비스 설정에 따릅니다.

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/get-holding-orders

POST

계정의 보유 포지션 페이지를 조회합니다.

요청 예시

설명용 예시 값입니다. ticker, 시장, 계정/주문 ID, 브로커 ID를 본인 계정에서 확인한 값으로 바꾸고 전송 전에 필요한 필드를 브로커에 확인하세요.

{
  "page": 1,
  "pageSize": 20,
  "query": {
    "walletType": 2,
    "marketType": 0,
    "orderType": 1,
    "coinType": 0,
    "orderSide": 1,
    "startTime": 1735689600000,
    "endTime": 1735776000000
  }
}
요청 파라미터
파라미터유형클라이언트 DTO참고
pageinteger클라이언트 모델 필수—
pageSizeinteger클라이언트 모델 필수—
queryobject클라이언트 모델 필수—
query.nextCursorstring | nullnull 가능—
query.brokerIdinteger | nullnull 가능—
query.walletTypeinteger | nullnull 가능Trading enum values
query.marketTypeinteger | nullnull 가능지원 시장 및 marketType 코드
query.orderTypeinteger | nullnull 가능Trading enum values
query.coinTypeinteger | nullnull 가능Trading enum values
query.orderSideinteger | nullnull 가능Trading enum values
query.startTimeinteger | nullnull 가능—
query.endTimeinteger | nullnull 가능—

Flutter DTO에서 null을 허용하거나 일부 선택 ID를 생략할 수 있다는 뜻이며 서버 검증 규칙을 의미하지는 않습니다. 필수 필드는 브로커/서비스에 확인하세요.

응답 예시

{"code":0,"data":{"total":1,"items":[{
  "ticker": "<broker-supported ticker>",
  "orderId": "<order id>",
  "marketType": 0,
  "orderType": 0,
  "orderSide": 1,
  "qty": "<decimal>",
  "price": "<decimal>",
  "status": "<broker response status>",
  "filledQuantity": "<decimal>",
  "averagePrice": "<decimal>",
  "createTime": 0
}],"page":1,"pageSize":20,"nextCursor":null},"msg":""}

data는 total, items, page, pageSize, nextCursor가 포함된 페이지 결과입니다. 각 주문 항목에는 null 값과 브로커 필드가 있을 수 있습니다.

REST 요청 테스트 · /app-api/v1/order/get-holding-orders

Access Token을 입력하고 요청 필드를 수정하세요. 요청을 보내면 브라우저에서 선택한 Finger Trader 공식 BFF 환경으로 직접 전송됩니다.

준비되었습니다. 요청 보내기를 누르기 전까지 전송되지 않습니다.

응답
응답이 여기에 표시됩니다.

Access Token은 이 페이지 메모리에만 보관되며 브라우저 저장소나 Finger Trader 웹사이트 서버로 전송되지 않습니다. 요청 버튼을 누른 후 선택한 공식 API 환경으로만 전송됩니다.

거래 내역

POST /app-api/v1/order/trade-history

POST

계정의 거래 내역 페이지를 조회합니다.

요청 예시

설명용 예시 값입니다. ticker, 시장, 계정/주문 ID, 브로커 ID를 본인 계정에서 확인한 값으로 바꾸고 전송 전에 필요한 필드를 브로커에 확인하세요.

{
  "page": 1,
  "pageSize": 20,
  "query": {
    "walletType": 2,
    "marketType": 0,
    "orderType": 1,
    "coinType": 0,
    "orderSide": 1,
    "startTime": 1735689600000,
    "endTime": 1735776000000
  }
}
요청 파라미터
파라미터유형클라이언트 DTO참고
pageinteger클라이언트 모델 필수—
pageSizeinteger클라이언트 모델 필수—
queryobject클라이언트 모델 필수—
query.nextCursorstring | nullnull 가능—
query.brokerIdinteger | nullnull 가능—
query.walletTypeinteger | nullnull 가능Trading enum values
query.marketTypeinteger | nullnull 가능지원 시장 및 marketType 코드
query.orderTypeinteger | nullnull 가능Trading enum values
query.coinTypeinteger | nullnull 가능Trading enum values
query.orderSideinteger | nullnull 가능Trading enum values
query.startTimeinteger | nullnull 가능—
query.endTimeinteger | nullnull 가능—

Flutter DTO에서 null을 허용하거나 일부 선택 ID를 생략할 수 있다는 뜻이며 서버 검증 규칙을 의미하지는 않습니다. 필수 필드는 브로커/서비스에 확인하세요.

응답 예시

{"code":0,"data":{"total":1,"items":[{
  "ticker": "<broker-supported ticker>",
  "orderId": "<order id>",
  "marketType": 0,
  "orderType": 0,
  "orderSide": 1,
  "qty": "<decimal>",
  "price": "<decimal>",
  "status": "<broker response status>",
  "filledQuantity": "<decimal>",
  "averagePrice": "<decimal>",
  "createTime": 0
}],"page":1,"pageSize":20,"nextCursor":null},"msg":""}

data는 total, items, page, pageSize, nextCursor가 포함된 페이지 결과입니다. 각 주문 항목에는 null 값과 브로커 필드가 있을 수 있습니다.

REST 요청 테스트 · /app-api/v1/order/trade-history

Access Token을 입력하고 요청 필드를 수정하세요. 요청을 보내면 브라우저에서 선택한 Finger Trader 공식 BFF 환경으로 직접 전송됩니다.

준비되었습니다. 요청 보내기를 누르기 전까지 전송되지 않습니다.

응답
응답이 여기에 표시됩니다.

Access Token은 이 페이지 메모리에만 보관되며 브라우저 저장소나 Finger Trader 웹사이트 서버로 전송되지 않습니다. 요청 버튼을 누른 후 선택한 공식 API 환경으로만 전송됩니다.

완료 주문

POST /app-api/v1/order/completed-orders

POST

계정의 완료 주문 페이지를 조회합니다.

요청 예시

설명용 예시 값입니다. ticker, 시장, 계정/주문 ID, 브로커 ID를 본인 계정에서 확인한 값으로 바꾸고 전송 전에 필요한 필드를 브로커에 확인하세요.

{
  "page": 1,
  "pageSize": 20,
  "query": {
    "walletType": 2,
    "marketType": 0,
    "orderType": 1,
    "coinType": 0,
    "orderSide": 1,
    "startTime": 1735689600000,
    "endTime": 1735776000000
  }
}
요청 파라미터
파라미터유형클라이언트 DTO참고
pageinteger클라이언트 모델 필수—
pageSizeinteger클라이언트 모델 필수—
queryobject클라이언트 모델 필수—
query.nextCursorstring | nullnull 가능—
query.brokerIdinteger | nullnull 가능—
query.walletTypeinteger | nullnull 가능Trading enum values
query.marketTypeinteger | nullnull 가능지원 시장 및 marketType 코드
query.orderTypeinteger | nullnull 가능Trading enum values
query.coinTypeinteger | nullnull 가능Trading enum values
query.orderSideinteger | nullnull 가능Trading enum values
query.startTimeinteger | nullnull 가능—
query.endTimeinteger | nullnull 가능—

Flutter DTO에서 null을 허용하거나 일부 선택 ID를 생략할 수 있다는 뜻이며 서버 검증 규칙을 의미하지는 않습니다. 필수 필드는 브로커/서비스에 확인하세요.

응답 예시

{"code":0,"data":{"total":1,"items":[{
  "ticker": "<broker-supported ticker>",
  "orderId": "<order id>",
  "marketType": 0,
  "orderType": 0,
  "orderSide": 1,
  "qty": "<decimal>",
  "price": "<decimal>",
  "status": "<broker response status>",
  "filledQuantity": "<decimal>",
  "averagePrice": "<decimal>",
  "createTime": 0
}],"page":1,"pageSize":20,"nextCursor":null},"msg":""}

data는 total, items, page, pageSize, nextCursor가 포함된 페이지 결과입니다. 각 주문 항목에는 null 값과 브로커 필드가 있을 수 있습니다.

REST 요청 테스트 · /app-api/v1/order/completed-orders

Access Token을 입력하고 요청 필드를 수정하세요. 요청을 보내면 브라우저에서 선택한 Finger Trader 공식 BFF 환경으로 직접 전송됩니다.

준비되었습니다. 요청 보내기를 누르기 전까지 전송되지 않습니다.

응답
응답이 여기에 표시됩니다.

Access Token은 이 페이지 메모리에만 보관되며 브라우저 저장소나 Finger Trader 웹사이트 서버로 전송되지 않습니다. 요청 버튼을 누른 후 선택한 공식 API 환경으로만 전송됩니다.

거래 내역 통계

POST /app-api/v1/order/trade-history-stat

POST

거래 내역 통계 객체를 반환합니다.

요청 예시

설명용 예시 값입니다. ticker, 시장, 계정/주문 ID, 브로커 ID를 본인 계정에서 확인한 값으로 바꾸고 전송 전에 필요한 필드를 브로커에 확인하세요.

{
  "walletType": 2,
  "marketType": 0,
  "orderType": 1,
  "coinType": 0,
  "orderSide": 1,
  "startTime": 1735689600000,
  "endTime": 1735776000000
}
요청 파라미터
파라미터유형클라이언트 DTO참고
query.nextCursorstring | nullnull 가능—
query.brokerIdinteger | nullnull 가능—
query.walletTypeinteger | nullnull 가능Trading enum values
query.marketTypeinteger | nullnull 가능지원 시장 및 marketType 코드
query.orderTypeinteger | nullnull 가능Trading enum values
query.coinTypeinteger | nullnull 가능Trading enum values
query.orderSideinteger | nullnull 가능Trading enum values
query.startTimeinteger | nullnull 가능—
query.endTimeinteger | nullnull 가능—

Flutter 클라이언트는 startTime과 endTime을 UTC Unix 밀리초로 직렬화합니다.

Flutter DTO에서 null을 허용하거나 일부 선택 ID를 생략할 수 있다는 뜻이며 서버 검증 규칙을 의미하지는 않습니다. 필수 필드는 브로커/서비스에 확인하세요.

응답 예시

{"code":0,"data":{"totalProfile":"<decimal>"},"msg":""}

서비스가 반환하는 경우 data에 totalProfile이 포함됩니다.

REST 요청 테스트 · /app-api/v1/order/trade-history-stat

Access Token을 입력하고 요청 필드를 수정하세요. 요청을 보내면 브라우저에서 선택한 Finger Trader 공식 BFF 환경으로 직접 전송됩니다.

준비되었습니다. 요청 보내기를 누르기 전까지 전송되지 않습니다.

응답
응답이 여기에 표시됩니다.

Access Token은 이 페이지 메모리에만 보관되며 브라우저 저장소나 Finger Trader 웹사이트 서버로 전송되지 않습니다. 요청 버튼을 누른 후 선택한 공식 API 환경으로만 전송됩니다.