등록 캘린더 API 레퍼런스

제출일별 S-1, F-1, 424B 공시와 공모 조건

개요

등록 캘린더는 기업이 SEC에 제출한 증권신고서와 최종 투자설명서를 제출일별로 나열합니다. S-1과 F-1 신고서, 그 정정본, 공모 조건을 확정하는 424B4와 424B1 투자설명서가 대상입니다. 모든 요청에 Bearer 키가 필요하며, REST와 MCP는 하나의 크레딧 잔액을 함께 사용합니다.

각 행은 공시 한 건이며, 대부분은 기업이 처음 주식을 파는 공시가 아닙니다. class가 각 공시의 종류를 알려 줍니다: ipo, spac, shell, resale 또는 other입니다. S-1, 그 정정본, 최종 투자설명서는 하나의 file_number를 공유하므로, 공모 수는 file_number로 세세요.

end를 생략하면 UTC 기준 오늘, start를 생략하면 end의 30일 전입니다. 요청 하나는 최대 12개월(달력 기준)에 걸칠 수 있으며, 더 긴 구간은 400 range_too_large입니다. 이력은 2025년 11월부터 시작합니다.

기본값은 미국입니다. country=jpn 요청은 일본의 유가증권 신고서를 반환하며, 그중 일부만 다룹니다. 일본 공시의 약 79%는 읽을 수 있는 본문 파일이 있고 나머지는 없습니다. country=kor 요청은 무료 404 not_covered입니다.

기본 URL: https://api.narwhalapi.com. 아래 각 경로는 같은 매개변수를 가진 별도의 MCP 도구입니다.

배당, 분할, 실적은 다음 페이지에 있습니다: 기업 캘린더 페이지.

기업 ID는 공시 API 기업 검색이 반환하는 값입니다.

모든 계정에 제공되는 것

항목	모든 계정
등록 캘린더	포함

확인 요금 페이지에서 호출당 비용을 확인할 수 있습니다. 라우트에 별도 안내가 없으면 요청은 해당 API의 가격으로 청구됩니다.

이 경로는 캘린더 아래에 있지만 Companies 가격으로 청구됩니다. 성공한 응답은 행 수와 관계없이 호출 1회이며, 빈 페이지도 청구됩니다. 오류는 청구되지 않습니다.
금액은 currency로 표시하며 공시에 인쇄된 그대로입니다. 미국 공시는 currency를 생략하며, 이는 미국 달러를 뜻합니다.
다음 필드는 공시 본문에서 읽으며, 공시에 없으면 생략합니다: ticker, 공모 조건, underwriters, law_firms, management. 목록이 완전하다고 보장하지 않으며, 인수인 목록에 Joint Book-Runners 같은 표 제목이 이름으로 들어갈 수 있습니다.
management 필드는 ipo, spac, shell 공시에서만 읽습니다. financials 필드는 투자설명서 안의 재무 태그에서 가져옵니다. 아직 상장하지 않은 많은 기업이 재무제표에 태그를 달지 않으므로 생략되는 경우가 많습니다.
cik 필드는 미국 공시에만 제공합니다. 다른 국가는 ticker로 필터링하세요.

엔드포인트

모든 경로는 GET이며, 키를 다음 헤더에 담아 보내야 합니다: Authorization: Bearer 헤더입니다. 예시는 응답의 형태를 보여 줄 뿐이며 실시간 데이터가 아닙니다.

등록 공시 목록

GET /v1/calendars/registrations

증권신고서(S-1, F-1과 그 정정본)와 최종 투자설명서(424B4, 424B1)를 최대 12개월 범위에서 오래된 순으로 반환합니다. 각 행은 공시 한 건이며, 대부분은 IPO가 아닙니다. class가 각 공시의 종류를 알려 줍니다.

class 값 ipo는 기업의 첫 공모이며, 기업이나 기존 보유자 또는 둘 다 파는 경우를 포함합니다. spac은 블랭크 체크 회사이고, shell은 사업이 없는 신생 회사입니다. resale은 이미 상장된 회사의 주식을 기존 보유자가 파는 것입니다. other는 후속 공모이거나 구분할 수 없는 모든 경우입니다.

price_low와 price_high는 S-1 또는 F-1의 예상 범위입니다. 424B4 또는 424B1에서는 최종 가격이므로 둘이 같습니다.

MCP: 도구 calendars_list_registrations.

매개변수

매개변수	위치	필수	유형	의미
`start`	쿼리	아니요	날짜	첫 공시일(YYYY-MM-DD)이며 해당 일을 포함합니다. 생략하면 `end`의 30일 전입니다.
`end`	쿼리	아니요	날짜	마지막 공시일이며 해당 일을 포함합니다. 생략하면 오늘(UTC)입니다. `start`부터 `end`까지 최대 12개월(달력 기준)에 걸칠 수 있습니다(초과 시 400 range_too_large).
`country`	쿼리	아니요	문자열	등록처의 세 글자 국가 코드입니다. 생략하면 USA입니다. 이 경로가 지원하지 않는 국가는 404 not_covered입니다.
`cik`	쿼리	아니요	문자열	이 SEC Central Index Key의 공시만 반환합니다(앞의 0은 생략 가능). 미국 전용이며, 다른 국가는 `ticker`를 사용합니다.
`ticker`	쿼리	아니요	문자열	표지에 이 심볼이 적힌 공시(상장 예정 기업의 예정 심볼), 또는 제출자가 카탈로그에서 이 티커로 알려진 공시만 반환합니다.
`class`	쿼리	아니요	one of ipo, spac, shell, resale, other	이 종류의 공시만 반환합니다: ipo, spac, shell, resale 또는 other.
`form`	쿼리	아니요	one of S-1, S-1/A, F-1, F-1/A, 424B4, 424B1, TODOKE, TODOKE/A	이 양식의 공시만 반환합니다. 예: S-1 또는 424B4.
`cursor`	쿼리	아니요	문자열	이전 페이지의 `next_cursor`. 다른 매개변수는 동일하게 유지합니다.
`limit`	쿼리	아니요	정수	페이지당 행 수입니다. 기본값 100, 최대 500입니다.

응답 필드

필드	유형	전송	의미
`start`	날짜	항상	기본값을 적용한 뒤의 조회 구간 첫 공시일입니다.
`end`	날짜	항상	기본값을 적용한 뒤의 조회 구간 마지막 공시일입니다.
`registrations`	객체 목록	항상	조회 구간의 공시를 오래된 순으로 나열합니다.
`registrations[].filing_id`	문자열	항상	공시 API에서 쓰는 공시 ID입니다.
`registrations[].cik`	문자열	선택	제출자의 SEC Central Index Key입니다. 미국 공시에만 있습니다.
`registrations[].company_id`	문자열	선택	제출자가 카탈로그에 있으면 카탈로그의 기업 ID입니다.
`registrations[].name`	문자열	선택	제출자 이름입니다.
`registrations[].form`	one of S-1, S-1/A, F-1, F-1/A, 424B4, 424B1, TODOKE, TODOKE/A	항상	양식: `S-1`, `S-1/A`, `F-1`, `F-1/A`, `424B4`, `424B1`, 그리고 일본의 `TODOKE`, `TODOKE/A`입니다.
`registrations[].filed`	날짜	항상	공시가 제출된 날입니다.
`registrations[].class`	one of ipo, spac, shell, resale, other	항상	공시 종류: `ipo`, `spac`, `shell`, `resale` 또는 `other`입니다.
`registrations[].currency`	문자열	선택	금액 필드의 통화입니다. 생략하면 미국 달러입니다.
`registrations[].price_low`	문자열	선택	예상 주당 가격의 하단이며, 투자설명서에서는 최종 가격입니다.
`registrations[].price_high`	문자열	선택	예상 주당 가격의 상단이며, 투자설명서에서는 최종 가격입니다.
`registrations[].exchange`	문자열	선택	제출자가 표지에 적은 시장입니다.
`registrations[].file_number`	문자열	선택	공시에 인쇄된 등록 번호입니다. 예: `333-284180`. 공모 하나에 번호 하나입니다.
`registrations[].ticker`	문자열	선택	표지에 적힌 주식의 심볼입니다.
`registrations[].shares_offered`	문자열	선택	표지 머리글의 주식, 단위 또는 ADS 수이며, 초과배정 전 수치입니다.
`registrations[].offered_as`	one of shares, units, ads	선택	공모 대상: `shares`, `units` 또는 `ads`입니다.
`registrations[].offering_amount`	문자열	선택	표지 가격표의 총 공모 금액입니다.
`registrations[].underwriting_discount`	문자열	선택	표지 가격표의 총 인수 수수료입니다.
`registrations[].proceeds_before_expenses`	문자열	선택	표지 가격표의 비용 차감 전 총 수익금입니다.
`registrations[].price_per_share`	문자열	선택	`offered_as`가 가리키는 단위(주식, 단위 또는 ADS)당 공모 가격입니다.
`registrations[].underwriting_discount_per_share`	문자열	선택	주식, 단위 또는 ADS당 인수 수수료입니다.
`registrations[].proceeds_per_share`	문자열	선택	주식, 단위 또는 ADS당 수익금입니다.
`registrations[].underwriters`	list of string	선택	표지에 인수인으로 적힌 회사들입니다.
`registrations[].law_firms`	list of string	선택	Copies to 블록에서, 그리고 `ipo`, `spac`, `shell` 공시는 Legal Matters에서 가져온 법률 자문사입니다.
`registrations[].management`	객체 목록	선택	공시의 경영진 표에서 가져온 이사와 임원입니다.
`registrations[].management[].name`	문자열	항상	이사 또는 임원의 이름입니다.
`registrations[].management[].title`	문자열	항상	공시에 적힌 직함입니다.
`registrations[].management[].age`	정수	선택	공시에 적힌 나이입니다.
`registrations[].financials`	객체	선택	투자설명서의 재무 태그에서 읽은 기업의 가장 최근 연간 수치입니다. 재무제표에 태그가 없으면 생략합니다.
`registrations[].financials.fiscal_year_end`	날짜	항상	태그된 수치가 있는 가장 최근 전체 회계연도의 종료일입니다.
`registrations[].financials.currency`	문자열	선택	재무제표의 통화입니다.
`registrations[].financials.revenue`	문자열	선택	해당 연도의 매출이며 전체 단위로 표시합니다.
`registrations[].financials.net_income`	문자열	선택	해당 연도의 순이익이며 전체 단위로 표시합니다.
`registrations[].financials.total_assets`	문자열	선택	해당 날짜의 총자산이며 전체 단위로 표시합니다.
`registrations[].financials.total_liabilities`	문자열	선택	해당 날짜의 총부채이며 전체 단위로 표시합니다.
`registrations[].financials.total_equity`	문자열	선택	해당 날짜의 총자본이며 전체 단위로 표시합니다.
`registrations[].financials.cash`	문자열	선택	해당 날짜의 현금이며 전체 단위로 표시합니다.
`next_cursor`	문자열	항상	다음 페이지를 읽으려면 `cursor`로 전달합니다. 항상 제공하며 마지막 페이지에서는 null입니다.

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/calendars/registrations?ticker=ACCV&form=424B4&start=2026-10-01&end=2026-11-12"

{ "start": "2026-10-01", "end": "2026-11-12", "registrations": [ { "filing_id": "usa:0002141406:0001628280-26-064097", "cik": "0002141406", "company_id": "usa:0002141406", "name": "Accelevation Holdings Corp.", "form": "424B4", "filed": "2026-10-01", "class": "ipo", "price_low": "18.00", "price_high": "18.00", "exchange": "Nasdaq", "file_number": "333-298715", "ticker": "ACCV", "shares_offered": "30000000", "offered_as": "shares", "offering_amount": "540000000", "underwriting_discount": "28350000", "proceeds_before_expenses": "170550000", "price_per_share": "18.00", "underwriting_discount_per_share": "0.945", "proceeds_per_share": "17.055", "underwriters": [ "Morgan Stanley", "J.P. Morgan", "Goldman Sachs & Co. LLC", "Barclays" ], "law_firms": [ "Kirkland & Ellis LLP", "Simpson Thacher & Bartlett LLP" ], "management": [ { "name": "Michael Rubiera", "title": "Chief Executive Officer and Director", "age": 52 }, { "name": "Kenneth Krause", "title": "Chief Financial Officer", "age": 51 } ] } ], "next_cursor": null }

오류

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

코드	상태	의미
`invalid_query`	400	매개변수가 없거나, 알 수 없거나, 중복되었거나, 범위를 벗어났습니다.
`range_too_large`	400	기간이 이 경로에서 허용하는 길이를 넘었습니다.
`invalid_cursor`	400	이 요청이 반환한 커서가 아니거나, 다른 요청의 커서입니다.
`not_covered`	404	해당 시장, 국가 또는 기업은 아직 제공되지 않습니다.
`insufficient_credits`	402	크레딧 잔액이 요청 비용보다 적습니다.
`company_data_unavailable`	503	이 경로의 근거 공시를 지금은 읽을 수 없습니다. 잠시 후 다시 시도하세요.

이 페이지가 도움이 되었나요?