stocks_search_ipos

Search initial-registration lifecycles across the held SEC index.

Description

Search initial-registration lifecycles across the held SEC index.

Use this to find IPO candidates by lifecycle stage, first-filed date, or raw SEC SIC. Records cover S-1/S-1/A, F-1/F-1/A, 424B1-B5, EFFECT, 8-A12B, and RW metadata from the SEC EDGAR full/daily index. This is index metadata only: pricing terms and offer size are NOT included yet. Profiles are CIK-keyed, not ticker-keyed, until the new-listing join lands.

The shared envelope returns echoed filters and data.ipos, newest first by first-filed date and CIK. meta.source is sec-edgar-index (US government public-domain data), and pagination carries cursor state. Bounds: default 20, max 100, rejected rather than clamped. Pass pagination.next_cursor back as cursor and keep all filters constant. Errors carry bad_parameter for an invalid stage, date window, limit, or cursor.

Example: stocks_search_ipos(stage="priced", filed_from="2026-01-01").

Parameters

Input schema

Name	Type	Required	Default	Description
stage	string \| null	No	null	Optional lifecycle stage: 'in_registration' (initial S-1/F-1 on file, not yet effective), 'effective' (SEC notice of effectiveness), 'priced' (424B1-B5 prospectus filed), or 'withdrawn' (RW before pricing).
filed_from	string (date) \| null	No	null	Earliest first-filed date, inclusive (YYYY-MM-DD).
filed_to	string (date) \| null	No	null	Latest first-filed date, inclusive (YYYY-MM-DD).
sic	string \| null	No	null	Exact raw SEC SIC code string, for example '2834'.
limit	integer	No	20	IPO registrations to return, newest first (1-100).
cursor	string \| null	No	null	Opaque pagination cursor from a previous response's `pagination.next_cursor`; keep stage, filed_from, filed_to, and sic constant while paging.

Provenance

Sources

sec-edgar-indexU.S. Securities and Exchange Commission (EDGAR)

Dataset registry: stocks_ipo_registrations