tradingOrdersDocsPage.orders
주문 조회 API
인증된 거래 API로 보유 포지션, 거래 내역, 완료 주문 및 내역 통계를 조회합니다.
주문 조회 엔드포인트
목록 요청은 page, pageSize와 중첩 query 객체를 사용합니다. 응답에는 items와 페이지 정보가 포함됩니다. 계정에서 조회할 수 있는 조건과 데이터는 브로커 및 서비스 설정에 따라 달라집니다.
클라이언트 PageQuery 모델에는 page와 pageSize가 필요하며 query 필터는 null일 수 있습니다. 서버의 최대 페이지 크기와 커서 동작은 서비스 설정에 따릅니다.
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/get-holding-orders
계정의 보유 포지션 페이지를 조회합니다.
요청 예시
설명용 예시 값입니다. ticker, 시장, 계정/주문 ID, 브로커 ID를 본인 계정에서 확인한 값으로 바꾸고 전송 전에 필요한 필드를 브로커에 확인하세요.
{
"page": 1,
"pageSize": 20,
"query": {
"walletType": 2,
"marketType": 0,
"orderType": 1,
"coinType": 0,
"orderSide": 1,
"startTime": 1735689600000,
"endTime": 1735776000000
}
}| 파라미터 | 유형 | 클라이언트 DTO | 참고 |
|---|---|---|---|
page | integer | 클라이언트 모델 필수 | — |
pageSize | integer | 클라이언트 모델 필수 | — |
query | object | 클라이언트 모델 필수 | — |
query.nextCursor | string | null | null 가능 | — |
query.brokerId | integer | null | null 가능 | — |
query.walletType | integer | null | null 가능 | Trading enum values |
query.marketType | integer | null | null 가능 | 지원 시장 및 marketType 코드 |
query.orderType | integer | null | null 가능 | Trading enum values |
query.coinType | integer | null | null 가능 | Trading enum values |
query.orderSide | integer | null | null 가능 | Trading enum values |
query.startTime | integer | null | null 가능 | — |
query.endTime | integer | null | null 가능 | — |
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
계정의 거래 내역 페이지를 조회합니다.
요청 예시
설명용 예시 값입니다. ticker, 시장, 계정/주문 ID, 브로커 ID를 본인 계정에서 확인한 값으로 바꾸고 전송 전에 필요한 필드를 브로커에 확인하세요.
{
"page": 1,
"pageSize": 20,
"query": {
"walletType": 2,
"marketType": 0,
"orderType": 1,
"coinType": 0,
"orderSide": 1,
"startTime": 1735689600000,
"endTime": 1735776000000
}
}| 파라미터 | 유형 | 클라이언트 DTO | 참고 |
|---|---|---|---|
page | integer | 클라이언트 모델 필수 | — |
pageSize | integer | 클라이언트 모델 필수 | — |
query | object | 클라이언트 모델 필수 | — |
query.nextCursor | string | null | null 가능 | — |
query.brokerId | integer | null | null 가능 | — |
query.walletType | integer | null | null 가능 | Trading enum values |
query.marketType | integer | null | null 가능 | 지원 시장 및 marketType 코드 |
query.orderType | integer | null | null 가능 | Trading enum values |
query.coinType | integer | null | null 가능 | Trading enum values |
query.orderSide | integer | null | null 가능 | Trading enum values |
query.startTime | integer | null | null 가능 | — |
query.endTime | integer | null | null 가능 | — |
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
계정의 완료 주문 페이지를 조회합니다.
요청 예시
설명용 예시 값입니다. ticker, 시장, 계정/주문 ID, 브로커 ID를 본인 계정에서 확인한 값으로 바꾸고 전송 전에 필요한 필드를 브로커에 확인하세요.
{
"page": 1,
"pageSize": 20,
"query": {
"walletType": 2,
"marketType": 0,
"orderType": 1,
"coinType": 0,
"orderSide": 1,
"startTime": 1735689600000,
"endTime": 1735776000000
}
}| 파라미터 | 유형 | 클라이언트 DTO | 참고 |
|---|---|---|---|
page | integer | 클라이언트 모델 필수 | — |
pageSize | integer | 클라이언트 모델 필수 | — |
query | object | 클라이언트 모델 필수 | — |
query.nextCursor | string | null | null 가능 | — |
query.brokerId | integer | null | null 가능 | — |
query.walletType | integer | null | null 가능 | Trading enum values |
query.marketType | integer | null | null 가능 | 지원 시장 및 marketType 코드 |
query.orderType | integer | null | null 가능 | Trading enum values |
query.coinType | integer | null | null 가능 | Trading enum values |
query.orderSide | integer | null | null 가능 | Trading enum values |
query.startTime | integer | null | null 가능 | — |
query.endTime | integer | null | null 가능 | — |
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
거래 내역 통계 객체를 반환합니다.
요청 예시
설명용 예시 값입니다. ticker, 시장, 계정/주문 ID, 브로커 ID를 본인 계정에서 확인한 값으로 바꾸고 전송 전에 필요한 필드를 브로커에 확인하세요.
{
"walletType": 2,
"marketType": 0,
"orderType": 1,
"coinType": 0,
"orderSide": 1,
"startTime": 1735689600000,
"endTime": 1735776000000
}| 파라미터 | 유형 | 클라이언트 DTO | 참고 |
|---|---|---|---|
query.nextCursor | string | null | null 가능 | — |
query.brokerId | integer | null | null 가능 | — |
query.walletType | integer | null | null 가능 | Trading enum values |
query.marketType | integer | null | null 가능 | 지원 시장 및 marketType 코드 |
query.orderType | integer | null | null 가능 | Trading enum values |
query.coinType | integer | null | null 가능 | Trading enum values |
query.orderSide | integer | null | null 가능 | Trading enum values |
query.startTime | integer | null | null 가능 | — |
query.endTime | integer | null | null 가능 | — |
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 환경으로만 전송됩니다.