公司日历 API 参考

概览

若干天时间窗口内的公司股息和拆股数据，覆盖我们涵盖的所有上市公司。每个请求都需要 Bearer 密钥，REST 和 MCP 共用同一余额。

日期范围从 30 天前到 90 天后，一次请求最多跨 7 天。省略 start 表示 UTC 的今天，省略 end 表示与 start 同一天。超出该范围返回 400 invalid_query，跨度更长返回 400 range_too_large。

目前只涵盖 USA。其他国家返回 404 not_covered。只有我们代码列表中的公司才会出现，附带我们的 id 和名称，同一发行人的各类股份合为一行。

基础 URL： https://api.narwhalapi.com。 MCP 工具是 company_calendars, with one action ，适用于下方每个路由。

每个账户可获得的内容

查看 价格 了解每次调用的费用。请求按其所属 API 的价格计费，除非某个路由另有说明。

• 无论返回多少行，每个请求计一次调用。
• 在我们代码列表中没有有效标的的公司会被省略。
• 拆股比例是新股对旧股：4:1 表示 1 股换 4 股，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 股换 4 股；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
}

错误

错误使用通用的 problem 结构，并带有 request_id。查看 API 错误码与额度 了解该结构和额度相关的响应头。失败的请求不计费。