기업 일정 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의 가격으로 청구됩니다.

• 행 수와 관계없이 요청 한 번이 호출 1회입니다.
• 자체 심볼 목록에 활성 종목이 없는 기업은 제외됩니다.
• 분할 비율은 기존 주식 대비 새 주식의 수입니다. 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 및 이름과 함께 나타나며, 한 발행사의 유닛과 주식 종류는 한 행으로 합쳐집니다. 모든 계정에서 사용할 수 있고 요청 한 번이 호출 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), 요청 한 번의 기간은 최대 7일입니다(400 range_too_large). country는 현재 유일하게 제공되는 USA입니다(그 외는 404 not_covered). 자체 심볼 목록에 있는 기업만 자체 id 및 이름과 함께 나타나며, 한 발행사의 유닛과 주식 종류는 한 행으로 합쳐집니다. 모든 계정에서 사용할 수 있고 요청 한 번이 호출 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
}

오류

오류는 공통 문제 형식을 사용하며, 다음 필드를 포함합니다: request_id. 확인 API 오류 코드와 크레딧 형식과 크레딧 헤더에 대한 설명이 있습니다. 실패한 요청에는 요금이 부과되지 않습니다.