三、财务信息
3.15 IPO
GET
/api/ipo_listing一个国家的 IPO 列表。
请求
请求头 Authorization:你的密钥(必填)。
| 参数 | 是否必填 | 说明 |
|---|---|---|
| country | 必填 | 国家,如 america;全部取值见「国家与市场参数」 |
说明
- 每条:id、country、name、symbol、exchange、openDate 申购开始、closeDate 申购结束、listingDate 上市日、issuePrice 发行价、issueSize、lotSize 等;没有的为 null。
- openDate、closeDate、listingDate 是 Unix 秒(字符串)。上市日期还没有公布时
listingDate是空字符串。 issuePrice是文本,可能是一个价格 "10.00",也可能是区间 "4.00 to 5.00"。- 接口不直接给出所处阶段,需要按这几个日期和当前时间自己判断。
返回
统一外壳 {status, message, data, total, page, market, symbol, code, interval},数据在 data 里。出错时 HTTP 状态码仍是 200,status 为 500,message 是原因。
错误
| HTTP | 返回 | 情况 |
|---|---|---|
| 200 | {"Cmd":"api","State":-1,"Msg":"没有订阅产品权限"} | 没带 country |
示例
GET
/ipo_listing?country=america请求头 Authorization: 你的密钥 · HTTP 200
{
"status": 0, // 0 成功,500 失败
"message": "SUCCESS", // 成功为 SUCCESS,失败时是原因
"data": [ // 数据
{
"id": "580760fb5def6e2ca8eaf601236d5b08", // 编号
"country": "america", // 国家
"name": "AfterNext Acquisition I Corp.", // 名称
"symbol": "AFNXU", // 产品代码
"openDate": null, // 申购开始,Unix 秒
"closeDate": null, // 申购结束,Unix 秒
"listingDate": "1791331200", // 上市日,Unix 秒;还没公布时是空字符串
"issuePrice": "10.00", // 发行价,文本,可能是一个价格或区间
"issueSize": null,
"lotSize": null,
"exchange": "NASDAQ", // 交易所
"weight": 1700000000480,
"createTime": "2026-09-30T23:31:47.000+00:00", // 创建时间
"remarks": null // 备注
},
{
"id": "1b33d16fc562464579b7199ca3114982", // 编号
"country": "america", // 国家
"name": "Antharas", // 名称
"symbol": "AAS", // 产品代码
"openDate": null, // 申购开始,Unix 秒
"closeDate": null, // 申购结束,Unix 秒
"listingDate": "", // 上市日,Unix 秒;还没公布时是空字符串
"issuePrice": "4.00 to 5.00", // 发行价,文本,可能是一个价格或区间
"issueSize": null,
"lotSize": null,
"exchange": "NASDAQ", // 交易所
"weight": 1700000000504,
"createTime": "2026-09-26T11:52:30.000+00:00", // 创建时间
"remarks": null // 备注
}
],
"total": 0, // 总条数,分页的接口才有值
"page": 0, // 当前页,分页的接口才有值
"market": null, // 市场代码
"symbol": null, // 产品代码
"code": null, // 产品代码
"interval": null // K 线周期,这类接口不用
}data 共 504 条,示例只列出其中 2 条:一条已公布上市日,一条还没公布。