일정에 따라 새로 고침
작은 스크립트로 매일 새 공시와 수치를 가져옵니다.
가이드 읽기 →모든 API
기업 대주주 API
미국, 일본, 한국의 5% 이상 보유자를 이름, 보고된 비율, 주식 수, 사건 날짜, 공시 참조와 함께 읽습니다.
첫 요청
5% 이상 보유자 가져오기
curl --request GET \
--url "https://api.narwhalapi.com/v1/companies/usa:0000789019/holders" \
--header "Authorization: Bearer $NARWHAL_API_KEY"엔드포인트
GET5% 이상 보유자 가져오기/v1/companies/{company_id}/holders
5% 이상 보유자와 보고된 비율, 주식 수, 이를 보고한 공시.
매개변수
company_id필수usa:0000789019 같은 기업 ID 또는 usa:MSFT 같은 티커 별칭.
응답 필드
holder필드보유자 이름, 주소나 개인 ID 번호 제외
percent필드공시에 적힌 소유 비율이며, 5.12는 5.12%를 뜻합니다
shares필드보유자에 대해 보고된 주식 수
event_date필드공시에 보고된 지분 변동 사건의 날짜
filed필드지분 공시가 제출된 날짜
filing_id필드보유 내역을 보고한 지분 공시의 식별자
security필드공시에 증권이 명시된 경우 증권 class, type, isin
전체 레퍼런스 →
활용 사례
데이터 범위
- 미국공시와 재무제표. 2009년부터의 이력.
- 일본3,800개 이상의 기업, 연간 및 반기.
- 한국지금까지 상장 기업의 약 절반.
출처
- 미국SEC EDGAR
- 일본EDINET, 금융청
- 한국DART, 금융감독원
관련 API
자주 묻는 질문
이 엔드포인트는 모든 주주를 나열하나요?
holders 엔드포인트는 지분 공시에 보고된 5% 이상 보유자를 다룹니다.
어떤 날짜와 공시 참조가 반환되나요?
각 보유자 레코드에는 보유자 이름, 비율, 주식 수와 함께 event_date, filed, filing_id가 포함됩니다.
티커 별칭으로 보유자를 조회할 수 있나요?
이 엔드포인트는 usa:0000789019 같은 회사 식별자와 usa:MSFT 같은 허용된 별칭을 받습니다.
보유자 이력은 얼마나 거슬러 올라가나요?
모든 계정이 전체 이력을 받으며 실시간으로 제공됩니다.
공시된 그대로의 퍼센트
퍼센트 값 5.12는 5.12%를 뜻하며, 공시에 적힌 비율과 같습니다.
이름만 제공
보유자 레코드에는 이름만 포함되며 주소나 개인 ID 번호는 포함되지 않습니다.
명시된 경우 증권
공시에 증권이 명시된 경우 security 객체에 class, type, isin이 포함됩니다.
무료 키로 시작하세요
12개월 동안 매달 10달러 상당의 무료 크레딧을 드립니다. 카드는 필요하지 않습니다.매달 10달러 상당의 무료 크레딧. 카드는 필요하지 않습니다.