依排程重新整理
用小型腳本每天拉取新的申報文件與數據。
閱讀指南 →所有 API
公司大股東持股 API
讀取美國、日本與韓國持股 5% 以上的股東，包含姓名、申報百分比、股數、事件日期與申報文件參照。
首次請求
取得持股 5% 以上的股東
curl --request GET \
--url "https://api.narwhalapi.com/v1/companies/usa:0000789019/holders" \
--header "Authorization: Bearer $NARWHAL_API_KEY"端點
GET取得持股 5% 以上的股東/v1/companies/{company_id}/holders
持股 5% 以上的股東，附上申報的持股比例、股數，以及載明這些資料的申報文件。
參數
company_id必填公司 ID，例如 usa:0000789019，或股票代號別名，例如 usa:MSFT。
回應欄位
holder欄位股東姓名，不含地址或個人身分證號
percent欄位申報文件所載的持股比例；5.12 代表 5.12%
shares欄位股東持有的股數
event_date欄位申報文件所報告持股事件的日期
filed欄位持股申報文件的提交日期
filing_id欄位申報該持股之持股申報文件的識別碼
security欄位證券類別、類型，以及申報文件指明證券時的 isin
完整參考文件 →
使用情境
涵蓋範圍
- 美國申報文件與財務報表。歷史資料自 2009 年起。
- 日本超過 3,800 家公司，涵蓋年報與半年報。
- 韓國目前約涵蓋一半的上市公司。
來源
- 美國SEC EDGAR
- 日本EDINET，金融廳
- 韓國DART，金融監督院
相關 API
常見問題
這個端點會列出所有股東嗎？
股東端點涵蓋持股申報文件中所申報持股 5% 以上的股東。
會回傳哪些日期與申報文件參照？
每筆股東記錄除了股東名稱、百分比與股數外，還包含 event_date、filed 與 filing_id。
我可以使用股票代號別名查詢股東嗎？
此端點接受公司識別碼，例如 usa:0000789019，也接受認可的別名，例如 usa:MSFT。
股東資料可以回溯多久？
所有帳戶都可取得完整歷史，即時提供。
依申報的百分比
百分比數值 5.12 代表 5.12%，與申報文件中所寫的百分比相同。
僅姓名
股東記錄包含姓名，絕不含地址或個人身分證號。
指明時的證券
當申報文件指明證券時，證券物件會帶有 class、type 與 isin。
從免費金鑰開始
12 個月內每月贈送 10 美元免費額度，無需綁卡。每月 10 美元免費額度，無需綁卡。