IPO Calendar
Get upcoming and recent IPO listings with expected offer price and listing date.
SDK Links
Python |
Rust |
Go |
Node.js |
Java |
C++ |
Parameters
SDK method parameters.
| Name | Type | Required | Description |
|---|---|---|---|
| start | string | YES | Start date, YYYY-MM-DD |
| end | string | YES | End date, YYYY-MM-DD |
| market | string | NO | Market filter: US, HK, SH, SZ. Omit for all. |
| count | integer | NO | Max events per page; server default when omitted |
| offset | integer | NO | Number of events to skip from the start of the window |
| next | CalendarPageDirection | NO | Page direction from the next_date cursor: Later or Earlier |
Request Example
from longbridge.openapi import CalendarContext, CalendarCategory, Config, OAuthBuilder
oauth = OAuthBuilder("your-client-id").build(lambda url: print("Visit:", url))
config = Config.from_oauth(oauth)
ctx = CalendarContext(config)
resp = ctx.finance_calendar(CalendarCategory.Ipo, "2024-01-01", "2024-03-31")
print(resp)import asyncio
from longbridge.openapi import AsyncCalendarContext, CalendarCategory, Config, OAuthBuilder
async def main() -> None:
oauth = await OAuthBuilder("your-client-id").build_async(lambda url: print("Visit:", url))
config = Config.from_oauth(oauth)
ctx = AsyncCalendarContext.create(config)
resp = await ctx.finance_calendar(CalendarCategory.Ipo, "2024-01-01", "2024-03-31")
print(resp)
if __name__ == "__main__":
asyncio.run(main())const { Config, CalendarContext, CalendarCategory, OAuth } = require('longbridge')
async function main() {
const oauth = await OAuth.build('your-client-id', (_, url) => {
console.log('Open this URL to authorize: ' + url)
})
const config = Config.fromOAuth(oauth)
const ctx = CalendarContext.new(config)
const resp = await ctx.financeCalendar(CalendarCategory.Ipo, '2024-01-01', '2024-03-31')
console.log(resp)
}
main().catch(console.error)import com.longbridge.*;
import com.longbridge.calendar.*;
class Main {
public static void main(String[] args) throws Exception {
try (OAuth oauth = new OAuthBuilder("your-client-id").build(url -> System.out.println("Open to authorize: " + url)).get();
Config config = Config.fromOAuth(oauth);
CalendarContext ctx = CalendarContext.create(config)) {
var resp = ctx.financeCalendar(CalendarCategory.Ipo, "2024-01-01", "2024-03-31", null).get();
System.out.println(resp);
}
}
}use std::sync::Arc;
use longbridge::{oauth::OAuthBuilder, calendar::{CalendarContext, CalendarCategory}, Config};
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
let oauth = OAuthBuilder::new("your-client-id").build(|url| println!("Open: {url}")).await?;
let config = Arc::new(Config::from_oauth(oauth));
let ctx = CalendarContext::new(config);
let resp = ctx.finance_calendar(CalendarCategory::Ipo, "2024-01-01", "2024-03-31", None, None, None, None).await?;
println!("{:?}", resp);
Ok(())
}#include <iostream>
#include <longbridge.hpp>
using namespace longbridge;
using namespace longbridge::calendar;
int main() {
OAuthBuilder("your-client-id").build(
[](const std::string& url) { std::cout << "Open: " << url << std::endl; },
[](auto res) {
if (!res) return;
Config config = Config::from_oauth(*res);
CalendarContext ctx = CalendarContext::create(config);
ctx.finance_calendar(CalendarCategory::Ipo, "2024-01-01", "2024-03-31", "", std::nullopt, std::nullopt, std::nullopt, [](auto resp) {
if (resp) std::cout << "OK" << std::endl;
});
});
std::cin.get();
}package main
import (
"context"
"fmt"
"log"
"github.com/longbridge/openapi-go/config"
"github.com/longbridge/openapi-go/oauth"
"github.com/longbridge/openapi-go/calendar"
)
func main() {
o := oauth.New("your-client-id").
OnOpenURL(func(url string) { fmt.Println("Open this URL to authorize:", url) })
if err := o.Build(context.Background()); err != nil {
log.Fatal(err)
}
conf, err := config.New(config.WithOAuthClient(o))
if err != nil {
log.Fatal(err)
}
c, err := calendar.NewFromCfg(conf)
if err != nil {
log.Fatal(err)
}
defer c.Close()
resp, err := c.FinanceCalendar(context.Background(), "Ipo", "2024-01-01", "2024-03-31", nil)
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", resp)
}Response
Response Example
{
"code": 0,
"message": "success",
"data": {
"date": "2024-01-01",
"list": [
{
"date": "2024-01-15",
"count": 1,
"infos": [
{
"id": "12345",
"symbol": "AAPL.US",
"market": "US",
"counter_name": "Apple Inc.",
"event_type": "",
"activity_type": "",
"date": "2024-01-15",
"datetime": "",
"content": "",
"star": 0,
"currency": "",
"icon": "",
"chart_uid": "",
"date_type": "",
"financial_market_time": "",
"data_kv": []
}
]
}
]
}
}
Response Status
| Status | Description | Schema |
|---|---|---|
| 200 | Success | CalendarEventsResponse |
| 400 | Bad request | None |
Schemas
CalendarEventsResponse
| Name | Type | Required | Description |
|---|---|---|---|
| date | string | false | Response date |
| list | object[] | true | List of calendar date groups, see CalendarDateGroup |
CalendarDateGroup
| Name | Type | Required | Description |
|---|---|---|---|
| date | string | true | Date |
| count | integer | false | Number of events on this date |
| infos | object[] | true | List of calendar events, see CalendarEventInfo |
CalendarEventInfo
| Name | Type | Required | Description |
|---|---|---|---|
| id | string | false | Event ID |
| symbol | string | false | Security symbol |
| market | string | false | Market |
| counter_name | string | false | Security name |
| event_type | string | false | Event type |
| activity_type | string | false | Activity type |
| date | string | false | Event date |
| datetime | string | false | Event datetime |
| date_type | string | false | Date type |
| content | string | false | Event content description |
| currency | string | false | Currency |
| star | integer | false | Importance rating (1-3) |
| icon | string | false | Icon URL |
| chart_uid | string | false | Chart identifier |
| financial_market_time | string | false | Financial market time |
| data_kv | object[] | false | Key-value data pairs |