拆股日曆
獲取即將到來和歷史拆股及合股事件。
SDK Links
Python |
Rust |
Go |
Node.js |
Java |
C++ |
Parameters
SDK 方法參數。
| Name | Type | Required | Description |
|---|---|---|---|
| start | string | YES | 開始日期,格式 YYYY-MM-DD |
| end | string | YES | 結束日期,格式 YYYY-MM-DD |
| market | string | NO | 市場篩選:US、HK、SH、SZ,不填則返回所有市場 |
| count | integer | NO | 每頁最大事件數,省略時使用伺服器預設值 |
| offset | integer | NO | 從視窗起始跳過的事件數 |
| next | CalendarPageDirection | NO | 從 next_date 游標翻頁的方向:Later 或 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.Split, "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.Split, "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.Split, '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.Split, "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::Split, "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::Split, "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(), "Split", "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 | 成功 | CalendarEventsResponse |
| 400 | 請求錯誤 | None |
Schemas
CalendarEventsResponse
| Name | Type | Required | Description |
|---|---|---|---|
| date | string | 否 | 響應日期 |
| list | object[] | 是 | 日曆日期分組列表,見 CalendarDateGroup |
CalendarDateGroup
| Name | Type | Required | Description |
|---|---|---|---|
| date | string | 是 | 日期 |
| count | integer | 否 | 該日期的事件數量 |
| infos | object[] | 是 | 日曆事件列表,見 CalendarEventInfo |
CalendarEventInfo
| Name | Type | Required | Description |
|---|---|---|---|
| id | string | 否 | 事件 ID |
| symbol | string | 否 | 證券代碼 |
| market | string | 否 | 市場 |
| counter_name | string | 否 | 證券名稱 |
| event_type | string | 否 | 事件類型 |
| activity_type | string | 否 | 活動類型 |
| date | string | 否 | 事件日期 |
| datetime | string | 否 | 事件時間 |
| date_type | string | 否 | 日期類型 |
| content | string | 否 | 事件內容描述 |
| currency | string | 否 | 貨幣 |
| star | integer | 否 | 重要性(1-3 星) |
| icon | string | 否 | 圖標鏈接 |
| chart_uid | string | 否 | 圖表標識符 |
| financial_market_time | string | 否 | 金融市場時間 |
| data_kv | object[] | 否 | 鍵值數據對 |