公開済みの祝日
公式カレンダーは、全国・地域それぞれの適用範囲、実際に祝日として扱われる日付、提供元の定義を保持します。
方法論を読む →すべてのAPI
日付・カレンダーAPI
祝日、経済指標発表スケジュール、購読カレンダー。
最初のリクエスト
クイックスタート →curl --request GET \
--url "https://api.narwhalapi.com/v1/calendars/holidays/IDN/next?from_date=2026-08-01" \
--header "Authorization: Bearer $NARWHAL_API_KEY"レスポンスの例 説明用レスポンス · 実際のリクエストによるものではありません
{
"country": "IDN",
"coverage": [
{
"scope": "collective_leave",
"subdivision_codes": []
},
{
"scope": "national_public",
"subdivision_codes": []
}
],
"holiday": {
"date": "2026-08-17",
"name": "Independence Day",
"local_name": "Proklamasi Kemerdekaan",
"subdivision_codes": [],
"scope": "national_public"
}
}エンドポイント
祝日API
GET公開済みの指定年の祝日を一覧表示。/v1/calendars/holidays/{country}/{year}
GET指定日の祝日を検索。/v1/calendars/holidays/{country}/on/{date}
GET次の祝日を検索。/v1/calendars/holidays/{country}/next
経済指標カレンダーAPI
GET日付範囲の発表を一覧表示。/v1/economics/calendar
GET必要に応じてversion_idを指定し、発表データを取得。/v1/economics/calendar/{release_id}
祝日・経済指標発表のカレンダーフィード
POSTNarwhal APIキーを使って購読を作成すると、ICS フィードの URL が一度だけ返されます。/v1/calendars/subscriptions
GETICSフィードを取得。/v1/calendars/subscriptions/{token}.ics
DELETE購読を取り消す。/v1/calendars/subscriptions/{subscription_id}
ソースと方法論
発表スケジュール
経済指標の発表データは、対象期間、公表ステータス、タイムゾーン、予定日時の粒度を保持します。
カレンダー購読
取り消し可能なICSフィードで選択したイベントを配信します。更新時刻はカレンダークライアントが制御します。
カバレッジ
カバレッジを表示 →祝日の収録範囲は国・年ごとに公開されます。発表予定は、正確な時刻、日付、期間、または期限で示される場合があります。祝日であることだけでは、銀行や取引所が休業するとは限りません。
ARG
AUS
BRA
CAN
CHN
DEU
FRA
GBR
HKG
IDN
ITA
IND
MEX
NLD
NZL
KOR
RUS
SAU
SGP
TUR
EST
IRL
LVA
LTU
USA
ZAF
POL
CZE
SVN
HRV
PRT
AUT
BEL
COL
DNK
ESP
LUX
NOR
SVK
SWE
TWN
PHL関連ページを探す
よくある質問
これらの日付をカレンダーに追加できますか？
カレンダー購読を作成すると、祝日、経済指標発表、またはその両方の取り消し可能なICSフィードを受け取れます。
すべての経済指標発表に正確な時刻がありますか？
いいえ。スケジュールは発表元が示す日時の粒度を保持し、架空の時刻を割り当てません。