# `kiwoomcli domestic rankings foreign-limit-usage`

```text
usage: kiwoomcli domestic rankings foreign-limit-usage [-h]
                                                       --market {all,kospi,kosdaq}
                                                       --period {today,previous,5d,10d,20d,60d}
                                                       --exchange {KRX,NXT,ALL}
                                                       [--pages PAGES]
                                                       [--format {pretty,json,jsonl,yaml}]
                                                       [--profile PROFILE]
                                                       [--mode {real,demo}]

options:
  -h, --help            show this help message and exit
  --market {all,kospi,kosdaq}
                        시장구분
  --period {today,previous,5d,10d,20d,60d}
                        기간
  --exchange {KRX,NXT,ALL}
                        거래소구분
  --pages PAGES         연속조회 페이지 수입니다 (기본 1, 0은 서버가 제공하는 모든 페이지).
  --format {pretty,json,jsonl,yaml}
                        출력 형식
  --profile PROFILE     사용할 계좌 별칭입니다. --mode/KIWOOM_MODE가 없을 때 생략하면 현재 계좌 별칭을
                        사용합니다.
  --mode {real,demo}    계좌 별칭 대신 모드를 직접 지정합니다.

Summary:
  외인한도소진율증가상위.

Behavior:
  조회 전용 명령입니다. 계좌/주문 상태를 변경하지 않습니다.

Examples:
  kiwoomcli domestic rankings foreign-limit-usage --market all --period today --exchange KRX

OpenAPI mapping:
  API ID: ka10036
  Request: POST /api/dostk/rkinfo
  --market -> mrkt_tp (required)
      all = 000
      kospi = 001
      kosdaq = 101
  --period -> dt (required)
      today = 0
      previous = 1
      5d = 5
      10d = 10
      20d = 20
      60d = 60
  --exchange -> stex_tp (required)
      KRX = 1
      NXT = 2
      ALL = 3
```