按计划刷新
用一个小脚本每天拉取新的披露文件和数据。
阅读指南 →所有 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%，与披露文件中所写的百分比一致。
仅名称
股东记录包含名称，不含地址或个人身份证号码。
已指明的证券
当披露文件指明某只证券时，security 对象包含 class、type 和 isin。
从免费密钥开始
12 个月内每月赠送 10 美元免费额度，无需绑卡。每月 10 美元免费额度，无需绑卡。