用途:通过OpenDART(금융감독원 전자공시시스템)REST API查询企业公示与财务数据,包括企业公示(业绩、分红、资本变动)、财务报表(季度、年度)、主要股东报告(5%以上持股)、高管股票交易。
安装与环境:安装命令为npx dlabs install trading-tools。需在项目根目录创建.env文件,可复制技能目录下的.claude/skills/opendart-api/.env.example。必须配置环境变量DART_API_KEY,密钥在https://opendart.fss.or.kr/ 申请。Python中可用load_dotenv()后通过os.getenv("DART_API_KEY")读取。
关键概念:OpenDART使用corp_code(DART唯一ID),而非stock_code(交易所代码)。可用python3 scripts/get_corp_code.py 035420转换,输出00266961。常见映射:005930 삼성전자→00126380,035420 NAVER→00266961,000660 SK하이닉스→00164779,035720 카카오→00401731。
主要接口:公示检索list.json(参数corp_code、bgn_de、end_de、pblntf_ty、page_count≤100);财务报表fnlttSinglAcntAll.json(参数bsns_year、reprt_code:11011为一季度、11012为半年、11013为三季度、11014为年度,fs_div取OFS个别或CFS合并);分红信息alotMatter.json;主要股东majorstock.json。
错误码:000正常、010未注册认证键、013无数据、020超出请求限制(每日10000次)。
限制:需要有效API密钥并受每日调用上限约束;公司标识必须使用corp_code;查询需遵守接口参数格式(日期YYYYMMDD、年度YYYY)。