所有 API

EDINET API 已上線涵蓋日本公司

EDINET 的日本申報文件與標準化財務報表已對逾 3,800 家公司上線,金額為申報時的日圓,期間為年度與半年度。

在線97.81% uptime, last 30天295 ms 一般回應

首次請求

列出公司的申報文件

curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies/usa:0000789019/filings" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

端點

GET列出公司的申報文件/v1/companies/{company_id}/filings

公司的申報文件,由新到舊,並附上每份官方文件的連結。

參數

  • company_id必填

    公司 ID,例如 usa:0000789019,或股票代號別名,例如 usa:MSFT。

  • type選填

    申報文件類別,例如 annual。


完整參考文件 →
GET取得標準化的公司財務報表/v1/companies/{company_id}/financials

公司的標準化財務報表,每個期間一列,以其申報幣別計。

參數

  • company_id必填

    公司 ID,例如 usa:0000789019,或股票代號別名,例如 usa:MSFT。

  • period選填

    annual 或 semiannual,視註冊機構而定。

  • statement選填

    income、balance、cash_flow 或 per_share。

  • fields選填

    以逗號分隔的項目名稱,例如 revenue,net_income。


完整參考文件 →
GET取得持股 5% 以上的股東/v1/companies/{company_id}/holders

持股 5% 以上的股東,附上申報的持股比例、股數,以及載明這些資料的申報文件。

參數

  • company_id必填

    公司 ID,例如 usa:0000789019,或股票代號別名,例如 usa:MSFT。


完整參考文件 →

使用情境

依排程重新整理

用小型腳本每天拉取新的申報文件與數據。

閱讀指南 →

接收新申報文件通知

申報文件發布時接收 webhook 並驗證。

閱讀指南 →

載入多年的公司資料

分頁讀取長期歷史資料,並在工作中斷時接續。

閱讀指南 →

不超出用量限制

快取回應並處理 429 錯誤,不遺失請求。

閱讀指南 →

向代理程式詢問某家公司

透過 MCP 讓 LLM 代理程式讀取申報文件與財務數據。

閱讀指南 →

涵蓋範圍

  • 日本超過 3,800 家公司,涵蓋年報與半年報。

來源

  • 日本EDINET,金融廳

相關 API

透過 Narwhal 使用 SEC EDGAR API

來自 SEC EDGAR 的美國即時申報文件與標準化 XBRL 財務數字

探索 API →

DART API 已涵蓋韓國公司

韓國申報文件與財務報表,已上線

探索 API →

公司申報文件 API 清單與單筆紀錄

申報文件清單、單筆記錄,以及各公司的最新申報文件

探索 API →

MOPS API 台灣申報文件與報表

來自 data.gov.tw 上 TWSE OpenAPI 與 TPEx 開放資料的台灣公司財務數字

探索 API →

ESEF API 取得公司年度申報

來自 26 個歐盟與歐洲經濟區國家公司的年度報告

探索 API →

受規範市場公司的英國財報 API

來自英國受監管市場發行人的年度報告

探索 API →

常見問題

目前可以透過 Narwhal 取得日本的申報文件嗎?

日本逾 3,800 家公司的申報文件與財務報表已上線。

日本有季度報表嗎?

日本報表涵蓋範圍僅有年度與半年度。

是否包含日本的大量持股報告?

是。包含 EDINET 的大量持股報告。

EDINET 資料來源

涵蓋範圍使用日本金融廳的 EDINET。

年度與半年度

日本報表期間僅有年度與半年度。

依申報的日圓

財務金額保留日圓數值,不換算,也不縮放為百萬單位。