longbridge 4.2.0

Longbridge OpenAPI SDK for Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122

#![allow(missing_docs)]

use rust_decimal::Decimal;
use serde::{Deserialize, Serialize};

use crate::utils::counter::deserialize_counter_id_as_symbol;

/// Response for [`crate::CalendarContext::finance_calendar`]
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct CalendarEventsResponse {
    /// Start date of the query window
    pub date: String,
    /// Per-day event groups
    pub list: Vec<CalendarDateGroup>,
}

/// Events for one calendar date
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct CalendarDateGroup {
    /// Date string, e.g. `"2025-05-02"`
    pub date: String,
    /// Total event count for this date
    pub count: i32,
    /// Event details
    pub infos: Vec<CalendarEventInfo>,
}

/// One financial calendar event
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct CalendarEventInfo {
    /// Security symbol
    #[serde(
        rename = "counter_id",
        deserialize_with = "deserialize_counter_id_as_symbol"
    )]
    pub symbol: String,
    /// Market, e.g. `"HK"`
    pub market: String,
    /// Event content description
    pub content: String,
    /// Security name
    pub counter_name: String,
    /// Date type label, e.g. `"盘前"`
    #[serde(default)]
    pub date_type: String,
    /// Event date string, e.g. `"2025.05.02"`
    pub date: String,
    /// Chart UID (may be empty)
    #[serde(default)]
    pub chart_uid: String,
    /// Structured data key-value pairs
    pub data_kv: Vec<CalendarDataKv>,
    /// Event type code, e.g. `"financial"`
    #[serde(rename = "type")]
    pub event_type: String,
    /// Event datetime (unix timestamp string)
    pub datetime: String,
    /// Icon URL
    #[serde(default)]
    pub icon: String,
    /// Importance star rating (0–3)
    pub star: i32,
    /// Associated live stream (usually null)
    pub live: Option<serde_json::Value>,
    /// Internal event ID
    pub id: String,
    /// Financial market session time string
    #[serde(default)]
    pub financial_market_time: String,
    /// Currency
    #[serde(default)]
    pub currency: String,
    /// Extended data (structure varies by event type)
    pub ext: Option<serde_json::Value>,
    /// Activity type code
    #[serde(default)]
    pub activity_type: String,
}

/// One key-value data pair in a calendar event
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct CalendarDataKv {
    /// Key (may be empty)
    pub key: String,
    /// Formatted display value
    pub value: String,
    /// Value type code, e.g. `"estimate_eps"`
    #[serde(rename = "type")]
    pub value_type: String,
    /// Raw numeric value (may be empty or non-numeric)
    #[serde(default, with = "crate::serde_utils::decimal_opt_str_is_none")]
    pub value_raw: Option<Decimal>,
}

/// Calendar event category
#[derive(Debug, Copy, Clone, Eq, PartialEq, Serialize, Deserialize)]
pub enum CalendarCategory {
    /// Earnings reports
    #[serde(rename = "report")]
    Report,
    /// Dividend events
    #[serde(rename = "dividend")]
    Dividend,
    /// Stock splits
    #[serde(rename = "split")]
    Split,
    /// IPOs
    #[serde(rename = "ipo")]
    Ipo,
    /// Macro-economic data releases
    #[serde(rename = "macrodata")]
    MacroData,
    /// Market closure days
    #[serde(rename = "closed")]
    Closed,
    /// Shareholder / analyst meetings
    #[serde(rename = "meeting")]
    Meeting,
    /// Stock consolidations / mergers
    #[serde(rename = "merge")]
    Merge,
}