瀏覽全部文件

註冊申報行事曆 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。

基礎網址： https://api.narwhalapi.com。 下列每條路由都是各自獨立的 MCP 工具，參數相同。

股利、股票分割與財報請見 公司行事曆頁面。

公司 ID 即為 申報文件 API 公司搜尋所回傳的 ID。

每個帳戶都能取得的內容

費用所有帳戶
註冊申報行事曆已包含

查看 定價 說明每次呼叫的費用。除非路由另有說明，請求依其所屬 API 的價格計費。

  • 此路由位於日曆之下，但依 Companies 價格計費。每次成功回應計為一次呼叫，與資料列數無關，空白頁面也會計費。錯誤不計費。
  • 金額使用 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。

參數

參數位置必填類型含義
startquery否日期起始申報日（含），格式為 YYYY-MM-DD。省略表示 end 之前 30 天。
endquery否日期結束申報日（含）。省略表示今天（UTC）。start 到 end 最多涵蓋 12 個日曆月（超過回傳 400 range_too_large）。
countryquery否字串登記機關的三字母國家代碼。省略表示美國。路由未涵蓋的國家回傳 404 not_covered。
cikquery否字串僅限此 SEC Central Index Key 的申報文件（開頭的 0 可省略）。僅限美國：其他國家請使用 ticker。
tickerquery否字串僅限封面上載明此代號的申報文件（準備上市公司的擬用代號），或申報人在目錄中對應此股票代號的申報文件。
classquery否one of ipo, spac, shell, resale, other僅限此類別的申報文件：ipo、spac、shell、resale 或 other。
formquery否one of S-1, S-1/A, F-1, F-1/A, 424B4, 424B1, TODOKE, TODOKE/A僅限此表格的申報文件，例如 S-1 或 424B4。
cursorquery否字串上一頁的 next_cursor，其他參數須與上一頁相同。
limitquery否整數每頁資料列數。預設為 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 }

錯誤

錯誤使用共用的問題格式，並包含 request_id。查看 API 錯誤 處理：錯誤碼、額度與重試 了解格式與額度標頭。失敗的請求不計費。

代碼狀態含義
invalid_query400參數缺漏、未知、重複，或超出範圍。
range_too_large400區間超過此路由允許的長度。
invalid_cursor400此游標不是這個請求所回傳的，或來自不同的請求。
not_covered404尚未支援此市場、國家或公司。
insufficient_credits402您的額度餘額不足以支付此請求的費用。
company_data_unavailable503這個路由背後的申報文件目前無法讀取。請稍後再試。

此頁面對你有幫助嗎?