# `kiwoomcli domestic orders gold-buy`

```text
usage: kiwoomcli domestic orders gold-buy [-h] --code CODE --qty QTY
                                          [--price PRICE]
                                          --order-type {limit,limit-ioc,limit-fok}
                                          [--confirm]
                                          [--format {pretty,json,jsonl,yaml}]
                                          [--profile PROFILE]
                                          [--mode {real,demo}]

options:
  -h, --help            show this help message and exit
  --code CODE           금현물 종목코드(예: M04020000 금 99.99_1kg)
  --qty QTY             주문수량
  --price PRICE         주문단가
  --order-type {limit,limit-ioc,limit-fok}
                        매매구분
  --confirm             지정하면 실제 주문을 전송합니다. 미지정 시 미전송 주문 확인을 출력합니다.
  --format {pretty,json,jsonl,yaml}
                        출력 형식
  --profile PROFILE     사용할 계좌 별칭입니다. --mode/KIWOOM_MODE가 없을 때 생략하면 현재 계좌 별칭을
                        사용합니다.
  --mode {real,demo}    계좌 별칭 대신 모드를 직접 지정합니다.

Summary:
  금현물 매수주문.

Behavior:
  --confirm 없이는 실제 주문 API를 호출하지 않고 미전송 주문 확인만 출력합니다.

Examples:
  kiwoomcli domestic orders gold-buy --code <code> --qty 10 --order-type limit --price 70000

OpenAPI mapping:
  API ID: kt50000
  Request: POST /api/dostk/ordr
  --code -> stk_cd (required)
  --qty -> ord_qty (required)
  --price -> ord_uv (optional)
  --order-type -> trde_tp (required)
      limit = 00
      limit-ioc = 10
      limit-fok = 20
```