浏览全部文档

注册日历 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 公司搜索返回的 id 相同。

每个账户可获得的内容

查看所有账户
注册日历已包含

查看 价格 了解每次调用的费用。请求按其所属 API 的价格计费，除非某个路由另有说明。

  • 该路由位于日历之下，但按公司价格计费。每次成功的响应计一次调用，无论返回多少行，空页同样计费。错误不计费。
  • 金额以 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 的申报文件（前导零可省略）。仅限美国：其他国家请用 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字符串总是申报文件的 id，用于 Filings API。
registrations[].cik字符串可选申报人的 SEC Central Index Key。仅限美国申报文件。
registrations[].company_id字符串可选申报人在我们目录中的公司 id，申报人在目录中时给出。
registrations[].name字符串可选申报人的名称。
registrations[].formone 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[].classone 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_asone of shares, units, ads可选发行的内容：shares、units 或 ads。
registrations[].offering_amount字符串可选封面价格表中的发行总额。
registrations[].underwriting_discount字符串可选封面价格表中的承销折扣总额。
registrations[].proceeds_before_expenses字符串可选封面价格表中扣除费用前的所得款项总额。
registrations[].price_per_share字符串可选每股、每单位或每 ADS 的发行价，按 offered_as 所示。
registrations[].underwriting_discount_per_share字符串可选每股、每单位或每 ADS 的承销折扣。
registrations[].proceeds_per_share字符串可选每股、每单位或每 ADS 的所得款项。
registrations[].underwriterslist of string可选封面上列为承销商的机构。
registrations[].law_firmslist 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 }

错误

错误使用通用的 problem 结构，并带有 request_id。查看 API 错误码与额度 了解该结构和额度相关的响应头。失败的请求不计费。

代码状态含义
invalid_query400参数缺失、未知、重复或超出范围。
range_too_large400时间窗口超过该路由允许的长度。
invalid_cursor400该游标不是本请求返回的，或来自另一个请求。
not_covered404尚未涵盖该市场、国家或公司。
insufficient_credits402您的额度余额低于该请求的费用。
company_data_unavailable503该接口背后的申报文件目前无法读取。请稍后重试。

此页面对你有帮助吗?