所有 API

財經日曆 API

追蹤排定的經濟數據發布及其發布狀態。為 GDP、價格、勞動力、貿易和殖利率曲線建立發布行事曆，並避免將不確定的時程視為確切時間。

首次請求

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/calendar?countries=USA&start_date=2026-10-01&end_date=2026-10-31" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

回應範例示意回應 · 非實際請求結果

{
  "status": "ok",
  "snapshot": "calendar-snapshot-20260914",
  "as_of": "2026-09-14T08:00:00Z",
  "releases": [
    {
      "release_id": "00000000-0000-4000-8000-000000000201",
      "series_id": "usa-consumer-prices",
      "country": "USA",
      "name": "Consumer prices",
      "topic": "consumer_prices",
      "title": "Consumer Price Index",
      "period": "2026-09",
      "status": "scheduled",
      "at": "2026-10-14T12:30:00Z",
      "timezone": "America/New_York"
    }
  ],
  "next_cursor": null
}

行事曆訂閱

透過 Narwhal API，為團隊選定的國家與日期範圍建立可訂閱的 ICS 訂閱來源。可依目前提供的資料範圍，選擇包含國定假日、經濟數據發布日期或兩者。訂閱來源可用於 Google 日曆、Apple 行事曆、Outlook 等行事曆用戶端。

curl --request POST \
  --url "https://api.narwhalapi.com/v1/calendars/subscriptions" \
  --header "Authorization: Bearer $NARWHAL_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{"countries":["USA"],"start_date":"2026-09-01","end_date":"2026-12-31","include_releases":true,"include_holidays":true}'

回應範例示意回應 · 非實際請求結果

{
  "subscription_id": "example-subscription",
  "url": "https://api.narwhalapi.com/v1/calendars/subscriptions/EXAMPLE_TOKEN.ics",
  "expires_at": "2026-12-31T23:59:59Z",
  "refresh_note": "calendar clients control refresh latency"
}