주문 (order)

매수·매도·정정·취소 등 주문 기능을 담당하는 모듈입니다.

실계좌 주의

env="real" 환경에서는 실제 계좌에 주문이 접수됩니다. 반드시 env="demo" (모의투자)로 먼저 테스트하세요.

파라미터 타입 안내

모든 고정 선택지 파라미터는 의미 있는 문자열 키를 사용합니다. API 내부 코드(숫자)로의 변환은 라이브러리가 자동으로 처리합니다.

타입	값	의미
OrderTradeType	"market" / "limit" / "conditional" / "best" / "priority" / "stop" / "mid" / "limit_ioc" / "market_ioc" / "best_ioc" / "limit_fok" / "market_fok" / "best_fok" / "mid_ioc" / "mid_fok" / "pre_market" / "after_hours" / "post_market"	매매구분
OrderExchange	"KRX" / "NXT" / "SOR"	국내거래소구분

매매구분 상세

값	한글명	비고
"limit"	보통(지정가)	가격 지정 필수
"market"	시장가	price 생략 가능
"conditional"	조건부지정가
"best"	최유리지정가
"priority"	최우선지정가
"stop"	스톱지정가	condition_price 지정 필수
"mid"	중간가
"limit_ioc"	보통(IOC)
"market_ioc"	시장가(IOC)
"best_ioc"	최유리(IOC)
"limit_fok"	보통(FOK)
"market_fok"	시장가(FOK)
"best_fok"	최유리(FOK)
"mid_ioc"	중간가(IOC)
"mid_fok"	중간가(FOK)
"pre_market"	장시작전시간외
"after_hours"	시간외단일가
"post_market"	장마감후시간외

API 레퍼런스

kiwoompy.order

주문 모듈 — 주식·신용 매수/매도/정정/취소 주문 (kt10000~kt10009) 및 금현물 주문·조회 (kt50000~kt50075).

KiwoomOrder

KiwoomOrder(api: KiwoomApi)

키움 REST API 주문 클라이언트.

주식·신용 매수/매도/정정/취소 주문 TR을 담당한다. 모든 메서드는 KiwoomApi를 통해 HTTP 요청을 전송하며, 응답을 dataclass로 파싱하여 반환한다.

주문은 실계좌에 직접 영향을 미치므로 env="real" 사용 시 주의한다.

Parameters:

Name	Type	Description	Default
api	KiwoomApi	인증 토큰이 설정된 KiwoomApi 인스턴스.	required

Source code in src/kiwoompy/order.py

def __init__(self, api: KiwoomApi) -> None:
    self._api = api

buy

buy(stock_code: str, quantity: str, trade_type: OrderTradeType, exchange: OrderExchange = 'KRX', price: str = '', condition_price: str = '') -> OrderResponse

주식 매수주문을 제출한다 (kt10000).

Parameters:

Name	Type	Description	Default
stock_code	str	종목코드 (예: "005930").	required
quantity	str	주문수량 (단위: 주).	required
trade_type	OrderTradeType	매매구분. "market": 시장가, "limit": 보통(지정가), "conditional": 조건부지정가 등. 시장가("market") 주문 시 price는 공백으로 전달한다.	required
exchange	OrderExchange	국내거래소구분. "KRX", "NXT", "SOR". 기본값 "KRX".	'KRX'
price	str	주문단가 (단위: 원). 시장가 주문 시 공백.	''
condition_price	str	조건단가. 스톱지정가("stop") 주문 시 스톱가. 기본값 공백.	''

Returns:

Type	Description
OrderResponse	매수주문 응답 OrderResponse (주문번호 포함).

Raises:

Type	Description
KiwoomAuthError	토큰 미발급 또는 인증 실패.
KiwoomApiError	서버 오류 또는 주문 실패.

Source code in src/kiwoompy/order.py

def buy(
    self,
    stock_code: str,
    quantity: str,
    trade_type: OrderTradeType,
    exchange: OrderExchange = "KRX",
    price: str = "",
    condition_price: str = "",
) -> OrderResponse:
    """주식 매수주문을 제출한다 (kt10000).

    Args:
        stock_code: 종목코드 (예: ``"005930"``).
        quantity: 주문수량 (단위: 주).
        trade_type: 매매구분.
            ``"market"``: 시장가, ``"limit"``: 보통(지정가), ``"conditional"``: 조건부지정가 등.
            시장가(``"market"``) 주문 시 ``price``는 공백으로 전달한다.
        exchange: 국내거래소구분. ``"KRX"``, ``"NXT"``, ``"SOR"``. 기본값 ``"KRX"``.
        price: 주문단가 (단위: 원). 시장가 주문 시 공백.
        condition_price: 조건단가. 스톱지정가(``"stop"``) 주문 시 스톱가. 기본값 공백.

    Returns:
        매수주문 응답 ``OrderResponse`` (주문번호 포함).

    Raises:
        KiwoomAuthError: 토큰 미발급 또는 인증 실패.
        KiwoomApiError: 서버 오류 또는 주문 실패.
    """
    raw = _check(self._api.post(
        self._ORDR_PATH,
        {
            "dmst_stex_tp": exchange,
            "stk_cd": stock_code,
            "ord_qty": quantity,
            "ord_uv": price,
            "trde_tp": _TRADE_TYPE_CODE[trade_type],
            "cond_uv": condition_price,
        },
        headers=self._headers("kt10000"),
    ))
    return OrderResponse(
        ord_no=raw.get("ord_no", ""),
        dmst_stex_tp=raw.get("dmst_stex_tp", ""),
    )

cancel

cancel(original_order_no: str, stock_code: str, cancel_quantity: str, exchange: OrderExchange = 'KRX') -> CancelOrderResponse

주식 취소주문을 제출한다 (kt10003).

미체결 주문을 취소한다.

Parameters:

Name	Type	Description	Default
original_order_no	str	원주문번호 (취소할 주문의 주문번호).	required
stock_code	str	종목코드.	required
cancel_quantity	str	취소수량 (단위: 주). "0" 입력 시 잔량 전부 취소.	required
exchange	OrderExchange	국내거래소구분. 기본값 "KRX".	'KRX'

Returns:

Type	Description
CancelOrderResponse	취소주문 응답 CancelOrderResponse (새 주문번호 포함).

Raises:

Type	Description
KiwoomAuthError	토큰 미발급 또는 인증 실패.
KiwoomApiError	서버 오류 또는 주문 실패.

Source code in src/kiwoompy/order.py

def cancel(
    self,
    original_order_no: str,
    stock_code: str,
    cancel_quantity: str,
    exchange: OrderExchange = "KRX",
) -> CancelOrderResponse:
    """주식 취소주문을 제출한다 (kt10003).

    미체결 주문을 취소한다.

    Args:
        original_order_no: 원주문번호 (취소할 주문의 주문번호).
        stock_code: 종목코드.
        cancel_quantity: 취소수량 (단위: 주). ``"0"`` 입력 시 잔량 전부 취소.
        exchange: 국내거래소구분. 기본값 ``"KRX"``.

    Returns:
        취소주문 응답 ``CancelOrderResponse`` (새 주문번호 포함).

    Raises:
        KiwoomAuthError: 토큰 미발급 또는 인증 실패.
        KiwoomApiError: 서버 오류 또는 주문 실패.
    """
    raw = _check(self._api.post(
        self._ORDR_PATH,
        {
            "dmst_stex_tp": exchange,
            "orig_ord_no": original_order_no,
            "stk_cd": stock_code,
            "cncl_qty": cancel_quantity,
        },
        headers=self._headers("kt10003"),
    ))
    return CancelOrderResponse(
        ord_no=raw.get("ord_no", ""),
        base_orig_ord_no=raw.get("base_orig_ord_no", ""),
        cncl_qty=raw.get("cncl_qty", ""),
    )

credit_buy

credit_buy(stock_code: str, quantity: str, trade_type: OrderTradeType, exchange: OrderExchange = 'KRX', price: str = '', condition_price: str = '') -> OrderResponse

신용 매수주문을 제출한다 (kt10006).

Parameters:

Name	Type	Description	Default
stock_code	str	종목코드.	required
quantity	str	주문수량 (단위: 주).	required
trade_type	OrderTradeType	매매구분. "market": 시장가, "limit": 보통(지정가) 등.	required
exchange	OrderExchange	국내거래소구분. 기본값 "KRX".	'KRX'
price	str	주문단가 (단위: 원). 시장가 주문 시 공백.	''
condition_price	str	조건단가. 기본값 공백.	''

Returns:

Type	Description
OrderResponse	신용 매수주문 응답 OrderResponse (주문번호 포함).

Raises:

Type	Description
KiwoomAuthError	토큰 미발급 또는 인증 실패.
KiwoomApiError	서버 오류 또는 주문 실패.

Source code in src/kiwoompy/order.py

def credit_buy(
    self,
    stock_code: str,
    quantity: str,
    trade_type: OrderTradeType,
    exchange: OrderExchange = "KRX",
    price: str = "",
    condition_price: str = "",
) -> OrderResponse:
    """신용 매수주문을 제출한다 (kt10006).

    Args:
        stock_code: 종목코드.
        quantity: 주문수량 (단위: 주).
        trade_type: 매매구분. ``"market"``: 시장가, ``"limit"``: 보통(지정가) 등.
        exchange: 국내거래소구분. 기본값 ``"KRX"``.
        price: 주문단가 (단위: 원). 시장가 주문 시 공백.
        condition_price: 조건단가. 기본값 공백.

    Returns:
        신용 매수주문 응답 ``OrderResponse`` (주문번호 포함).

    Raises:
        KiwoomAuthError: 토큰 미발급 또는 인증 실패.
        KiwoomApiError: 서버 오류 또는 주문 실패.
    """
    raw = _check(self._api.post(
        self._CRDORDR_PATH,
        {
            "dmst_stex_tp": exchange,
            "stk_cd": stock_code,
            "ord_qty": quantity,
            "ord_uv": price,
            "trde_tp": _TRADE_TYPE_CODE[trade_type],
            "cond_uv": condition_price,
        },
        headers=self._headers("kt10006"),
    ))
    return OrderResponse(
        ord_no=raw.get("ord_no", ""),
        dmst_stex_tp=raw.get("dmst_stex_tp", ""),
    )

credit_cancel

credit_cancel(original_order_no: str, stock_code: str, cancel_quantity: str, exchange: OrderExchange = 'KRX') -> CancelOrderResponse

신용 취소주문을 제출한다 (kt10009).

Parameters:

Name	Type	Description	Default
original_order_no	str	원주문번호.	required
stock_code	str	종목코드.	required
cancel_quantity	str	취소수량 (단위: 주). "0" 입력 시 잔량 전부 취소.	required
exchange	OrderExchange	국내거래소구분. 기본값 "KRX".	'KRX'

Returns:

Type	Description
CancelOrderResponse	신용 취소주문 응답 CancelOrderResponse.

Raises:

Type	Description
KiwoomAuthError	토큰 미발급 또는 인증 실패.
KiwoomApiError	서버 오류 또는 주문 실패.

Source code in src/kiwoompy/order.py

def credit_cancel(
    self,
    original_order_no: str,
    stock_code: str,
    cancel_quantity: str,
    exchange: OrderExchange = "KRX",
) -> CancelOrderResponse:
    """신용 취소주문을 제출한다 (kt10009).

    Args:
        original_order_no: 원주문번호.
        stock_code: 종목코드.
        cancel_quantity: 취소수량 (단위: 주). ``"0"`` 입력 시 잔량 전부 취소.
        exchange: 국내거래소구분. 기본값 ``"KRX"``.

    Returns:
        신용 취소주문 응답 ``CancelOrderResponse``.

    Raises:
        KiwoomAuthError: 토큰 미발급 또는 인증 실패.
        KiwoomApiError: 서버 오류 또는 주문 실패.
    """
    raw = _check(self._api.post(
        self._CRDORDR_PATH,
        {
            "dmst_stex_tp": exchange,
            "orig_ord_no": original_order_no,
            "stk_cd": stock_code,
            "cncl_qty": cancel_quantity,
        },
        headers=self._headers("kt10009"),
    ))
    return CancelOrderResponse(
        ord_no=raw.get("ord_no", ""),
        base_orig_ord_no=raw.get("base_orig_ord_no", ""),
        cncl_qty=raw.get("cncl_qty", ""),
    )

credit_modify

credit_modify(original_order_no: str, stock_code: str, modify_quantity: str, modify_price: str, exchange: OrderExchange = 'KRX', modify_condition_price: str = '') -> ModifyOrderResponse

신용 정정주문을 제출한다 (kt10008).

Parameters:

Name	Type	Description	Default
original_order_no	str	원주문번호.	required
stock_code	str	종목코드.	required
modify_quantity	str	정정수량 (단위: 주).	required
modify_price	str	정정단가 (단위: 원).	required
exchange	OrderExchange	국내거래소구분. 기본값 "KRX".	'KRX'
modify_condition_price	str	정정조건단가. 기본값 공백.	''

Returns:

Type	Description
ModifyOrderResponse	신용 정정주문 응답 ModifyOrderResponse.

Raises:

Type	Description
KiwoomAuthError	토큰 미발급 또는 인증 실패.
KiwoomApiError	서버 오류 또는 주문 실패.

Source code in src/kiwoompy/order.py

def credit_modify(
    self,
    original_order_no: str,
    stock_code: str,
    modify_quantity: str,
    modify_price: str,
    exchange: OrderExchange = "KRX",
    modify_condition_price: str = "",
) -> ModifyOrderResponse:
    """신용 정정주문을 제출한다 (kt10008).

    Args:
        original_order_no: 원주문번호.
        stock_code: 종목코드.
        modify_quantity: 정정수량 (단위: 주).
        modify_price: 정정단가 (단위: 원).
        exchange: 국내거래소구분. 기본값 ``"KRX"``.
        modify_condition_price: 정정조건단가. 기본값 공백.

    Returns:
        신용 정정주문 응답 ``ModifyOrderResponse``.

    Raises:
        KiwoomAuthError: 토큰 미발급 또는 인증 실패.
        KiwoomApiError: 서버 오류 또는 주문 실패.
    """
    raw = _check(self._api.post(
        self._CRDORDR_PATH,
        {
            "dmst_stex_tp": exchange,
            "orig_ord_no": original_order_no,
            "stk_cd": stock_code,
            "mdfy_qty": modify_quantity,
            "mdfy_uv": modify_price,
            "mdfy_cond_uv": modify_condition_price,
        },
        headers=self._headers("kt10008"),
    ))
    return ModifyOrderResponse(
        ord_no=raw.get("ord_no", ""),
        base_orig_ord_no=raw.get("base_orig_ord_no", ""),
        mdfy_qty=raw.get("mdfy_qty", ""),
        dmst_stex_tp=raw.get("dmst_stex_tp", ""),
    )

credit_sell

credit_sell(stock_code: str, quantity: str, trade_type: OrderTradeType, credit_deal_type: str, exchange: OrderExchange = 'KRX', price: str = '', credit_loan_date: str = '', condition_price: str = '') -> OrderResponse

신용 매도주문을 제출한다 (kt10007).

Parameters:

Name	Type	Description	Default
stock_code	str	종목코드.	required
quantity	str	주문수량 (단위: 주).	required
trade_type	OrderTradeType	매매구분. "market": 시장가, "limit": 보통(지정가) 등.	required
credit_deal_type	str	신용거래구분. "33": 융자, "99": 융자합.	required
exchange	OrderExchange	국내거래소구분. 기본값 "KRX".	'KRX'
price	str	주문단가 (단위: 원). 시장가 주문 시 공백.	''
credit_loan_date	str	대출일 (YYYYMMDD 형식). credit_deal_type="33" (융자) 일 때 필수.	''
condition_price	str	조건단가. 기본값 공백.	''

Returns:

Type	Description
OrderResponse	신용 매도주문 응답 OrderResponse (주문번호 포함).

Raises:

Type	Description
KiwoomAuthError	토큰 미발급 또는 인증 실패.
KiwoomApiError	서버 오류 또는 주문 실패.

Source code in src/kiwoompy/order.py

def credit_sell(
    self,
    stock_code: str,
    quantity: str,
    trade_type: OrderTradeType,
    credit_deal_type: str,
    exchange: OrderExchange = "KRX",
    price: str = "",
    credit_loan_date: str = "",
    condition_price: str = "",
) -> OrderResponse:
    """신용 매도주문을 제출한다 (kt10007).

    Args:
        stock_code: 종목코드.
        quantity: 주문수량 (단위: 주).
        trade_type: 매매구분. ``"market"``: 시장가, ``"limit"``: 보통(지정가) 등.
        credit_deal_type: 신용거래구분. ``"33"``: 융자, ``"99"``: 융자합.
        exchange: 국내거래소구분. 기본값 ``"KRX"``.
        price: 주문단가 (단위: 원). 시장가 주문 시 공백.
        credit_loan_date: 대출일 (``YYYYMMDD`` 형식).
            ``credit_deal_type="33"`` (융자) 일 때 필수.
        condition_price: 조건단가. 기본값 공백.

    Returns:
        신용 매도주문 응답 ``OrderResponse`` (주문번호 포함).

    Raises:
        KiwoomAuthError: 토큰 미발급 또는 인증 실패.
        KiwoomApiError: 서버 오류 또는 주문 실패.
    """
    raw = _check(self._api.post(
        self._CRDORDR_PATH,
        {
            "dmst_stex_tp": exchange,
            "stk_cd": stock_code,
            "ord_qty": quantity,
            "ord_uv": price,
            "trde_tp": _TRADE_TYPE_CODE[trade_type],
            "crd_deal_tp": credit_deal_type,
            "crd_loan_dt": credit_loan_date,
            "cond_uv": condition_price,
        },
        headers=self._headers("kt10007"),
    ))
    return OrderResponse(
        ord_no=raw.get("ord_no", ""),
        dmst_stex_tp=raw.get("dmst_stex_tp", ""),
    )

gold_balance

gold_balance() -> GoldBalance

금현물 잔고를 확인한다 (kt50020).

Returns:

Type	Description
GoldBalance	class:~kiwoompy.models.GoldBalance 인스턴스.

Raises:

Type	Description
KiwoomAuthError	토큰 미발급 또는 인증 실패.
KiwoomApiError	서버 오류.

Source code in src/kiwoompy/order.py

def gold_balance(self) -> GoldBalance:
    """금현물 잔고를 확인한다 (kt50020).

    Returns:
        :class:`~kiwoompy.models.GoldBalance` 인스턴스.

    Raises:
        KiwoomAuthError: 토큰 미발급 또는 인증 실패.
        KiwoomApiError: 서버 오류.
    """
    raw = _check(self._api.post(
        self._GOLD_ACNT_PATH,
        {},
        headers=self._headers("kt50020"),
    ))
    holdings = [
        GoldBalanceItem(
            stk_cd=it.get("stk_cd", ""),
            stk_nm=it.get("stk_nm", ""),
            real_qty=it.get("real_qty", ""),
            avg_prc=it.get("avg_prc", ""),
            cur_prc=it.get("cur_prc", ""),
            est_amt=it.get("est_amt", ""),
            est_lspft=it.get("est_lspft", ""),
            est_ratio=it.get("est_ratio", ""),
            cmsn=it.get("cmsn", ""),
            vlad_tax=it.get("vlad_tax", ""),
            book_amt2=it.get("book_amt2", ""),
            pl_prch_prc=it.get("pl_prch_prc", ""),
            qty=it.get("qty", ""),
            buy_qty=it.get("buy_qty", ""),
            sell_qty=it.get("sell_qty", ""),
            able_qty=it.get("able_qty", ""),
        )
        for it in raw.get("gold_acnt_evlt_prst", [])
    ]
    return GoldBalance(
        tot_entr=raw.get("tot_entr", ""),
        net_entr=raw.get("net_entr", ""),
        tot_est_amt=raw.get("tot_est_amt", ""),
        net_amt=raw.get("net_amt", ""),
        tot_book_amt2=raw.get("tot_book_amt2", ""),
        tot_dep_amt=raw.get("tot_dep_amt", ""),
        paym_alowa=raw.get("paym_alowa", ""),
        pl_amt=raw.get("pl_amt", ""),
        items=holdings,
    )

gold_buy

gold_buy(stock_code: GoldStockCode, order_quantity: str, trade_type: GoldOrderTradeType, order_price: str = '') -> GoldOrderResponse

금현물 매수주문을 제출한다 (kt50000).

Parameters:

Name	Type	Description	Default
stock_code	GoldStockCode	금현물 종목코드. "M04020000" (금 99.99_1kg) 또는 "M04020100" (미니금 99.99_100g).	required
order_quantity	str	주문수량 (단위: g).	required
trade_type	GoldOrderTradeType	매매구분. "normal":보통, "normal_ioc":보통(IOC), "normal_fok":보통(FOK).	required
order_price	str	주문단가. 시장가 주문 시 생략 가능.	''

Returns:

Type	Description
GoldOrderResponse	class:~kiwoompy.models.GoldOrderResponse 인스턴스.

Raises:

Type	Description
KiwoomAuthError	토큰 미발급 또는 인증 실패.
KiwoomApiError	서버 오류 또는 주문 실패.

Source code in src/kiwoompy/order.py

def gold_buy(
    self,
    stock_code: GoldStockCode,
    order_quantity: str,
    trade_type: GoldOrderTradeType,
    order_price: str = "",
) -> GoldOrderResponse:
    """금현물 매수주문을 제출한다 (kt50000).

    Args:
        stock_code: 금현물 종목코드.
            ``"M04020000"`` (금 99.99_1kg) 또는 ``"M04020100"`` (미니금 99.99_100g).
        order_quantity: 주문수량 (단위: g).
        trade_type: 매매구분. ``"normal"``:보통, ``"normal_ioc"``:보통(IOC), ``"normal_fok"``:보통(FOK).
        order_price: 주문단가. 시장가 주문 시 생략 가능.

    Returns:
        :class:`~kiwoompy.models.GoldOrderResponse` 인스턴스.

    Raises:
        KiwoomAuthError: 토큰 미발급 또는 인증 실패.
        KiwoomApiError: 서버 오류 또는 주문 실패.
    """
    body: dict[str, str] = {
        "stk_cd":  stock_code,
        "ord_qty": order_quantity,
        "trde_tp": _GOLD_TRADE_TYPE_CODE[trade_type],
    }
    if order_price:
        body["ord_uv"] = order_price
    raw = _check(self._api.post(
        self._GOLD_ORDR_PATH,
        body,
        headers=self._headers("kt50000"),
    ))
    return GoldOrderResponse(ord_no=raw.get("ord_no", ""))

gold_cancel

gold_cancel(stock_code: GoldStockCode, original_order_no: str, cancel_quantity: str) -> GoldCancelOrderResponse

금현물 취소주문을 제출한다 (kt50003).

Parameters:

Name	Type	Description	Default
stock_code	GoldStockCode	금현물 종목코드. "M04020000" (금 99.99_1kg) 또는 "M04020100" (미니금 99.99_100g).	required
original_order_no	str	원주문번호.	required
cancel_quantity	str	취소수량 (단위: g). "0" 입력 시 잔량 전부 취소.	required

Returns:

Type	Description
GoldCancelOrderResponse	class:~kiwoompy.models.GoldCancelOrderResponse 인스턴스.

Raises:

Type	Description
KiwoomAuthError	토큰 미발급 또는 인증 실패.
KiwoomApiError	서버 오류 또는 주문 실패.

Source code in src/kiwoompy/order.py

def gold_cancel(
    self,
    stock_code: GoldStockCode,
    original_order_no: str,
    cancel_quantity: str,
) -> GoldCancelOrderResponse:
    """금현물 취소주문을 제출한다 (kt50003).

    Args:
        stock_code: 금현물 종목코드.
            ``"M04020000"`` (금 99.99_1kg) 또는 ``"M04020100"`` (미니금 99.99_100g).
        original_order_no: 원주문번호.
        cancel_quantity: 취소수량 (단위: g). ``"0"`` 입력 시 잔량 전부 취소.

    Returns:
        :class:`~kiwoompy.models.GoldCancelOrderResponse` 인스턴스.

    Raises:
        KiwoomAuthError: 토큰 미발급 또는 인증 실패.
        KiwoomApiError: 서버 오류 또는 주문 실패.
    """
    raw = _check(self._api.post(
        self._GOLD_ORDR_PATH,
        {
            "orig_ord_no": original_order_no,
            "stk_cd":      stock_code,
            "cncl_qty":    cancel_quantity,
        },
        headers=self._headers("kt50003"),
    ))
    return GoldCancelOrderResponse(
        ord_no=raw.get("ord_no", ""),
        base_orig_ord_no=raw.get("base_orig_ord_no", ""),
        cncl_qty=raw.get("cncl_qty", ""),
    )

gold_deposit

gold_deposit() -> GoldDeposit

금현물 예수금을 조회한다 (kt50021).

Returns:

Type	Description
GoldDeposit	class:~kiwoompy.models.GoldDeposit 인스턴스.

Raises:

Type	Description
KiwoomAuthError	토큰 미발급 또는 인증 실패.
KiwoomApiError	서버 오류.

Source code in src/kiwoompy/order.py

def gold_deposit(self) -> GoldDeposit:
    """금현물 예수금을 조회한다 (kt50021).

    Returns:
        :class:`~kiwoompy.models.GoldDeposit` 인스턴스.

    Raises:
        KiwoomAuthError: 토큰 미발급 또는 인증 실패.
        KiwoomApiError: 서버 오류.
    """
    raw = _check(self._api.post(
        self._GOLD_ACNT_PATH,
        {},
        headers=self._headers("kt50021"),
    ))
    return GoldDeposit(
        entra=raw.get("entra", ""),
        profa_ch=raw.get("profa_ch", ""),
        chck_ina_amt=raw.get("chck_ina_amt", ""),
        etc_loan=raw.get("etc_loan", ""),
        etc_loan_dlfe=raw.get("etc_loan_dlfe", ""),
        etc_loan_tot=raw.get("etc_loan_tot", ""),
        prsm_entra=raw.get("prsm_entra", ""),
        buy_exct_amt=raw.get("buy_exct_amt", ""),
        sell_exct_amt=raw.get("sell_exct_amt", ""),
        sell_buy_exct_amt=raw.get("sell_buy_exct_amt", ""),
        dly_amt=raw.get("dly_amt", ""),
        prsm_pymn_alow_amt=raw.get("prsm_pymn_alow_amt", ""),
        pymn_alow_amt=raw.get("pymn_alow_amt", ""),
        ord_alow_amt=raw.get("ord_alow_amt", ""),
    )

gold_modify

gold_modify(stock_code: GoldStockCode, original_order_no: str, modify_quantity: str, modify_price: str) -> GoldModifyOrderResponse

금현물 정정주문을 제출한다 (kt50002).

Parameters:

Name	Type	Description	Default
stock_code	GoldStockCode	금현물 종목코드. "M04020000" (금 99.99_1kg) 또는 "M04020100" (미니금 99.99_100g).	required
original_order_no	str	원주문번호.	required
modify_quantity	str	정정수량 (단위: g).	required
modify_price	str	정정단가.	required

Returns:

Type	Description
GoldModifyOrderResponse	class:~kiwoompy.models.GoldModifyOrderResponse 인스턴스.

Raises:

Type	Description
KiwoomAuthError	토큰 미발급 또는 인증 실패.
KiwoomApiError	서버 오류 또는 주문 실패.

Source code in src/kiwoompy/order.py

def gold_modify(
    self,
    stock_code: GoldStockCode,
    original_order_no: str,
    modify_quantity: str,
    modify_price: str,
) -> GoldModifyOrderResponse:
    """금현물 정정주문을 제출한다 (kt50002).

    Args:
        stock_code: 금현물 종목코드.
            ``"M04020000"`` (금 99.99_1kg) 또는 ``"M04020100"`` (미니금 99.99_100g).
        original_order_no: 원주문번호.
        modify_quantity: 정정수량 (단위: g).
        modify_price: 정정단가.

    Returns:
        :class:`~kiwoompy.models.GoldModifyOrderResponse` 인스턴스.

    Raises:
        KiwoomAuthError: 토큰 미발급 또는 인증 실패.
        KiwoomApiError: 서버 오류 또는 주문 실패.
    """
    raw = _check(self._api.post(
        self._GOLD_ORDR_PATH,
        {
            "stk_cd":      stock_code,
            "orig_ord_no": original_order_no,
            "mdfy_qty":    modify_quantity,
            "mdfy_uv":     modify_price,
        },
        headers=self._headers("kt50002"),
    ))
    return GoldModifyOrderResponse(
        ord_no=raw.get("ord_no", ""),
        base_orig_ord_no=raw.get("base_orig_ord_no", ""),
        mdfy_qty=raw.get("mdfy_qty", ""),
    )

gold_order_detail

gold_order_detail(stock_bond_type: StockBondType, sell_type: SellType, exchange: str, query_type: OrderHistoryQueryType = 'asc', order_date: str = '', stock_code: str = '', from_order_no: str = '') -> GoldOrderDetail

금현물 주문체결을 조회한다 (kt50031).

Parameters:

Name	Type	Description	Default
stock_bond_type	StockBondType	주식채권구분. "all":전체, "stock":주식, "bond":채권.	required
sell_type	SellType	매도수구분. "all":전체, "sell":매도, "buy":매수.	required
exchange	str	국내거래소구분. "%":전체, "KRX", "NXT", "SOR".	required
query_type	OrderHistoryQueryType	조회구분. "asc":주문순, "desc":역순, "unfilled":미체결, "filled_only":체결내역만. 기본값 "asc".	'asc'
order_date	str	주문일자 ("YYYYMMDD"). 공백 허용.	''
stock_code	str	종목코드. 공백 시 전체 종목.	''
from_order_no	str	시작주문번호. 공백 시 전체 주문.	''

Returns:

Type	Description
GoldOrderDetail	class:~kiwoompy.models.GoldOrderDetail 인스턴스.

Raises:

Type	Description
KiwoomAuthError	토큰 미발급 또는 인증 실패.
KiwoomApiError	서버 오류.

Source code in src/kiwoompy/order.py

def gold_order_detail(
    self,
    stock_bond_type: StockBondType,
    sell_type: SellType,
    exchange: str,
    query_type: OrderHistoryQueryType = "asc",
    order_date: str = "",
    stock_code: str = "",
    from_order_no: str = "",
) -> GoldOrderDetail:
    """금현물 주문체결을 조회한다 (kt50031).

    Args:
        stock_bond_type: 주식채권구분. ``"all"``:전체, ``"stock"``:주식, ``"bond"``:채권.
        sell_type: 매도수구분. ``"all"``:전체, ``"sell"``:매도, ``"buy"``:매수.
        exchange: 국내거래소구분. ``"%"``:전체, ``"KRX"``, ``"NXT"``, ``"SOR"``.
        query_type: 조회구분. ``"asc"``:주문순, ``"desc"``:역순, ``"unfilled"``:미체결, ``"filled_only"``:체결내역만. 기본값 ``"asc"``.
        order_date: 주문일자 (``"YYYYMMDD"``). 공백 허용.
        stock_code: 종목코드. 공백 시 전체 종목.
        from_order_no: 시작주문번호. 공백 시 전체 주문.

    Returns:
        :class:`~kiwoompy.models.GoldOrderDetail` 인스턴스.

    Raises:
        KiwoomAuthError: 토큰 미발급 또는 인증 실패.
        KiwoomApiError: 서버 오류.
    """
    raw = _check(self._api.post(
        self._GOLD_ACNT_PATH,
        {
            "ord_dt":       order_date,
            "qry_tp":       _ORDER_HISTORY_QUERY_CODE[query_type],
            "stk_bond_tp":  _STOCK_BOND_CODE[stock_bond_type],
            "sell_tp":      _SELL_TYPE_CODE[sell_type],
            "stk_cd":       stock_code,
            "fr_ord_no":    from_order_no,
            "dmst_stex_tp": exchange,
        },
        headers=self._headers("kt50031"),
    ))
    items = [
        GoldOrderDetailItem(
            ord_no=it.get("ord_no", ""),
            stk_cd=it.get("stk_cd", ""),
            trde_tp=it.get("trde_tp", ""),
            crd_tp=it.get("crd_tp", ""),
            ord_qty=it.get("ord_qty", ""),
            ord_uv=it.get("ord_uv", ""),
            cnfm_qty=it.get("cnfm_qty", ""),
            acpt_tp=it.get("acpt_tp", ""),
            rsrv_tp=it.get("rsrv_tp", ""),
            ord_tm=it.get("ord_tm", ""),
            ori_ord=it.get("ori_ord", ""),
            stk_nm=it.get("stk_nm", ""),
            io_tp_nm=it.get("io_tp_nm", ""),
            loan_dt=it.get("loan_dt", ""),
            cntr_qty=it.get("cntr_qty", ""),
            cntr_uv=it.get("cntr_uv", ""),
            ord_remnq=it.get("ord_remnq", ""),
            comm_ord_tp=it.get("comm_ord_tp", ""),
            mdfy_cncl=it.get("mdfy_cncl", ""),
            cnfm_tm=it.get("cnfm_tm", ""),
            dmst_stex_tp=it.get("dmst_stex_tp", ""),
            cond_uv=it.get("cond_uv", ""),
        )
        for it in raw.get("acnt_ord_cntr_prps_dtl", [])
    ]
    return GoldOrderDetail(items=items)

gold_order_status

gold_order_status(order_date: str, market_deal_type: str, stock_bond_type: StockBondType, sell_type: SellType, query_type: GoldOrderQueryType = 'asc', stock_code: str = '', from_order_no: str = '', exchange: str = '%') -> GoldOrderStatus

금현물 주문체결전체를 조회한다 (kt50030).

Parameters:

Name	Type	Description	Default
order_date	str	주문일자 ("YYYYMMDD").	required
market_deal_type	str	시장구분.	required
stock_bond_type	StockBondType	주식채권구분. "all":전체, "stock":주식, "bond":채권.	required
sell_type	SellType	매도수구분. "all":전체, "sell":매도, "buy":매수.	required
query_type	GoldOrderQueryType	조회구분. "asc":주문순, "desc":역순. 기본값 "asc".	'asc'
stock_code	str	종목코드. 공백 시 전체 종목.	''
from_order_no	str	시작주문번호. 공백 시 전체 주문.	''
exchange	str	국내거래소구분. "%":전체, "KRX", "NXT", "SOR". 기본값 "%".	'%'

Returns:

Type	Description
GoldOrderStatus	class:~kiwoompy.models.GoldOrderStatus 인스턴스.

Raises:

Type	Description
KiwoomAuthError	토큰 미발급 또는 인증 실패.
KiwoomApiError	서버 오류.

Source code in src/kiwoompy/order.py

def gold_order_status(
    self,
    order_date: str,
    market_deal_type: str,
    stock_bond_type: StockBondType,
    sell_type: SellType,
    query_type: GoldOrderQueryType = "asc",
    stock_code: str = "",
    from_order_no: str = "",
    exchange: str = "%",
) -> GoldOrderStatus:
    """금현물 주문체결전체를 조회한다 (kt50030).

    Args:
        order_date: 주문일자 (``"YYYYMMDD"``).
        market_deal_type: 시장구분.
        stock_bond_type: 주식채권구분. ``"all"``:전체, ``"stock"``:주식, ``"bond"``:채권.
        sell_type: 매도수구분. ``"all"``:전체, ``"sell"``:매도, ``"buy"``:매수.
        query_type: 조회구분. ``"asc"``:주문순, ``"desc"``:역순. 기본값 ``"asc"``.
        stock_code: 종목코드. 공백 시 전체 종목.
        from_order_no: 시작주문번호. 공백 시 전체 주문.
        exchange: 국내거래소구분. ``"%"``:전체, ``"KRX"``, ``"NXT"``, ``"SOR"``. 기본값 ``"%"``.

    Returns:
        :class:`~kiwoompy.models.GoldOrderStatus` 인스턴스.

    Raises:
        KiwoomAuthError: 토큰 미발급 또는 인증 실패.
        KiwoomApiError: 서버 오류.
    """
    raw = _check(self._api.post(
        self._GOLD_ACNT_PATH,
        {
            "ord_dt":       order_date,
            "qry_tp":       _GOLD_ORDER_QUERY_CODE[query_type],
            "mrkt_deal_tp": market_deal_type,
            "stk_bond_tp":  _STOCK_BOND_CODE[stock_bond_type],
            "slby_tp":      _SELL_TYPE_CODE[sell_type],
            "stk_cd":       stock_code,
            "fr_ord_no":    from_order_no,
            "dmst_stex_tp": exchange,
        },
        headers=self._headers("kt50030"),
    ))
    items = [
        GoldOrderStatusItem(
            stk_bond_tp=it.get("stk_bond_tp", ""),
            ord_no=it.get("ord_no", ""),
            stk_cd=it.get("stk_cd", ""),
            trde_tp=it.get("trde_tp", ""),
            io_tp_nm=it.get("io_tp_nm", ""),
            ord_qty=it.get("ord_qty", ""),
            ord_uv=it.get("ord_uv", ""),
            cnfm_qty=it.get("cnfm_qty", ""),
            data_send_end_tp=it.get("data_send_end_tp", ""),
            mrkt_deal_tp=it.get("mrkt_deal_tp", ""),
            rsrv_tp=it.get("rsrv_tp", ""),
            orig_ord_no=it.get("orig_ord_no", ""),
            stk_nm=it.get("stk_nm", ""),
            dcd_tp_nm=it.get("dcd_tp_nm", ""),
            crd_deal_tp=it.get("crd_deal_tp", ""),
            cntr_qty=it.get("cntr_qty", ""),
            cntr_uv=it.get("cntr_uv", ""),
            ord_remnq=it.get("ord_remnq", ""),
            comm_ord_tp=it.get("comm_ord_tp", ""),
            mdfy_cncl_tp=it.get("mdfy_cncl_tp", ""),
            dmst_stex_tp=it.get("dmst_stex_tp", ""),
            cond_uv=it.get("cond_uv", ""),
        )
        for it in raw.get("acnt_ord_cntr_prst", [])
    ]
    return GoldOrderStatus(items=items)

gold_sell

gold_sell(stock_code: GoldStockCode, order_quantity: str, trade_type: GoldOrderTradeType, order_price: str = '') -> GoldOrderResponse

금현물 매도주문을 제출한다 (kt50001).

Parameters:

Name	Type	Description	Default
stock_code	GoldStockCode	금현물 종목코드. "M04020000" (금 99.99_1kg) 또는 "M04020100" (미니금 99.99_100g).	required
order_quantity	str	주문수량 (단위: g).	required
trade_type	GoldOrderTradeType	매매구분. "normal":보통, "normal_ioc":보통(IOC), "normal_fok":보통(FOK).	required
order_price	str	주문단가. 시장가 주문 시 생략 가능.	''

Returns:

Type	Description
GoldOrderResponse	class:~kiwoompy.models.GoldOrderResponse 인스턴스.

Raises:

Type	Description
KiwoomAuthError	토큰 미발급 또는 인증 실패.
KiwoomApiError	서버 오류 또는 주문 실패.

Source code in src/kiwoompy/order.py

def gold_sell(
    self,
    stock_code: GoldStockCode,
    order_quantity: str,
    trade_type: GoldOrderTradeType,
    order_price: str = "",
) -> GoldOrderResponse:
    """금현물 매도주문을 제출한다 (kt50001).

    Args:
        stock_code: 금현물 종목코드.
            ``"M04020000"`` (금 99.99_1kg) 또는 ``"M04020100"`` (미니금 99.99_100g).
        order_quantity: 주문수량 (단위: g).
        trade_type: 매매구분. ``"normal"``:보통, ``"normal_ioc"``:보통(IOC), ``"normal_fok"``:보통(FOK).
        order_price: 주문단가. 시장가 주문 시 생략 가능.

    Returns:
        :class:`~kiwoompy.models.GoldOrderResponse` 인스턴스.

    Raises:
        KiwoomAuthError: 토큰 미발급 또는 인증 실패.
        KiwoomApiError: 서버 오류 또는 주문 실패.
    """
    body: dict[str, str] = {
        "stk_cd":  stock_code,
        "ord_qty": order_quantity,
        "trde_tp": _GOLD_TRADE_TYPE_CODE[trade_type],
    }
    if order_price:
        body["ord_uv"] = order_price
    raw = _check(self._api.post(
        self._GOLD_ORDR_PATH,
        body,
        headers=self._headers("kt50001"),
    ))
    return GoldOrderResponse(ord_no=raw.get("ord_no", ""))

gold_trade_history

gold_trade_history(start_date: str = '', end_date: str = '', trade_type: GoldTransactionType = 'all', stock_code: str = '') -> GoldTradeHistory

금현물 거래내역을 조회한다 (kt50032).

Parameters:

Name	Type	Description	Default
start_date	str	시작일자 ("YYYYMMDD"). 공백 허용.	''
end_date	str	종료일자 ("YYYYMMDD"). 공백 허용.	''
trade_type	GoldTransactionType	구분. "all":전체, "deposit_withdraw":입출금, "withdraw":출고, "trade":매매, "buy":매수, "sell":매도, "deposit":입금, "payment":출금. 기본값 "all".	'all'
stock_code	str	종목코드. 공백 시 전체 종목.	''

Returns:

Type	Description
GoldTradeHistory	class:~kiwoompy.models.GoldTradeHistory 인스턴스.

Raises:

Type	Description
KiwoomAuthError	토큰 미발급 또는 인증 실패.
KiwoomApiError	서버 오류.

Source code in src/kiwoompy/order.py

def gold_trade_history(
    self,
    start_date: str = "",
    end_date: str = "",
    trade_type: GoldTransactionType = "all",
    stock_code: str = "",
) -> GoldTradeHistory:
    """금현물 거래내역을 조회한다 (kt50032).

    Args:
        start_date: 시작일자 (``"YYYYMMDD"``). 공백 허용.
        end_date: 종료일자 (``"YYYYMMDD"``). 공백 허용.
        trade_type: 구분. ``"all"``:전체, ``"deposit_withdraw"``:입출금, ``"withdraw"``:출고,
            ``"trade"``:매매, ``"buy"``:매수, ``"sell"``:매도, ``"deposit"``:입금, ``"payment"``:출금. 기본값 ``"all"``.
        stock_code: 종목코드. 공백 시 전체 종목.

    Returns:
        :class:`~kiwoompy.models.GoldTradeHistory` 인스턴스.

    Raises:
        KiwoomAuthError: 토큰 미발급 또는 인증 실패.
        KiwoomApiError: 서버 오류.
    """
    raw = _check(self._api.post(
        self._GOLD_ACNT_PATH,
        {
            "strt_dt": start_date,
            "end_dt":  end_date,
            "tp":      _GOLD_TRANSACTION_CODE[trade_type],
            "stk_cd":  stock_code,
        },
        headers=self._headers("kt50032"),
    ))
    items = [
        GoldTradeHistoryItem(
            deal_dt=it.get("deal_dt", ""),
            deal_no=it.get("deal_no", ""),
            rmrk_nm=it.get("rmrk_nm", ""),
            deal_qty=it.get("deal_qty", ""),
            gold_spot_vat=it.get("gold_spot_vat", ""),
            exct_amt=it.get("exct_amt", ""),
            dly_sum=it.get("dly_sum", ""),
            entra_remn=it.get("entra_remn", ""),
            mdia_nm=it.get("mdia_nm", ""),
            orig_deal_no=it.get("orig_deal_no", ""),
            stk_nm=it.get("stk_nm", ""),
            uv_exrt=it.get("uv_exrt", ""),
            cmsn=it.get("cmsn", ""),
            uncl_ocr=it.get("uncl_ocr", ""),
            rpym_sum=it.get("rpym_sum", ""),
            spot_remn=it.get("spot_remn", ""),
            proc_time=it.get("proc_time", ""),
            rcpy_no=it.get("rcpy_no", ""),
            stk_cd=it.get("stk_cd", ""),
            deal_amt=it.get("deal_amt", ""),
            tax_tot_amt=it.get("tax_tot_amt", ""),
            cntr_dt=it.get("cntr_dt", ""),
            proc_brch_nm=it.get("proc_brch_nm", ""),
            prcsr=it.get("prcsr", ""),
        )
        for it in raw.get("gold_trde_hist", [])
    ]
    return GoldTradeHistory(
        acnt_print=raw.get("acnt_print", ""),
        items=items,
    )

gold_unfilled

gold_unfilled(order_date: str, market_deal_type: str, stock_bond_type: StockBondType, sell_type: SellType, query_type: GoldOrderQueryType = 'asc', stock_code: str = '', from_order_no: str = '', exchange: str = '%') -> GoldUnfilled

금현물 미체결을 조회한다 (kt50075).

Parameters:

Name	Type	Description	Default
order_date	str	주문일자 ("YYYYMMDD").	required
market_deal_type	str	시장구분.	required
stock_bond_type	StockBondType	주식채권구분. "all":전체, "stock":주식, "bond":채권.	required
sell_type	SellType	매도수구분. "all":전체, "sell":매도, "buy":매수.	required
query_type	GoldOrderQueryType	조회구분. "asc":주문순, "desc":역순. 기본값 "asc".	'asc'
stock_code	str	종목코드. 공백 시 전체 종목.	''
from_order_no	str	시작주문번호. 공백 시 전체 주문.	''
exchange	str	국내거래소구분. "%":전체, "KRX", "NXT", "SOR". 기본값 "%".	'%'

Returns:

Type	Description
GoldUnfilled	class:~kiwoompy.models.GoldUnfilled 인스턴스.

Raises:

Type	Description
KiwoomAuthError	토큰 미발급 또는 인증 실패.
KiwoomApiError	서버 오류.

Source code in src/kiwoompy/order.py

def gold_unfilled(
    self,
    order_date: str,
    market_deal_type: str,
    stock_bond_type: StockBondType,
    sell_type: SellType,
    query_type: GoldOrderQueryType = "asc",
    stock_code: str = "",
    from_order_no: str = "",
    exchange: str = "%",
) -> GoldUnfilled:
    """금현물 미체결을 조회한다 (kt50075).

    Args:
        order_date: 주문일자 (``"YYYYMMDD"``).
        market_deal_type: 시장구분.
        stock_bond_type: 주식채권구분. ``"all"``:전체, ``"stock"``:주식, ``"bond"``:채권.
        sell_type: 매도수구분. ``"all"``:전체, ``"sell"``:매도, ``"buy"``:매수.
        query_type: 조회구분. ``"asc"``:주문순, ``"desc"``:역순. 기본값 ``"asc"``.
        stock_code: 종목코드. 공백 시 전체 종목.
        from_order_no: 시작주문번호. 공백 시 전체 주문.
        exchange: 국내거래소구분. ``"%"``:전체, ``"KRX"``, ``"NXT"``, ``"SOR"``. 기본값 ``"%"``.

    Returns:
        :class:`~kiwoompy.models.GoldUnfilled` 인스턴스.

    Raises:
        KiwoomAuthError: 토큰 미발급 또는 인증 실패.
        KiwoomApiError: 서버 오류.
    """
    raw = _check(self._api.post(
        self._GOLD_ACNT_PATH,
        {
            "ord_dt":       order_date,
            "qry_tp":       _GOLD_ORDER_QUERY_CODE[query_type],
            "mrkt_deal_tp": market_deal_type,
            "stk_bond_tp":  _STOCK_BOND_CODE[stock_bond_type],
            "sell_tp":      _SELL_TYPE_CODE[sell_type],
            "stk_cd":       stock_code,
            "fr_ord_no":    from_order_no,
            "dmst_stex_tp": exchange,
        },
        headers=self._headers("kt50075"),
    ))
    items = [
        GoldUnfilledItem(
            stk_bond_tp=it.get("stk_bond_tp", ""),
            ord_no=it.get("ord_no", ""),
            stk_cd=it.get("stk_cd", ""),
            trde_tp=it.get("trde_tp", ""),
            io_tp_nm=it.get("io_tp_nm", ""),
            ord_qty=it.get("ord_qty", ""),
            ord_uv=it.get("ord_uv", ""),
            cnfm_qty=it.get("cnfm_qty", ""),
            data_send_end_tp=it.get("data_send_end_tp", ""),
            mrkt_deal_tp=it.get("mrkt_deal_tp", ""),
            rsrv_tp=it.get("rsrv_tp", ""),
            orig_ord_no=it.get("orig_ord_no", ""),
            stk_nm=it.get("stk_nm", ""),
            dcd_tp_nm=it.get("dcd_tp_nm", ""),
            crd_deal_tp=it.get("crd_deal_tp", ""),
            cntr_qty=it.get("cntr_qty", ""),
            cntr_uv=it.get("cntr_uv", ""),
            ord_remnq=it.get("ord_remnq", ""),
            comm_ord_tp=it.get("comm_ord_tp", ""),
            mdfy_cncl_tp=it.get("mdfy_cncl_tp", ""),
            dmst_stex_tp=it.get("dmst_stex_tp", ""),
            cond_uv=it.get("cond_uv", ""),
        )
        for it in raw.get("acnt_ord_oso_prst", [])
    ]
    return GoldUnfilled(items=items)

modify

modify(original_order_no: str, stock_code: str, modify_quantity: str, modify_price: str, exchange: OrderExchange = 'KRX', modify_condition_price: str = '') -> ModifyOrderResponse

주식 정정주문을 제출한다 (kt10002).

미체결 주문의 수량 또는 가격을 정정한다.

Parameters:

Name	Type	Description	Default
original_order_no	str	원주문번호 (정정할 주문의 주문번호).	required
stock_code	str	종목코드.	required
modify_quantity	str	정정수량 (단위: 주).	required
modify_price	str	정정단가 (단위: 원).	required
exchange	OrderExchange	국내거래소구분. 기본값 "KRX".	'KRX'
modify_condition_price	str	정정조건단가. 기본값 공백.	''

Returns:

Type	Description
ModifyOrderResponse	정정주문 응답 ModifyOrderResponse (새 주문번호 포함).

Raises:

Type	Description
KiwoomAuthError	토큰 미발급 또는 인증 실패.
KiwoomApiError	서버 오류 또는 주문 실패.

Source code in src/kiwoompy/order.py

def modify(
    self,
    original_order_no: str,
    stock_code: str,
    modify_quantity: str,
    modify_price: str,
    exchange: OrderExchange = "KRX",
    modify_condition_price: str = "",
) -> ModifyOrderResponse:
    """주식 정정주문을 제출한다 (kt10002).

    미체결 주문의 수량 또는 가격을 정정한다.

    Args:
        original_order_no: 원주문번호 (정정할 주문의 주문번호).
        stock_code: 종목코드.
        modify_quantity: 정정수량 (단위: 주).
        modify_price: 정정단가 (단위: 원).
        exchange: 국내거래소구분. 기본값 ``"KRX"``.
        modify_condition_price: 정정조건단가. 기본값 공백.

    Returns:
        정정주문 응답 ``ModifyOrderResponse`` (새 주문번호 포함).

    Raises:
        KiwoomAuthError: 토큰 미발급 또는 인증 실패.
        KiwoomApiError: 서버 오류 또는 주문 실패.
    """
    raw = _check(self._api.post(
        self._ORDR_PATH,
        {
            "dmst_stex_tp": exchange,
            "orig_ord_no": original_order_no,
            "stk_cd": stock_code,
            "mdfy_qty": modify_quantity,
            "mdfy_uv": modify_price,
            "mdfy_cond_uv": modify_condition_price,
        },
        headers=self._headers("kt10002"),
    ))
    return ModifyOrderResponse(
        ord_no=raw.get("ord_no", ""),
        base_orig_ord_no=raw.get("base_orig_ord_no", ""),
        mdfy_qty=raw.get("mdfy_qty", ""),
        dmst_stex_tp=raw.get("dmst_stex_tp", ""),
    )

sell

sell(stock_code: str, quantity: str, trade_type: OrderTradeType, exchange: OrderExchange = 'KRX', price: str = '', condition_price: str = '') -> OrderResponse

주식 매도주문을 제출한다 (kt10001).

Parameters:

Name	Type	Description	Default
stock_code	str	종목코드 (예: "005930").	required
quantity	str	주문수량 (단위: 주).	required
trade_type	OrderTradeType	매매구분. "market": 시장가, "limit": 보통(지정가), "conditional": 조건부지정가 등. 시장가("market") 주문 시 price는 공백으로 전달한다.	required
exchange	OrderExchange	국내거래소구분. "KRX", "NXT", "SOR". 기본값 "KRX".	'KRX'
price	str	주문단가 (단위: 원). 시장가 주문 시 공백.	''
condition_price	str	조건단가. 스톱지정가("stop") 주문 시 스톱가. 기본값 공백.	''

Returns:

Type	Description
OrderResponse	매도주문 응답 OrderResponse (주문번호 포함).

Raises:

Type	Description
KiwoomAuthError	토큰 미발급 또는 인증 실패.
KiwoomApiError	서버 오류 또는 주문 실패.

Source code in src/kiwoompy/order.py

def sell(
    self,
    stock_code: str,
    quantity: str,
    trade_type: OrderTradeType,
    exchange: OrderExchange = "KRX",
    price: str = "",
    condition_price: str = "",
) -> OrderResponse:
    """주식 매도주문을 제출한다 (kt10001).

    Args:
        stock_code: 종목코드 (예: ``"005930"``).
        quantity: 주문수량 (단위: 주).
        trade_type: 매매구분.
            ``"market"``: 시장가, ``"limit"``: 보통(지정가), ``"conditional"``: 조건부지정가 등.
            시장가(``"market"``) 주문 시 ``price``는 공백으로 전달한다.
        exchange: 국내거래소구분. ``"KRX"``, ``"NXT"``, ``"SOR"``. 기본값 ``"KRX"``.
        price: 주문단가 (단위: 원). 시장가 주문 시 공백.
        condition_price: 조건단가. 스톱지정가(``"stop"``) 주문 시 스톱가. 기본값 공백.

    Returns:
        매도주문 응답 ``OrderResponse`` (주문번호 포함).

    Raises:
        KiwoomAuthError: 토큰 미발급 또는 인증 실패.
        KiwoomApiError: 서버 오류 또는 주문 실패.
    """
    raw = _check(self._api.post(
        self._ORDR_PATH,
        {
            "dmst_stex_tp": exchange,
            "stk_cd": stock_code,
            "ord_qty": quantity,
            "ord_uv": price,
            "trde_tp": _TRADE_TYPE_CODE[trade_type],
            "cond_uv": condition_price,
        },
        headers=self._headers("kt10001"),
    ))
    return OrderResponse(
        ord_no=raw.get("ord_no", ""),
        dmst_stex_tp=raw.get("dmst_stex_tp", ""),
    )