配当カレンダーAPIリファレンス

概要

対象とするすべての上場企業について、指定した日数の期間の配当と株式分割を返します。すべてのリクエストに Bearer キーが必要で、REST と MCP は同じクレジット残高を使います。

日付は30日前から90日先までで、1回のリクエストで指定できる期間は最大7日です。start を省略すると UTC の今日、end を省略すると start と同じ日になります。この範囲外は 400 invalid_query、これより長い期間は 400 range_too_large です。

現在対応しているのは USA のみです。他の国は 404 not_covered を返します。自社のシンボル一覧にある企業だけが、自社の ID と名称とともに載ります。同じ発行体の複数の銘柄は1行にまとめます。

ベースURL： https://api.narwhalapi.com。 MCP ツールは次のとおりです： company_calendars, with one action 以下の各ルートに対応します。

すべてのアカウントで利用できるもの

参照： 料金表 で、呼び出し1回の料金を確認できます。ルートに別の記載がない限り、リクエストはそのAPIの料金で課金されます。

• 行数にかかわらず、リクエスト1回が1回の呼び出しです。
• 自社のシンボル一覧に有効な銘柄がない企業は含まれません。
• 分割比率は旧株に対する新株の数です。4:1 は1株につき4株、1:10 は株式併合です。

エンドポイント

すべてのルートは GET で、キーを次のヘッダーで渡す必要があります: Authorization: Bearer ヘッダー。例はレスポンスの形を示すもので、ライブデータではありません。

企業の配当カレンダー

GET /v1/calendars/dividends

期間内に権利落ちとなる配当を、権利落ち日、1株あたりの金額、通貨とともに返します。start と end は両端を含む日付です(YYYY-MM-DD)。省略すると、start は今日(UTC)、end は start と同じ日になります。日付は30日前から90日先までで(範囲外は 400 invalid_query)、1回のリクエストで指定できる期間は最大7日です(400 range_too_large)。country は現在対応している唯一の国である USA です(404 not_covered)。自社のシンボル一覧にある企業だけが、自社の ID と名称とともに載ります。同じ発行体のユニットや株式クラスは1行にまとめます。すべてのアカウントで利用でき、リクエスト1回が1回の呼び出しです。

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)、1回のリクエストで指定できる期間は最大7日です(400 range_too_large)。country は現在対応している唯一の国である USA です(404 not_covered)。自社のシンボル一覧にある企業だけが、自社の ID と名称とともに載ります。同じ発行体のユニットや株式クラスは1行にまとめます。すべてのアカウントで利用でき、リクエスト1回が1回の呼び出しです。

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エラーとクレジット で形式とクレジットヘッダーを確認できます。失敗したリクエストには課金されません。