公司行事曆 API：股利與股票分割

概覽

一段日期區間內的公司股利與股票分割，涵蓋我們支援的所有上市公司。每個請求都需要 Bearer 金鑰，REST 與 MCP 共用同一個額度餘額。

日期範圍為過去 30 天至未來 90 天，單一請求最多跨 7 天。省略 start 代表 UTC 的今天，省略 end 代表與 start 同一天。超出範圍會回傳 400 invalid_query，跨度過長則回傳 400 range_too_large。

目前僅支援 USA。其他國家會回傳 404 not_covered。只有在我們代號清單中的公司才會出現，並附我們的 id 與名稱；同一發行人的多個股票類別合為一列。

基礎網址： https://api.narwhalapi.com。 MCP 工具是 company_calendars, with one action ，適用於下列每個路由。

每個帳戶都能取得的內容

查看 定價 說明每次呼叫的費用。除非路由另有說明，請求依其所屬 API 的價格計費。

• 每個請求計為一次呼叫，與資料列數無關。
• 在我們代號清單中沒有有效標的的公司會被省略。
• 分割比例為新股換舊股：4:1 表示一股換四股，1:10 則是反向分割。

端點

每個路由都是 GET 請求，並需要將你的金鑰放在以下請求標頭中： Authorization: Bearer 標頭。範例僅展示回應的結構，並非即時資料。

公司股利行事曆

GET /v1/calendars/dividends

區間內除息的股利：除息日、每股金額與幣別。start 與 end 為含當日的日期（YYYY-MM-DD）；省略時，start 為今天（UTC），end 與 start 相同。日期範圍為過去 30 天至未來 90 天（超出會回傳 400 invalid_query），單一請求最多跨 7 天（400 range_too_large）。country 為 USA，目前僅支援這個國家（404 not_covered）。只有在我們代號清單中的公司才會出現，並附我們的 id 與名稱；同一發行人的單位與股票類別合為一列。所有帳號皆可使用，每個請求計為一次呼叫。

MCP：工具 company_calendars, action dividends。

參數

回應欄位

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/calendars/dividends?start=2026-10-26&end=2026-11-01"

{
  "entries": [
    {
      "ex_date": "2026-10-29",
      "id": "XNYS:KO",
      "symbol": "KO",
      "name": "The Coca-Cola Company",
      "amount": "0.51",
      "currency": "USD"
    }
  ],
  "next_cursor": null
}

公司股票分割行事曆

GET /v1/calendars/splits

區間內生效的股票分割，比例以新股換舊股表示（4:1 表示一股換四股；1:10 是反向分割）。start 與 end 為含當日的日期（YYYY-MM-DD）；省略時，start 為今天（UTC），end 與 start 相同。日期範圍為過去 30 天至未來 90 天（超出會回傳 400 invalid_query），單一請求最多跨 7 天（400 range_too_large）。country 為 USA，目前僅支援這個國家（404 not_covered）。只有在我們代號清單中的公司才會出現，並附我們的 id 與名稱；同一發行人的單位與股票類別合為一列。所有帳號皆可使用，每個請求計為一次呼叫。

MCP：工具 company_calendars, action splits。

參數

回應欄位

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/calendars/splits?start=2026-10-26&end=2026-11-01"

{
  "entries": [
    {
      "date": "2026-10-28",
      "id": "XNAS:EXMP",
      "symbol": "EXMP",
      "name": "Example Holdings Inc.",
      "ratio": "4:1"
    }
  ],
  "next_cursor": null
}

錯誤

錯誤使用共用的問題格式，並包含 request_id。查看 API 錯誤 處理：錯誤碼、額度與重試 了解格式與額度標頭。失敗的請求不計費。