Sign in
latestOpenAPI 3.0.32026-08-101461131.1 MB

ad6f143e43aa

us_stocks_reference

Contains comprehensive data about Initial Public Offerings (IPOs) and direct listings for US stocks, tracking both historical and pending offerings with detailed pricing, share, and timing information.

get/v1/reference/ipos

Query parameters

tickerstring

The ticker symbol of the IPO event.

ticker.any_ofstring

Filter equal to any of the values. Multiple values can be specified by using a comma separated list.

ticker.gtstring

Filter greater than the value.

ticker.gtestring

Filter greater than or equal to the value.

ticker.ltstring

Filter less than the value.

ticker.ltestring

Filter less than or equal to the value.

us_codestring

Nine-character alphanumeric code that uniquely identifies a financial security in North America.

us_code.any_ofstring

Filter equal to any of the values. Multiple values can be specified by using a comma separated list.

us_code.gtstring

Filter greater than the value.

us_code.gtestring

Filter greater than or equal to the value.

us_code.ltstring

Filter less than the value.

us_code.ltestring

Filter less than or equal to the value.

isinstring

International Securities Identification Number. This is a unique twelve-digit code that is assigned to every security issuance in the world.

isin.any_ofstring

Filter equal to any of the values. Multiple values can be specified by using a comma separated list.

isin.gtstring

Filter greater than the value.

isin.gtestring

Filter greater than or equal to the value.

isin.ltstring

Filter less than the value.

isin.ltestring

Filter less than or equal to the value.

listing_datestring

First trading date for the newly listed entity. Value must be an integer timestamp in nanoseconds, formatted 'yyyy-mm-dd', or ISO 8601/RFC 3339 (e.g. '2024-05-28T20:27:41Z').

listing_date.gtstring

Filter greater than the value. Value must be an integer timestamp in nanoseconds, formatted 'yyyy-mm-dd', or ISO 8601/RFC 3339 (e.g. '2024-05-28T20:27:41Z').

listing_date.gtestring

Filter greater than or equal to the value. Value must be an integer timestamp in nanoseconds, formatted 'yyyy-mm-dd', or ISO 8601/RFC 3339 (e.g. '2024-05-28T20:27:41Z').

listing_date.ltstring

Filter less than the value. Value must be an integer timestamp in nanoseconds, formatted 'yyyy-mm-dd', or ISO 8601/RFC 3339 (e.g. '2024-05-28T20:27:41Z').

listing_date.ltestring

Filter less than or equal to the value. Value must be an integer timestamp in nanoseconds, formatted 'yyyy-mm-dd', or ISO 8601/RFC 3339 (e.g. '2024-05-28T20:27:41Z').

ipo_status'direct_listing_process' | 'history' | 'new' | 'pending' | 'postponed' | 'rumor' | 'withdrawn'

The status of the IPO.

ipo_status.any_of'direct_listing_process' | 'history' | 'new' | 'pending' | 'postponed' | 'rumor' | 'withdrawn'

Filter equal to any of the values. Multiple values can be specified by using a comma separated list.

limitinteger

Limit the maximum number of results returned. Defaults to '10' if not specified. The maximum allowed limit is '1000'.

sortstring

A comma separated list of sort columns. For each column, append '.asc' or '.desc' to specify the sort direction. The sort column defaults to 'listing_date' if not specified. The sort order defaults to 'desc' if not specified.

Response

A list of results.

next_urlstring

If present, this value can be used to fetch the next page.

request_idstring required

A request id assigned by the server.

status'OK' required

The status of this request's response.