Skip to main content

financial_api/
models.rs

1use serde::Deserialize;
2
3use crate::{
4    AShareCode, Adjustment, AssetType, AuctionStage, CompactDate, CompanyId, Cursor, DailyInterval,
5    DragonTigerBoard, FinancialAbilityKind, FinancialIndicatorId, FinancialPeriod, FinancialReport,
6    FiscalPeriod, FundType, HolderRecordScope, ManagerId, NaturalDate, PortfolioAssetType,
7    PreciseDecimal, RankTrend, ReportType, Thscode, UnixMillis,
8};
9
10/// A timestamped endpoint payload whose business records are stored in `item`.
11#[derive(Debug, Clone, PartialEq, Deserialize)]
12pub struct TimestampedItems<T> {
13    pub timestamp: UnixMillis,
14    pub item: Vec<T>,
15}
16
17/// One normalized target-code record.
18#[derive(Debug, Clone, PartialEq, Eq, Deserialize)]
19pub struct TickerItem {
20    pub thscode: Thscode,
21    pub ticker: String,
22    pub name: String,
23    pub exchange: Option<crate::Exchange>,
24    pub asset_type: AssetType,
25    pub currency: String,
26}
27
28pub type TickerData = TimestampedItems<TickerItem>;
29
30/// A-share or index price snapshot payload.
31#[derive(Debug, Clone, PartialEq, Deserialize)]
32pub struct PriceSnapshotData {
33    pub timestamp: Option<UnixMillis>,
34    pub total: u64,
35    pub item: Vec<PriceSnapshotItem>,
36}
37
38/// One latest-price record.
39#[derive(Debug, Clone, PartialEq, Deserialize)]
40pub struct PriceSnapshotItem {
41    pub thscode: Thscode,
42    pub ticker: String,
43    pub last_price: f64,
44    pub price_change: f64,
45    pub price_change_ratio_pct: f64,
46    pub open_price: f64,
47    pub high_price: f64,
48    pub low_price: f64,
49    pub prev_price: f64,
50    pub volume: f64,
51    pub turnover: f64,
52}
53
54/// Historical daily price payload.
55#[derive(Debug, Clone, PartialEq, Deserialize)]
56pub struct HistoricalData {
57    pub timestamp: UnixMillis,
58    pub item: Vec<PriceBarItem>,
59}
60
61/// Index historical prices include a fixed `null` adjustment field.
62#[derive(Debug, Clone, PartialEq, Deserialize)]
63pub struct IndexHistoricalData {
64    pub timestamp: UnixMillis,
65    pub adjust: Option<Adjustment>,
66    pub item: Vec<PriceBarItem>,
67}
68
69/// One daily OHLCV bar.
70#[derive(Debug, Clone, PartialEq, Deserialize)]
71pub struct PriceBarItem {
72    pub date_ms: UnixMillis,
73    pub open_price: f64,
74    pub high_price: f64,
75    pub low_price: f64,
76    pub close_price: f64,
77    pub volume: f64,
78    pub turnover: f64,
79}
80
81/// Corporate-action events for one A-share target.
82#[derive(Debug, Clone, PartialEq, Deserialize)]
83pub struct AdjustmentFactorsData {
84    pub thscode: AShareCode,
85    pub ticker: String,
86    pub item: Vec<AdjustmentFactorItem>,
87}
88
89#[derive(Debug, Clone, PartialEq, Deserialize)]
90pub struct AdjustmentFactorItem {
91    pub ticker: String,
92    pub ex_date_ms: UnixMillis,
93    pub dividend_per_share: f64,
94    pub per_share_bonus: f64,
95}
96
97/// Fields shared by the three listed-company financial statements.
98#[derive(Debug, Clone, PartialEq, Deserialize)]
99pub struct FinancialStatementMeta {
100    pub thscode: AShareCode,
101    pub ticker: String,
102    pub period: FinancialPeriod,
103    pub fiscal_year: i32,
104    pub fiscal_period: FiscalPeriod,
105    pub report_date_ms: UnixMillis,
106    pub period_end_ms: UnixMillis,
107    pub currency: String,
108}
109
110#[derive(Debug, Clone, PartialEq, Deserialize)]
111pub struct IncomeStatementItem {
112    #[serde(flatten)]
113    pub meta: FinancialStatementMeta,
114    pub operating_income: Option<f64>,
115    pub operating_costs: Option<f64>,
116    pub operating_expenses: Option<f64>,
117    pub sales_fee: Option<f64>,
118    pub manage_fee: Option<f64>,
119    pub research_and_development_expenses: Option<f64>,
120    pub operating_profit: Option<f64>,
121    pub interest_expenses: Option<f64>,
122    pub profit_total: Option<f64>,
123    pub income_tax_expense: Option<f64>,
124    pub net_profit: Option<f64>,
125    pub parent_holder_net_profit: Option<f64>,
126    pub basic_eps: Option<f64>,
127}
128
129pub type IncomeStatementsData = TimestampedItems<IncomeStatementItem>;
130
131#[derive(Debug, Clone, PartialEq, Deserialize)]
132pub struct BalanceSheetItem {
133    #[serde(flatten)]
134    pub meta: FinancialStatementMeta,
135    pub assets_total: Option<f64>,
136    pub total_current_assets: Option<f64>,
137    pub non_current_nets_total: Option<f64>,
138    pub cash: Option<f64>,
139    pub accounts_receivable: Option<f64>,
140    pub total_debt: Option<f64>,
141    pub holder_equity_total: Option<f64>,
142}
143
144pub type BalanceSheetsData = TimestampedItems<BalanceSheetItem>;
145
146#[derive(Debug, Clone, PartialEq, Deserialize)]
147pub struct CashFlowStatementItem {
148    #[serde(flatten)]
149    pub meta: FinancialStatementMeta,
150    pub act_cash_flow_net: Option<f64>,
151    pub invest_cash_flow_net: Option<f64>,
152    pub financing_cash_flow_net: Option<f64>,
153    pub pay_fixed_assets_etc_cash: Option<f64>,
154    pub pay_dividends_profits_interest_cash: Option<f64>,
155    pub cash_equivalents_net_addition: Option<f64>,
156}
157
158pub type CashFlowStatementsData = TimestampedItems<CashFlowStatementItem>;
159
160#[derive(Debug, Clone, PartialEq, Eq, Deserialize)]
161pub struct FinancialIndicatorsData {
162    pub thscode: AShareCode,
163    pub report: FinancialReport,
164    pub abilities: Vec<FinancialAbility>,
165}
166
167#[derive(Debug, Clone, PartialEq, Eq, Deserialize)]
168pub struct FinancialAbility {
169    pub ability: FinancialAbilityKind,
170    pub indicators: Vec<FinancialIndicator>,
171}
172
173#[derive(Debug, Clone, PartialEq, Eq, Deserialize)]
174pub struct FinancialIndicator {
175    pub index_id: FinancialIndicatorId,
176    pub value: Option<String>,
177}
178
179pub type TradingDaysData = TimestampedItems<TradingDayItem>;
180
181#[derive(Debug, Clone, PartialEq, Eq, Deserialize)]
182pub struct TradingDayItem {
183    pub date_ms: UnixMillis,
184    pub date: CompactDate,
185}
186
187pub type IndexCatalogData = TimestampedItems<IndexCatalogItem>;
188
189#[derive(Debug, Clone, PartialEq, Eq, Deserialize)]
190pub struct IndexCatalogItem {
191    pub thscode: Thscode,
192    pub name: String,
193}
194
195pub type IndexConstituentsData = TimestampedItems<IndexConstituentItem>;
196
197#[derive(Debug, Clone, PartialEq, Eq, Deserialize)]
198pub struct IndexConstituentItem {
199    pub thscode: AShareCode,
200    pub ticker: String,
201    pub name: String,
202}
203
204#[derive(Debug, Clone, PartialEq, Deserialize)]
205pub struct AuctionSnapshotData {
206    pub timestamp: UnixMillis,
207    pub auction_phase: AuctionStage,
208    pub data_status: String,
209    pub total: u64,
210    pub item: Vec<AuctionSnapshotItem>,
211}
212
213#[derive(Debug, Clone, PartialEq, Deserialize)]
214pub struct AuctionSnapshotItem {
215    pub thscode: AShareCode,
216    pub ticker: String,
217    pub name: String,
218    pub auction_price: Option<f64>,
219    pub auction_pct: Option<f64>,
220    pub auction_volume: Option<f64>,
221    pub auction_amount: Option<f64>,
222    pub auction_unmatched: Option<f64>,
223    pub auction_turnover_pct: Option<f64>,
224    pub auction_yesterday_ratio_pct: Option<f64>,
225    pub auction_volume_ratio: Option<f64>,
226    pub pre_close_price: Option<f64>,
227    pub open_price: Option<f64>,
228    pub last_price: Option<f64>,
229    pub float_market_cap: Option<f64>,
230}
231
232#[derive(Debug, Clone, PartialEq, Deserialize)]
233pub struct AuctionBenchmarkData {
234    pub timestamp: UnixMillis,
235    pub date: NaturalDate,
236    pub date_ms: UnixMillis,
237    pub item: Vec<AuctionBenchmarkItem>,
238}
239
240#[derive(Debug, Clone, PartialEq, Deserialize)]
241pub struct AuctionBenchmarkItem {
242    pub thscode: AShareCode,
243    pub ticker: String,
244    pub name: String,
245    pub auction_pct: Option<f64>,
246    pub tags: Vec<String>,
247}
248
249#[derive(Debug, Clone, PartialEq, Deserialize)]
250pub struct ValuationsData {
251    pub timestamp: Option<UnixMillis>,
252    pub total: u64,
253    pub item: Vec<ValuationItem>,
254}
255
256#[derive(Debug, Clone, PartialEq, Deserialize)]
257pub struct ValuationItem {
258    pub thscode: AShareCode,
259    pub ticker: String,
260    pub name: Option<String>,
261    pub pe_ttm: Option<PreciseDecimal>,
262    pub pe_mrq: Option<PreciseDecimal>,
263    pub pb_mrq: Option<PreciseDecimal>,
264    pub ps_ttm: Option<PreciseDecimal>,
265    pub pcf_ttm: Option<PreciseDecimal>,
266}
267
268pub type AnomalyData = TimestampedItems<AnomalyItem>;
269
270#[derive(Debug, Clone, PartialEq, Eq, Deserialize)]
271pub struct AnomalyItem {
272    pub stock_name: String,
273    pub analysis_content: String,
274    pub keyword_list: Vec<String>,
275    pub thscode: AShareCode,
276    pub tag_name: String,
277}
278
279pub type HotStockData = TimestampedItems<HotStockItem>;
280
281#[derive(Debug, Clone, PartialEq, Eq, Deserialize)]
282pub struct HotStockItem {
283    pub thscode: AShareCode,
284    pub ticker: String,
285    pub name: String,
286    pub rank: u64,
287    pub heat: String,
288    pub rank_change: Option<i64>,
289    pub rank_trend: RankTrend,
290}
291
292#[derive(Debug, Clone, PartialEq, Eq, Deserialize)]
293pub struct HotStockHistoryData {
294    pub date: NaturalDate,
295    pub date_ms: UnixMillis,
296    pub item: Vec<HotStockHistoryItem>,
297}
298
299#[derive(Debug, Clone, PartialEq, Eq, Deserialize)]
300pub struct HotStockHistoryItem {
301    pub thscode: AShareCode,
302    pub ticker: String,
303    pub name: String,
304    pub rank: u64,
305}
306
307pub type HotStockTrendData = TimestampedItems<HotStockTrendItem>;
308
309#[derive(Debug, Clone, PartialEq, Eq, Deserialize)]
310pub struct HotStockTrendItem {
311    pub thscode: AShareCode,
312    pub ticker: String,
313    pub date: NaturalDate,
314    pub date_ms: UnixMillis,
315    pub rank: u64,
316}
317
318#[derive(Debug, Clone, PartialEq, Deserialize)]
319pub struct DragonTigerData {
320    pub timestamp: UnixMillis,
321    pub board_type: DragonTigerBoard,
322    pub trade_date: NaturalDate,
323    pub count: u64,
324    pub stock_count: u64,
325    pub stock_items: Vec<DragonTigerStockItem>,
326    pub hot_money_items: Vec<HotMoneyItem>,
327}
328
329#[derive(Debug, Clone, PartialEq, Deserialize)]
330pub struct ConceptItem {
331    pub name: String,
332}
333
334#[derive(Debug, Clone, PartialEq, Deserialize)]
335pub struct DragonTigerStockItem {
336    pub thscode: AShareCode,
337    pub ticker: String,
338    pub name: String,
339    #[serde(default)]
340    pub concept_list: Vec<ConceptItem>,
341    pub change: Option<f64>,
342    pub net_value: Option<f64>,
343    pub net_rate: Option<f64>,
344    pub hot_rank: Option<u64>,
345    pub buy_value: Option<f64>,
346    pub sell_value: Option<f64>,
347    pub limit_reason: Option<String>,
348    pub range_days: Option<u64>,
349    pub org_net_value: Option<f64>,
350    pub org_net_rate: Option<f64>,
351    pub org_buy_num: Option<u64>,
352    pub org_sell_num: Option<u64>,
353    pub amount: Option<f64>,
354    pub hot_money_net_value: Option<f64>,
355    pub hot_money_net_rate: Option<f64>,
356    pub hot_money_item_net_value: Option<f64>,
357    pub hot_money_item_net_rate: Option<f64>,
358}
359
360#[derive(Debug, Clone, PartialEq, Deserialize)]
361pub struct HotMoneyItem {
362    pub name: String,
363    pub buying: f64,
364    pub rows: Vec<DragonTigerStockItem>,
365}
366
367#[derive(Debug, Clone, PartialEq, Eq, Deserialize)]
368pub struct Pagination {
369    pub total: u64,
370    pub pages: u64,
371    pub size: u16,
372    pub page: u32,
373}
374
375#[derive(Debug, Clone, PartialEq, Deserialize)]
376pub struct PoolData<T> {
377    pub timestamp: UnixMillis,
378    pub pagination: Pagination,
379    pub item: Vec<T>,
380}
381
382#[derive(Debug, Clone, PartialEq, Deserialize)]
383pub struct LimitUpItem {
384    pub thscode: AShareCode,
385    pub ticker: String,
386    pub name: String,
387    pub is_st: bool,
388    pub is_new: bool,
389    pub last_price: f64,
390    pub price_change_ratio_pct: f64,
391    pub limit_up_time: String,
392    pub limit_up_reason: Option<String>,
393    pub continue_day_text: String,
394    pub continue_day_cnt: u64,
395    pub seal_money: f64,
396    pub max_seal_money: f64,
397}
398
399#[derive(Debug, Clone, PartialEq, Deserialize)]
400pub struct LimitDownItem {
401    pub thscode: AShareCode,
402    pub ticker: String,
403    pub name: String,
404    pub last_price: f64,
405    pub price_change_ratio_pct: f64,
406    pub first_limit_time: String,
407    pub last_limit_time: String,
408    pub turnover_ratio_pct: f64,
409}
410
411#[derive(Debug, Clone, PartialEq, Deserialize)]
412pub struct LimitBreakItem {
413    pub thscode: AShareCode,
414    pub ticker: String,
415    pub name: String,
416    pub last_price: f64,
417    pub price_change_ratio_pct: f64,
418    pub open_times: u64,
419    pub turnover_ratio_pct: f64,
420    pub turnover: f64,
421}
422
423pub type LimitUpData = PoolData<LimitUpItem>;
424pub type LimitDownData = PoolData<LimitDownItem>;
425pub type LimitBreakData = PoolData<LimitBreakItem>;
426
427#[derive(Debug, Clone, PartialEq, Eq, Deserialize)]
428pub struct LadderData {
429    pub timestamp: UnixMillis,
430    pub window: LadderWindow,
431    pub item: Vec<LadderDay>,
432}
433
434#[derive(Debug, Clone, PartialEq, Eq, Deserialize)]
435pub struct LadderWindow {
436    pub length: u64,
437    pub date_list: Vec<CompactDate>,
438    pub board_caps: LadderBoardCaps,
439}
440
441#[derive(Debug, Clone, PartialEq, Eq, Deserialize)]
442pub struct LadderBoardCaps {
443    pub two_board: u64,
444    pub three_board: u64,
445    pub four_board: u64,
446    pub five_board: u64,
447    pub six_board: u64,
448    pub seven_over: u64,
449}
450
451#[derive(Debug, Clone, PartialEq, Eq, Deserialize)]
452pub struct LadderDay {
453    pub date: CompactDate,
454    pub boards: LadderBoards,
455}
456
457#[derive(Debug, Clone, PartialEq, Eq, Deserialize)]
458pub struct LadderBoards {
459    pub two_board: Vec<LadderStock>,
460    pub three_board: Vec<LadderStock>,
461    pub four_board: Vec<LadderStock>,
462    pub five_board: Vec<LadderStock>,
463    pub six_board: Vec<LadderStock>,
464    pub seven_over: Vec<LadderStock>,
465}
466
467#[derive(Debug, Clone, PartialEq, Eq, Deserialize)]
468pub struct LadderStock {
469    pub thscode: AShareCode,
470    pub ticker: String,
471    pub name: String,
472    pub board_num: u64,
473    pub seal_nextday: Option<bool>,
474    pub sign_level: u64,
475}
476
477#[derive(Debug, Clone, PartialEq, Deserialize)]
478pub struct FundProfileItem {
479    pub thscode: Thscode,
480    pub ticker: String,
481    pub fund_name: Option<String>,
482    pub estab_date: Option<UnixMillis>,
483    pub company_id: Option<CompanyId>,
484    pub mgmt_name: Option<String>,
485    pub manager_name: Option<String>,
486    pub fund_scale: Option<f64>,
487    pub unit_nav: Option<f64>,
488    #[serde(default)]
489    pub manager_info: Vec<FundManagerRef>,
490    #[serde(default)]
491    pub trade_rule: Vec<FundTradeRule>,
492    #[serde(default)]
493    pub rate_info: Vec<FundRateInfo>,
494}
495
496#[derive(Debug, Clone, PartialEq, Deserialize)]
497pub struct FundManagerRef {
498    pub manager_id: ManagerId,
499    pub manager_name: String,
500    pub tenure_return_pct: Option<f64>,
501    pub tenure_days: Option<u64>,
502    pub start_date_ms: Option<UnixMillis>,
503    pub end_date_ms: Option<UnixMillis>,
504}
505
506#[derive(Debug, Clone, PartialEq, Deserialize)]
507pub struct FundTradeRule {
508    pub title: Option<String>,
509    pub display_time: Option<String>,
510    pub time_ms: Option<UnixMillis>,
511}
512
513#[derive(Debug, Clone, PartialEq, Deserialize)]
514pub struct FundRateInfo {
515    pub rate_type: Option<String>,
516    pub charge_mode: Option<String>,
517    pub condition: Option<String>,
518    pub standard_rate: Option<f64>,
519    pub discounted_rate: Option<f64>,
520}
521
522pub type FundProfileData = TimestampedItems<FundProfileItem>;
523
524#[derive(Debug, Clone, PartialEq, Deserialize)]
525pub struct FundHoldingsData {
526    pub timestamp: UnixMillis,
527    pub item: Vec<FundHoldingItem>,
528    pub total_stock_ratio_pct: Option<f64>,
529    pub total_bond_ratio_pct: Option<f64>,
530    pub total_fund_ratio_pct: Option<f64>,
531    pub turnover_rate_pct: Option<f64>,
532    pub stock_ratio_pct: Option<f64>,
533    pub main_industry: Option<String>,
534    pub concentration_ratio: Option<f64>,
535}
536
537#[derive(Debug, Clone, PartialEq, Deserialize)]
538pub struct FundHoldingItem {
539    pub thscode: Option<Thscode>,
540    pub ticker: Option<String>,
541    pub stock_name: Option<String>,
542    pub hold_ratio: Option<f64>,
543    pub asset_type: Option<PortfolioAssetType>,
544    pub position_capital: Option<f64>,
545    pub position_count: Option<f64>,
546    pub security_market_value_rate_pct: Option<f64>,
547    pub period_increase_rate_pct: Option<f64>,
548    pub investment_rank: Option<u64>,
549    pub start_date_ms: Option<UnixMillis>,
550    pub end_date_ms: Option<UnixMillis>,
551    pub publish_date_ms: Option<UnixMillis>,
552    pub modify_time_ms: Option<UnixMillis>,
553}
554
555pub type FundNavData = TimestampedItems<FundNavItem>;
556
557#[derive(Debug, Clone, PartialEq, Deserialize)]
558pub struct FundNavItem {
559    pub nav_date: UnixMillis,
560    pub unit_nav: Option<f64>,
561    pub adj_nav: Option<f64>,
562}
563
564pub type FundReturnsData = TimestampedItems<FundReturnsItem>;
565
566#[derive(Debug, Clone, PartialEq, Deserialize)]
567pub struct FundReturnsItem {
568    pub return_week: Option<f64>,
569    pub return_month: Option<f64>,
570    pub return_tmonth: Option<f64>,
571    pub return_hyear: Option<f64>,
572    pub return_year: Option<f64>,
573    pub return_twoyear: Option<f64>,
574    pub return_tyear: Option<f64>,
575    pub return_fyear: Option<f64>,
576    pub return_nowyear: Option<f64>,
577    pub return_now: Option<f64>,
578    pub peer_average_week: Option<f64>,
579    pub peer_average_month: Option<f64>,
580    pub peer_average_tmonth: Option<f64>,
581    pub peer_average_hyear: Option<f64>,
582    pub peer_average_year: Option<f64>,
583    pub peer_average_twoyear: Option<f64>,
584    pub peer_average_tyear: Option<f64>,
585    pub peer_average_fyear: Option<f64>,
586    pub rank_week: Option<u64>,
587    pub rank_month: Option<u64>,
588    pub rank_tmonth: Option<u64>,
589    pub rank_hyear: Option<u64>,
590    pub rank_year: Option<u64>,
591    pub rank_twoyear: Option<u64>,
592    pub rank_tyear: Option<u64>,
593    pub rank_fyear: Option<u64>,
594    pub rank_total_week: Option<u64>,
595    pub rank_total_month: Option<u64>,
596    pub rank_total_tmonth: Option<u64>,
597    pub rank_total_hyear: Option<u64>,
598    pub rank_total_year: Option<u64>,
599    pub rank_total_twoyear: Option<u64>,
600    pub rank_total_tyear: Option<u64>,
601    pub rank_total_fyear: Option<u64>,
602}
603
604pub type FundHoldersData = TimestampedItems<FundHolderItem>;
605
606#[derive(Debug, Clone, PartialEq, Deserialize)]
607pub struct FundHolderItem {
608    pub merge_scope: HolderRecordScope,
609    pub report_date_ms: UnixMillis,
610    pub ins_position: Option<f64>,
611    pub holder_amount: Option<u64>,
612    pub avg_holder_share: Option<f64>,
613    pub psnl_rate: Option<f64>,
614    pub mgmt_staff_hold_rate: Option<f64>,
615}
616
617#[derive(Debug, Clone, PartialEq, Deserialize)]
618pub struct FundTopHoldersData {
619    pub timestamp: UnixMillis,
620    pub limit: u8,
621    pub item: Vec<FundTopHolderItem>,
622}
623
624#[derive(Debug, Clone, PartialEq, Deserialize)]
625pub struct FundTopHolderItem {
626    pub holder_id: Option<String>,
627    pub holder_code: Option<String>,
628    pub holder_name: Option<String>,
629    pub holder_type: Option<String>,
630    pub rank: Option<u64>,
631    pub hold_share: Option<f64>,
632    pub hold_rate_pct: Option<f64>,
633    pub report_date_ms: Option<UnixMillis>,
634    pub publish_date_ms: Option<UnixMillis>,
635}
636
637#[derive(Debug, Clone, PartialEq, Deserialize)]
638pub struct FundDividendsData {
639    pub timestamp: UnixMillis,
640    pub dividend_count: Option<u64>,
641    pub dividend_total: Option<f64>,
642    pub item: Vec<FundDividendItem>,
643}
644
645#[derive(Debug, Clone, PartialEq, Deserialize)]
646pub struct FundDividendItem {
647    pub per_ten_cash_before_tax: Option<f64>,
648    pub per_ten_cash_after_tax: Option<f64>,
649    pub progress: Option<String>,
650    pub publish_date_ms: Option<UnixMillis>,
651    pub registration_date_ms: Option<UnixMillis>,
652    pub ex_dividend_date_ms: Option<UnixMillis>,
653    pub payment_date_ms: Option<UnixMillis>,
654    pub reinvestment_date_ms: Option<UnixMillis>,
655    pub profit_base_date_ms: Option<UnixMillis>,
656    pub in_dividend_date_ms: Option<UnixMillis>,
657}
658
659pub type FundDiagnosticsData = TimestampedItems<FundDiagnosticsItem>;
660
661#[derive(Debug, Clone, PartialEq, Deserialize)]
662pub struct FundDiagnosticsItem {
663    pub thscode: Thscode,
664    pub ticker: String,
665    pub fund_type: FundType,
666    pub peer_code: String,
667    pub dimensions: serde_json::Value,
668    pub peer_dimensions: serde_json::Value,
669    pub probabilities: serde_json::Value,
670    pub ranges: serde_json::Value,
671    pub resilience: serde_json::Value,
672    pub peer_resilience: serde_json::Value,
673}
674
675pub type FundFinancialIndicatorsData = TimestampedItems<FundFinancialIndicatorsItem>;
676
677#[derive(Debug, Clone, PartialEq, Deserialize)]
678pub struct FundFinancialIndicatorsItem {
679    pub start_date_ms: Option<UnixMillis>,
680    pub end_date_ms: Option<UnixMillis>,
681    pub publish_date_ms: Option<UnixMillis>,
682    pub distribution_profit: Option<f64>,
683    pub current_profit: Option<f64>,
684    pub current_income: Option<f64>,
685    pub distribution_share_profit: Option<f64>,
686    pub average_nav_profit_margin: Option<f64>,
687    pub average_share_current_profit: Option<f64>,
688    pub share_nav: Option<f64>,
689    pub sum_share_nav: Option<f64>,
690    pub asset_nav: Option<f64>,
691    pub sum_nav_rate: Option<f64>,
692    pub nav_rate: Option<f64>,
693}
694
695pub type FundIncomeStatementsData = TimestampedItems<FundIncomeStatementItem>;
696
697#[derive(Debug, Clone, PartialEq, Deserialize)]
698pub struct FundIncomeStatementItem {
699    pub start_date_ms: Option<UnixMillis>,
700    pub end_date_ms: Option<UnixMillis>,
701    pub publish_date_ms: Option<UnixMillis>,
702    pub income: Option<f64>,
703    pub investment_income: Option<f64>,
704    pub stock_investment_income: Option<f64>,
705    pub bond_investment_income: Option<f64>,
706    pub fund_investment_income: Option<f64>,
707    pub dividend_income: Option<f64>,
708    pub interest_income: Option<f64>,
709    pub fair_value_income: Option<f64>,
710    pub exchange_income: Option<f64>,
711    pub other_income: Option<f64>,
712    pub total_income: Option<f64>,
713    pub fee: Option<f64>,
714    pub manager_reward: Option<f64>,
715    pub custodian_fee: Option<f64>,
716    pub transaction_cost: Option<f64>,
717    pub tax_surcharge: Option<f64>,
718    pub total_fee: Option<f64>,
719    pub total_profit: Option<f64>,
720    pub net_profit: Option<f64>,
721}
722
723pub type FundBalanceSheetsData = TimestampedItems<FundBalanceSheetItem>;
724
725#[derive(Debug, Clone, PartialEq, Deserialize)]
726pub struct FundBalanceSheetItem {
727    pub start_date_ms: Option<UnixMillis>,
728    pub end_date_ms: Option<UnixMillis>,
729    pub publish_date_ms: Option<UnixMillis>,
730    pub total_assets: Option<f64>,
731    pub bank_deposit: Option<f64>,
732    pub fund_investment: Option<f64>,
733    pub stock_investment: Option<f64>,
734    pub bond_investment: Option<f64>,
735    pub transactional_financial_assets: Option<f64>,
736    pub other_assets: Option<f64>,
737    pub total_liability: Option<f64>,
738    pub other_liability: Option<f64>,
739    pub owner_total_equity: Option<f64>,
740    pub undistributed_profit: Option<f64>,
741    pub liability_and_owner_equity: Option<f64>,
742}
743
744pub type FundCompanyData = TimestampedItems<FundCompanyItem>;
745
746#[derive(Debug, Clone, PartialEq, Deserialize)]
747pub struct FundCompanyItem {
748    pub company_id: CompanyId,
749    pub company_name: String,
750    pub company_type: String,
751    pub established_date_ms: UnixMillis,
752    pub fund_count: u64,
753    pub scale: f64,
754}
755
756pub type FundIndustryAllocationData = TimestampedItems<FundIndustryAllocationItem>;
757
758#[derive(Debug, Clone, PartialEq, Deserialize)]
759pub struct FundIndustryAllocationItem {
760    pub report_period: Option<String>,
761    pub industry_name: Option<String>,
762    pub ratio_pct: Option<f64>,
763}
764
765pub type FundIndicatorHistoryData = TimestampedItems<FundIndicatorHistoryItem>;
766
767#[derive(Debug, Clone, PartialEq, Deserialize)]
768pub struct FundIndicatorHistoryItem {
769    pub date_ms: UnixMillis,
770    pub rsi_pct: Option<f64>,
771    pub donchian_channel: Option<f64>,
772    pub track_index_pe_ttm_five_year_percentile: Option<f64>,
773}
774
775pub type FundDrawdownsData = TimestampedItems<FundDrawdownsItem>;
776
777#[derive(Debug, Clone, PartialEq, Deserialize)]
778pub struct FundDrawdownsItem {
779    pub thscode: Thscode,
780    pub ticker: String,
781    pub week: Option<f64>,
782    pub month: Option<f64>,
783    pub tmonth: Option<f64>,
784    pub hyear: Option<f64>,
785    pub year: Option<f64>,
786    pub twoyear: Option<f64>,
787    pub tyear: Option<f64>,
788    pub fyear: Option<f64>,
789    pub nowyear: Option<f64>,
790    pub now: Option<f64>,
791}
792
793pub type FundManagerStyleData = TimestampedItems<FundManagerStyleItem>;
794
795#[derive(Debug, Clone, PartialEq, Deserialize)]
796pub struct FundManagerStyleItem {
797    pub representative_fund_thscode: Option<Thscode>,
798    pub representative_fund_ticker: Option<String>,
799    pub representative_fund_name: Option<String>,
800    pub investment_idea: Option<String>,
801    pub total_fund_scale: Option<f64>,
802    pub industry_preferences: Option<serde_json::Value>,
803}
804
805pub type FundManagerPerformanceData = TimestampedItems<FundManagerPerformanceItem>;
806
807#[derive(Debug, Clone, PartialEq, Deserialize)]
808pub struct FundManagerPerformanceItem {
809    pub date_ms: UnixMillis,
810    pub manager_return_pct: Option<f64>,
811    pub peer_return_pct: Option<f64>,
812    pub benchmark_return_pct: Option<f64>,
813}
814
815pub type FundManagerExperienceData = TimestampedItems<FundManagerExperienceItem>;
816
817#[derive(Debug, Clone, PartialEq, Deserialize)]
818pub struct FundManagerExperienceItem {
819    pub awards: serde_json::Value,
820    pub heavy_assets: serde_json::Value,
821    pub investment_history: serde_json::Value,
822}
823
824pub type FundManagerDetailData = TimestampedItems<FundManagerDetailItem>;
825
826#[derive(Debug, Clone, PartialEq, Deserialize)]
827pub struct FundManagerDetailItem {
828    pub manager_id: ManagerId,
829    pub manager_name: String,
830    pub sex: Option<String>,
831    pub degree: Option<String>,
832    pub company_id: Option<CompanyId>,
833    pub company_name: Option<String>,
834    pub resume: Option<String>,
835    pub photo_url: Option<String>,
836    pub annual_return_pct: Option<f64>,
837    pub maximum_return_pct: Option<f64>,
838    pub radar_comparison: Vec<FundManagerRadarComparison>,
839}
840
841/// One manager-versus-peer radar node aligned by category and horizon.
842#[derive(Debug, Clone, PartialEq, Deserialize)]
843pub struct FundManagerRadarComparison {
844    pub fund_category: String,
845    pub horizon: String,
846    pub manager_metrics: serde_json::Value,
847    pub manager_scores: serde_json::Value,
848    pub peer_average_scores: serde_json::Value,
849}
850
851#[derive(Debug, Clone, PartialEq, Deserialize)]
852pub struct FundMarketSnapshotData {
853    pub timestamp: Option<UnixMillis>,
854    pub item: Vec<FundMarketSnapshotItem>,
855}
856
857#[derive(Debug, Clone, PartialEq, Deserialize)]
858pub struct FundMarketSnapshotItem {
859    pub thscode: Thscode,
860    pub ticker: String,
861    pub last_price: f64,
862    pub open_price: f64,
863    pub high_price: f64,
864    pub low_price: f64,
865    pub prev_price: f64,
866    pub price_change_ratio_pct: f64,
867    pub price_change: f64,
868    pub price_amplitude_ratio_pct: Option<f64>,
869    pub volume: f64,
870    pub turnover: f64,
871    pub turnover_ratio_pct: Option<f64>,
872}
873
874#[derive(Debug, Clone, PartialEq, Deserialize)]
875pub struct FundMarketHistoricalData {
876    pub timestamp: UnixMillis,
877    pub thscode: Thscode,
878    pub interval: DailyInterval,
879    pub adjust: Option<Adjustment>,
880    pub item: Vec<PriceBarItem>,
881}
882
883#[derive(Debug, Clone, PartialEq, Deserialize)]
884pub struct FundNewsData {
885    pub timestamp: UnixMillis,
886    pub limit: u32,
887    pub offset: Option<Cursor>,
888    pub has_more: bool,
889    pub item: Vec<FundNewsItem>,
890}
891
892#[derive(Debug, Clone, PartialEq, Deserialize)]
893pub struct FundNewsItem {
894    pub id: String,
895    pub content_type: Option<String>,
896    pub title: String,
897    pub summary: Option<String>,
898    pub source: Option<String>,
899    pub url: Option<String>,
900    pub image_url: Option<String>,
901    pub author: Option<String>,
902    pub publish_time_ms: Option<UnixMillis>,
903    pub top: Option<bool>,
904}
905
906pub type FundOfferingsData = TimestampedItems<FundOfferingItem>;
907
908#[derive(Debug, Clone, PartialEq, Deserialize)]
909pub struct FundOfferingItem {
910    pub thscode: Option<Thscode>,
911    pub ticker: String,
912    pub subscription_start_ms: Option<UnixMillis>,
913    pub subscription_end_ms: Option<UnixMillis>,
914}
915
916pub type FundPortfolioHistoryData = TimestampedItems<FundPortfolioHistoryItem>;
917
918#[derive(Debug, Clone, PartialEq, Deserialize)]
919pub struct FundPortfolioHistoryItem {
920    pub thscode: Option<Thscode>,
921    pub ticker: Option<String>,
922    pub name: Option<String>,
923    pub asset_type: PortfolioAssetType,
924    pub hold_ratio: Option<f64>,
925    pub market_value: Option<f64>,
926    pub period_increase_pct: Option<f64>,
927    pub rank: Option<u64>,
928    pub report_type: ReportType,
929    pub end_date_ms: UnixMillis,
930}
931
932pub type FundReportDatesData = TimestampedItems<FundReportDateItem>;
933
934#[derive(Debug, Clone, PartialEq, Deserialize)]
935pub struct FundReportDateItem {
936    pub report_type: ReportType,
937    pub report_type_name: String,
938    pub start_date_ms: UnixMillis,
939    pub end_date_ms: UnixMillis,
940}
941
942pub type FundAssetAllocationData = TimestampedItems<FundAssetAllocationItem>;
943
944#[derive(Debug, Clone, PartialEq, Deserialize)]
945pub struct FundAssetAllocationItem {
946    pub report_date_ms: UnixMillis,
947    pub stock_ratio_pct: Option<f64>,
948    pub bond_ratio_pct: Option<f64>,
949    pub deposit_ratio_pct: Option<f64>,
950    pub other_ratio_pct: Option<f64>,
951}