MODA API Docs
GuidesAPI Reference
GuidesAPI Reference
  1. Trade
  • Order
    • 신규주문
      POST
    • TP/SL 주문
      POST
    • 정정주문
      POST
    • 청산주문
      POST
    • 취소주문
      POST
  • Trade
    • 청산 내역 조회
      GET
    • 주문내역 조회
      GET
    • 청산손익 조회
      GET
  • Stock
    • 주문 정보 조회
      GET
    • 스프레드 그룹 조회
      GET
    • 보유종목 조회
      GET
    • 주문잔고 조회
      GET
    • 주문종목 조회
      GET
  • Quote
    • 5단계 호가 조회
      GET
    • 틱 차트 데이터 조회
      GET
    • 일별 OHLC 데이터 조회
      GET
    • 캔들 차트 데이터 조회
      GET
  • Execution
    • 주문 체결 합계 조회
      GET
    • 미체결 내역 조회
      GET
    • 주문 체결 내역 조회
      GET
  • Asset
    • 보유 포지션 조회
      GET
    • 포지션증거금 조회
      GET
    • 주문증거금 조회
      GET
  • Account
    • 예탁자산 조회
    • 예수금/출금가능금액 조회
  1. Trade

주문내역 조회

GET
/trades/history
기간별 주문 내역을 조회합니다. TP/SL 주문은 주문구분이 CLOSE_OUT으로 표시됩니다.

인증 헤더#

헤더설명
AuthorizationBearer {JWT} 형식의 인증 토큰

주문유형코드 (orderTypeCd)#

값설명
MARKET시장가
LIMIT지정가
STOP조건시장가
LIMIT_STOP조건지정가
TPSLTP/SL

주문구분코드 (orderCd)#

값설명
PURCHASE매입
CLOSE_OUT청산

주문상태코드 (orderStatusCd)#

값설명
RECEIVED접수
SENT송신
CONFIRMED확인
REJECTED거부
BARRIER배리어
LIMIT_PRICE지정가
CANCELLED취소
FAILED실패
CLOSED종료

페이징#

nextKey — 초기 요청 시 빈 문자열, 이후 응답의 nextKey 값을 전송

요청

쿼리 파라미터

응답

🟢200
application/json
OK
본문

🟠400
요청요청 예시
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://dev.your-api-server.com/trades/history?orderStartDateTime=2025-08-01T00:00:00Z&orderEndDateTime=2025-08-31T23:59:59.999Z&nextKey='
응답응답 예시
200 - 예시 1
{
    "status": "success",
    "code": 200,
    "data": {
        "nextKey": "string",
        "details": [
            {
                "orderDateTime": "2019-08-24T14:15:22.123Z",
                "orderNo": "string",
                "stockCd": "string",
                "positionCd": "TOTAL",
                "orderTypeCd": "MARKET",
                "orderCd": "TOTAL",
                "orderQuantity": 0,
                "barrierPrice": 0,
                "orderPrice": 0,
                "profitRealizationBarrierPrice": 0,
                "lossCutBarrierPrice": 0,
                "executionQuantity": 0,
                "executionPrice": 0,
                "orderBalance": 0,
                "orderStatusCd": "RECEIVED"
            }
        ]
    }
}
수정일 2026-03-26 08:43:48
이전
청산 내역 조회
다음
청산손익 조회
Built with