모든 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 Calendar, Apple Calendar, 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"
}

엔드포인트

GET지정한 날짜 범위의 경제 지표 발표 목록을 조회합니다./v1/economics/calendar
API 레퍼런스 →
GET경제 지표 발표 정보를 조회합니다. 필요하면 version_id를 지정할 수 있습니다./v1/economics/calendar/{release_id}
API 레퍼런스 →

데이터 작동 방식

발표 일정에 맞춘 계획

국가와 날짜 범위로 캘린더를 필터링한 다음, 반환된 발표 ID로 해당 발표를 추적하세요.

일정 이해하기

정확한 시간, 날짜, 예상 범위, 마감일, 알 수 없는 일정을 구별합니다.

발표 추적

발표 정보와 해당 버전, 기준 기간, 상태 및 공표 타임스탬프를 조회합니다.

데이터 범위

데이터 범위 보기 →

발표가 예정되어 있어도 정확히 그 시각에 공표된다는 보장은 없습니다. 일정의 상세 수준과 시간대를 유지하고, 취소된 발표를 명시적으로 처리하세요. 공표 타임스탬프와 관측 타임스탬프는 서로 다른 이벤트를 나타냅니다.

관련 페이지 둘러보기

공휴일 API

REST 또는 MCP를 통해 국가와 연도별 공휴일을 가져옵니다. 날짜를 확인하거나 국가 및 지역 범위에서 다음 공휴일을 찾을 수 있습니다.

API 탐색 →

자주 묻는 질문

모든 발표에 정확한 시각이 정해져 있나요?

아니요. 발표 기관은 날짜, 기간 범위 또는 기한만 명시할 수 있습니다. 일정 객체는 이러한 상세 수준을 그대로 유지합니다.

이전 버전을 조회할 수 있나요?

변경할 수 없는 버전을 선택하려면 발표 상세 정보 요청에 version_id 매개변수를 사용하세요.

첫 요청 보내기

무료 API 키 받기 →