📉 Korea KRX Short Selling Balances — KOSPI & KOSDAQ Disclosure

Stream net short selling balances for every stock on KOSPI and KOSDAQ, straight from the Korea Exchange (KRX) Data Marketplace — the official conduit for FSCMA Article 180-2 mandated short-position disclosure (개별종목 공매도 순보유잔고).

When KRX lifted the eight-month short selling ban on March 31, 2025, balance disclosure resumed. This actor surfaces the same end-of-day report institutional desks pay for through Bloomberg, KIS Pricing and CHECK — but as clean Apify dataset rows.

---

🎯 Why this actor

You're trying to…	This actor gives you…
Track which KOSPI 200 names are getting shorted before earnings	Per-stock short_balance_pct_of_outstanding for every trading day
Build a short-interest reversal factor	Daily time-series — 일자별 잔고 — across the whole market
Spot 0.5%+ short-balance accumulations on KOSDAQ small-caps	Market filter + minimum-position-percent threshold
Feed a quant pipeline / dashboard	Stable JSON schema with KRW value + share count + ratio

---

🚀 Quick start

{
  "market": "KOSPI",
  "min_short_position_pct": 1.0,
  "date_from": "2025-12-01",
  "date_to": "2025-12-05",
  "max_records": 200
}

Returns up to 200 records — one per (stock, trading-day) — for KOSPI names with at least a 1.0% net short balance during early December 2025.

Track a single stock

{
  "ticker_filter": "005930",
  "date_from": "2025-11-01",
  "date_to": "2025-12-05",
  "max_records": 60
}

Returns Samsung Electronics' (005930) net short balance for every trading day in the window. When ticker_filter is set the minimum-percent floor is ignored, so you see every reported day even at near-zero balances.

---

📦 Output schema

Every record is one stock on one trading day:

{
  "market": "KOSPI",
  "ticker": "005930",
  "company_name": "삼성전자",
  "company_name_en": "삼성전자",
  "short_volume": 1234567,
  "short_value_KRW": 412345678900,
  "short_balance_pct_of_outstanding": 0.83,
  "outstanding_shares": 5969782550,
  "market_cap_KRW": 489214600000000,
  "report_date": "2025-12-01",
  "source_url": "https://data.krx.co.kr/contents/MDC/MDI/mdiLoader/index.cmd?menuId=MDC0203"
}

Field	Korean	Description
market	시장구분	KOSPI or KOSDAQ
ticker	종목코드	6-digit Korean ticker
company_name	종목명	Issuer short name (Korean)
short_volume	공매도 잔고수량	Reported short position in shares
short_value_KRW	공매도 잔고금액	Position value in KRW
short_balance_pct_of_outstanding	공매도 잔고비율	% of listed shares (0.01% disclosure threshold)
outstanding_shares	상장주식수	Total listed shares
market_cap_KRW	시가총액	Market cap in KRW
report_date	보고일	Trading day this balance was reported for
source_url	출처	KRX MDC0203 disclosure page

---

💰 Pay-Per-Event pricing

Event	Price
Actor start	$0.005
Each short-balance record	$0.08

A typical KOSPI daily sweep returns ~150–250 records above the 0.5% threshold → $12–20 per day. Cheaper than a single Bloomberg EQS save, and the rows are yours.

---

🛠 How it works

1. Bootstraps a session against https://data.krx.co.kr/comm/srt/srtLoader/index.cmd?screenId=MDCSTAT305 to obtain the JSESSIONID cookie KRX requires.
2. POSTs to https://data.krx.co.kr/comm/bldAttendant/getJsonData.cmd with bld dbms/MDC_OUT/STAT/srt/MDCSTAT30501_OUT for each requested trading day, per market.
3. Normalises Korean field names (BAL_QTY, BAL_RTO, BAL_AMT, MKTCAP, …) into the schema above.
4. Iterates newest day first, so capping max_records low still surfaces the most recent disclosure.

The actor honours KRX rate-limits with a 600 ms gap between requests and is built without browser automation — pure async HTTP through httpx.

---

🇰🇷 한국어 안내 — KRX 공매도 잔고 데이터

이 액터는 한국거래소(KRX) 정보데이터시스템의 개별종목 공매도 순보유잔고 (FSCMA 제180조의2 의무공시) 데이터를 자동 수집합니다.

주요 항목

영문 필드	한국어	설명
market	시장구분	KOSPI / KOSDAQ
ticker	종목코드	6자리 종목코드 (예: 005930 = 삼성전자)
company_name	종목명	종목 약명
short_volume	공매도 잔고수량	보고일 기준 누적 공매도 잔고 (주)
short_value_KRW	공매도 잔고금액	잔고 평가금액 (원)
short_balance_pct_of_outstanding	공매도 잔고비율	상장주식수 대비 잔고 비율 (%)
outstanding_shares	상장주식수	보고일 기준 상장주식수
market_cap_KRW	시가총액	보고일 기준 시가총액 (원)
report_date	보고일	잔고 보고 기준일 (YYYY-MM-DD)

사용 예시

{
  "market": "KOSPI",
  "min_short_position_pct": 0.5,
  "date_from": "2025-11-01",
  "date_to": "2025-12-05",
  "max_records": 500
}

KOSPI 종목 중 공매도 잔고비율 0.5% 이상인 종목을 지정 기간 동안 조회합니다. 매매일이 아닌 날 (주말·공휴일)은 자동으로 건너뜁니다.

특정 종목만 추적하려면 ticker_filter에 6자리 종목코드를 입력하세요 (예: "005930" 삼성전자, "373220" LG에너지솔루션). 이 경우 잔고비율 하한값은 무시되어 보고된 모든 날짜가 출력됩니다.

데이터 출처

• 공시 페이지: data.krx.co.kr/contents/MDC/MDI/mdiLoader/index.cmd?menuId=MDC0203
• 법적 근거: 자본시장과 금융투자업에 관한 법률 제180조의2 (공매도 순보유잔고 공시 의무)
• 갱신 주기: KRX 영업일 마감 후 (T+2 일자별 누적 잔고)

---

⚖️ Legal posture

KRX publishes the source data under FSCMA Article 180-2, which mandates net short-position disclosure when a position reaches 0.01% of an issuer's outstanding shares. The Information Disclosure Service Terms permit non-real-time data redistribution for research and commercial use. This actor only consumes the publicly disclosed end-of-day balance — never live order-book or quote data.

The actor sends a standard browser User-Agent and respects KRX session timeouts; it does not scrape kind.krx.co.kr/details.do (Akamai-walled) and does not touch login-gated endpoints.

---

🇰🇷 Related Korea / APAC actors

• Kospi & Kosdaq Stock Screener — full equity screener with sector enrichment for both Korean boards.
• Japan EDINET Insider Filings — TSE-side institutional disclosure tracker (the Japanese analogue of DART/KIND).
• TSE Japan Stock Screener — Tokyo Stock Exchange equity screener.
• APAC IPO Calendar Sweep — pipeline of upcoming Korea + Japan + HK IPOs.

---

🆘 Troubleshooting

• Empty output for recent dates — KRX disclosure is T+2; balances for today aren't published until two business days later. Roll date_from back a week.
• short_balance_pct_of_outstanding is 0.00 across a stock — that stock simply has no reportable net short position (below the 0.01% disclosure floor). Filter at min_short_position_pct > 0.
• Weekend / holiday gaps — KRX is closed; the actor skips Mon–Fri automatically but Korean holidays are filtered server-side and return zero rows.
• Login alert in stack trace — KRX occasionally tightens session handling. Re-run; the actor re-bootstraps on each invocation.

---

Built by NexGenData. Questions? Drop a message in the Apify Discord, tag @nexgendata.

#korea #krx #shortselling #공매도 #잔고 #kospi #kosdaq #disclosure #fscma