美股首次公开募股（IPO） · REST 接口

首次公开募股（IPO）。获取 IPO 的完整信息，包括自 2008 年起的未来与历史事件，涵盖发行人名称、股票代码、证券类型、上市日期、发行股数、预期价格区间、最终发行价与发行规模。可按状态（待定、新股、传闻、历史）过滤。

GET /vX/reference/ipos

上游时效说明

每日更新

上游历史范围

数据可追溯至 2008 年 12 月 11 日

适用场景

IPO 研究、市场趋势分析、投资筛选、历史事件对比。

接入地址与凭据以实际开通时下发为准。下面是上游字段定义与响应示例，文档收录不等于本站已开放全部能力。

查询参数

参数	类型	必填	说明
`ticker`	string	No	指定区分大小写的标的代码。例如 TSLA 代表 Tesla Inc.。
`us_code`	string	No	指定 us_code。这是用于北美证券清算交收、唯一标识某只证券的 9 位字母数字代码。
`isin`	string	No	指定国际证券识别码（ISIN）。这是分配给全球每一只证券发行的 12 位唯一代码。
`listing_date`	string	No	指定上市日期，即新上市实体的首个交易日。
`ipo_status`	string	No	指定 IPO 状态。
`listing_date.gte`	string	No	按 listing_date 范围筛选。
`listing_date.gt`	string	No	按 listing_date 范围筛选。
`listing_date.lte`	string	No	按 listing_date 范围筛选。
`listing_date.lt`	string	No	按 listing_date 范围筛选。
`order`	string	No	按 sort 字段对结果排序。
`limit`	integer	No	限制返回结果数量，默认 10，最大 1000。
`sort`	string	No	用于排序的字段。

响应字段

字段	类型	说明
`next_url`	string	若存在，可用该值获取下一页数据。
`request_id`	string	服务器分配的请求 ID。
`results`	array[object]	包含所请求数据的数组。
`results[].announced_date`	string	IPO 事件的公告日期。
`results[].currency_code`	string	证券的计价货币。
`results[].final_issue_price`	number	IPO 正式上市前由公司及其承销商设定的价格。
`results[].highest_offer_price`	number	公司可能用于定价的 IPO 价格区间上限。
`results[].ipo_status`	enum: direct_listing_process, history, new, pending, postponed, rumor, withdrawn	IPO 事件的状态。IPO 事件最初为「rumor」（传闻）或「pending」（待定）；在上市日状态变为「new」（新上市），上市日之后变为「history」（已上市）。「direct_listing_process」状态对应一种发行方式：公司不走完整的 IPO 流程，而是直接在交易所挂牌其股票，不借助投资银行或其它中介机构——这种做法称为直接上市（direct listing）、直接配售（direct placement）或直接公开发行（DPO）。
`results[].isin`	string	国际证券识别码（ISIN）。这是分配给全球每一只证券发行的 12 位唯一代码。
`results[].issuer_name`	string	发行人名称。
`results[].last_updated`	string	IPO 事件最近一次修改的日期。
`results[].listing_date`	string	新上市实体的首个交易日。
`results[].lot_size`	number	单笔交易可买入或卖出的最小股数。
`results[].lowest_offer_price`	number	公司愿意向投资者发行股份的 IPO 价格区间下限。
`results[].max_shares_offered`	number	公司向投资者发行股份数量的上限。
`results[].min_shares_offered`	number	公司在 IPO 中愿意出售股份数量的下限。
`results[].primary_exchange`	string	证券上市的主要交易所的市场识别码（MIC）。市场识别码（MIC，ISO 10383）是用于标识证券交易所以及受监管与非受监管交易市场的唯一识别代码。
`results[].security_description`	string	证券的描述。
`results[].security_type`	string	股票的分类。例如 CS 表示普通股。
`results[].shares_outstanding`	number	公司已发行且由投资者持有的股份总数。
`results[].ticker`	string	IPO 事件的代码。
`results[].total_offer_size`	number	公司通过 IPO 募集的总额。
`results[].us_code`	string	用于标识北美证券的唯一 9 位字母数字代码，便于交易的清算与交收。
`status`	string	本次请求响应的状态。

响应示例

{
  "next_url": "https://api.massive.com/vX/reference/ipos?cursor=YWN0aXZlPXRydWUmZGF0ZT0yMDIxLTA0LTI1JmxpbWl0PTEmb3JkZXI9YXNjJnBhZ2VfbWFya2VyPUElN0M5YWRjMjY0ZTgyM2E1ZjBiOGUyNDc5YmZiOGE1YmYwNDVkYzU0YjgwMDcyMWE2YmI1ZjBjMjQwMjU4MjFmNGZiJnNvcnQ9dGlja2Vy",
  "request_id": "6a7e466379af0a71039d60cc78e72282",
  "results": [
    {
      "announced_date": "2024-06-01",
      "currency_code": "USD",
      "final_issue_price": 17,
      "highest_offer_price": 17,
      "ipo_status": "history",
      "isin": "US75383L1026",
      "issue_end_date": "2024-06-06",
      "issue_start_date": "2024-06-01",
      "issuer_name": "Rapport Therapeutics Inc.",
      "last_updated": "2024-06-27",
      "listing_date": "2024-06-07",
      "lot_size": 100,
      "lowest_offer_price": 17,
      "max_shares_offered": 8000000,
      "min_shares_offered": 1000000,
      "primary_exchange": "XNAS",
      "security_description": "Ordinary Shares",
      "security_type": "CS",
      "shares_outstanding": 35376457,
      "ticker": "RAPP",
      "total_offer_size": 136000000,
      "us_code": "75383L102"
    }
  ],
  "status": "OK"
}

原文：Massive 文档 ↗

美股 首次公开募股（IPO） · REST 接口

适用场景

查询参数

响应字段

响应示例

美股首次公开募股（IPO） · REST 接口