Get KR Insider Trades (DART 임원·주요주주 소유보고)
get_dart_insider_tradesKorean insider transactions for a listed KR company, from DART's 임원ㆍ주요주주 특정증권등 소유상황보고서 (elestock) — the Korean equivalent of SEC Form 4. Includes a buy-vs-sell summary and an optional buy/sell filter.
Not this tool for: US insiders (get_edgar_insider_trades) or institutional managers, which are a different kind of holder entirely (get_edgar_13f).
Buy vs sell is the SIGN of the reported share change (증감수): positive = 취득 (acquire / buy), negative = 처분 (dispose / sell). Insider BUYING is a stronger sentiment signal.
Args:
company (required): KR 6-digit stock code (e.g. '005930'), company name, or 8-digit DART corp_code
limit: number of most-recent reports to return, 1-100 (default 20)
tx_type: 'all' (default) | 'buy' (share change > 0) | 'sell' (share change < 0)
response_format: 'markdown' (default) or 'json'
Returns: {company:{corp_code, corp_name}, tx_type, summary:{buys:{count,shares}, sells:{count,shares}}, count, trades:[{filedAt, reporter, position, registered_exec, major_shareholder, change, shares_after, change_rate}], notes}. summary totals cover the whole fetched set regardless of the filter.
Important: this elestock summary API does not provide transaction dates or prices. filedAt is the filing date, not the transaction date. The underlying filing may contain these details; use get_dart_document with the returned rcept_no to inspect its tables.
Examples:
"삼성전자 임원 매수" -> {company:'005930', tx_type:'buy'}
"SK하이닉스 내부자 매도 최근" -> {company:'000660', tx_type:'sell'}
Use when: monitoring KR officer / major-shareholder buy/sell activity. For US insiders use get_edgar_insider_trades. For institutional holdings use get_edgar_13f. Errors: unknown company -> use search_dart_company; a filter with no matches returns count 0 (not an error).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Number of most-recent reports (default 20) | |
| company | Yes | KR 6-digit stock code (e.g. '005930'), company name, or DART corp_code | |
| tx_type | No | 'all' (default), 'buy' = acquisitions (change > 0), 'sell' = disposals (change < 0) | all |
| response_format | No | 'markdown' for a table, 'json' for compact machine-readable output | markdown |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | ||
| notes | No | ||
| trades | Yes | ||
| company | Yes | ||
| summary | No | ||
| tx_type | No |