financial-api 0.1.2

Rust client for the official Tonghuashun Financial Data REST API
Documentation
use serde::Deserialize;

use crate::{
    AShareCode, AuctionStage, CompactDate, DragonTigerBoard, FinancialAbilityKind,
    FinancialIndicatorId, FinancialPeriod, FinancialReport, FiscalPeriod, NaturalDate,
    PreciseDecimal, RankTrend, UnixMillis,
};

use super::TimestampedItems;

#[cfg(test)]
mod tests;

/// Corporate-action events for one A-share target.
#[derive(Debug, Clone, PartialEq, Deserialize)]
pub struct AdjustmentFactorsData {
    pub thscode: AShareCode,
    pub ticker: String,
    pub item: Vec<AdjustmentFactorItem>,
}

#[derive(Debug, Clone, PartialEq, Deserialize)]
pub struct AdjustmentFactorItem {
    pub ticker: String,
    pub ex_date_ms: UnixMillis,
    pub dividend_per_share: f64,
    pub per_share_bonus: f64,
}

/// Fields shared by the three listed-company financial statements.
#[derive(Debug, Clone, PartialEq, Deserialize)]
pub struct FinancialStatementMeta {
    pub thscode: AShareCode,
    pub ticker: String,
    pub period: FinancialPeriod,
    pub fiscal_year: i32,
    pub fiscal_period: FiscalPeriod,
    pub report_date_ms: UnixMillis,
    pub period_end_ms: UnixMillis,
    pub currency: String,
}

#[derive(Debug, Clone, PartialEq, Deserialize)]
pub struct IncomeStatementItem {
    #[serde(flatten)]
    pub meta: FinancialStatementMeta,
    pub operating_income: Option<f64>,
    pub operating_costs: Option<f64>,
    pub operating_expenses: Option<f64>,
    pub sales_fee: Option<f64>,
    pub manage_fee: Option<f64>,
    pub research_and_development_expenses: Option<f64>,
    pub operating_profit: Option<f64>,
    pub interest_expenses: Option<f64>,
    pub profit_total: Option<f64>,
    pub income_tax_expense: Option<f64>,
    pub net_profit: Option<f64>,
    pub parent_holder_net_profit: Option<f64>,
    pub basic_eps: Option<f64>,
}

pub type IncomeStatementsData = TimestampedItems<IncomeStatementItem>;

#[derive(Debug, Clone, PartialEq, Deserialize)]
pub struct BalanceSheetItem {
    #[serde(flatten)]
    pub meta: FinancialStatementMeta,
    pub assets_total: Option<f64>,
    pub total_current_assets: Option<f64>,
    pub non_current_nets_total: Option<f64>,
    pub cash: Option<f64>,
    pub accounts_receivable: Option<f64>,
    pub total_debt: Option<f64>,
    pub holder_equity_total: Option<f64>,
}

pub type BalanceSheetsData = TimestampedItems<BalanceSheetItem>;

#[derive(Debug, Clone, PartialEq, Deserialize)]
pub struct CashFlowStatementItem {
    #[serde(flatten)]
    pub meta: FinancialStatementMeta,
    pub act_cash_flow_net: Option<f64>,
    pub invest_cash_flow_net: Option<f64>,
    pub financing_cash_flow_net: Option<f64>,
    pub pay_fixed_assets_etc_cash: Option<f64>,
    pub pay_dividends_profits_interest_cash: Option<f64>,
    pub cash_equivalents_net_addition: Option<f64>,
}

pub type CashFlowStatementsData = TimestampedItems<CashFlowStatementItem>;

#[derive(Debug, Clone, PartialEq, Eq, Deserialize)]
pub struct FinancialIndicatorsData {
    pub thscode: AShareCode,
    pub report: FinancialReport,
    pub abilities: Vec<FinancialAbility>,
}

#[derive(Debug, Clone, PartialEq, Eq, Deserialize)]
pub struct FinancialAbility {
    pub ability: FinancialAbilityKind,
    pub indicators: Vec<FinancialIndicator>,
}

#[derive(Debug, Clone, PartialEq, Eq, Deserialize)]
pub struct FinancialIndicator {
    pub index_id: FinancialIndicatorId,
    pub value: Option<String>,
}

pub type TradingDaysData = TimestampedItems<TradingDayItem>;

#[derive(Debug, Clone, PartialEq, Eq, Deserialize)]
pub struct TradingDayItem {
    pub date_ms: UnixMillis,
    pub date: CompactDate,
}

#[derive(Debug, Clone, PartialEq, Deserialize)]
pub struct AuctionSnapshotData {
    pub timestamp: UnixMillis,
    pub auction_phase: AuctionStage,
    pub data_status: String,
    pub total: u64,
    pub item: Vec<AuctionSnapshotItem>,
}

#[derive(Debug, Clone, PartialEq, Deserialize)]
pub struct AuctionSnapshotItem {
    pub thscode: AShareCode,
    pub ticker: String,
    pub name: String,
    pub auction_price: Option<f64>,
    pub auction_pct: Option<f64>,
    pub auction_volume: Option<f64>,
    pub auction_amount: Option<f64>,
    pub auction_unmatched: Option<f64>,
    pub auction_turnover_pct: Option<f64>,
    pub auction_yesterday_ratio_pct: Option<f64>,
    pub auction_volume_ratio: Option<f64>,
    pub pre_close_price: Option<f64>,
    pub open_price: Option<f64>,
    pub last_price: Option<f64>,
    pub float_market_cap: Option<f64>,
}

#[derive(Debug, Clone, PartialEq, Deserialize)]
pub struct AuctionBenchmarkData {
    pub timestamp: UnixMillis,
    pub date: NaturalDate,
    pub date_ms: UnixMillis,
    pub item: Vec<AuctionBenchmarkItem>,
}

#[derive(Debug, Clone, PartialEq, Deserialize)]
pub struct AuctionBenchmarkItem {
    pub thscode: AShareCode,
    pub ticker: String,
    pub name: String,
    pub auction_pct: Option<f64>,
    pub tags: Vec<String>,
}

#[derive(Debug, Clone, PartialEq, Deserialize)]
pub struct ValuationsData {
    pub timestamp: Option<UnixMillis>,
    pub total: u64,
    pub item: Vec<ValuationItem>,
}

#[derive(Debug, Clone, PartialEq, Deserialize)]
pub struct ValuationItem {
    pub thscode: AShareCode,
    pub ticker: String,
    pub name: Option<String>,
    pub pe_ttm: Option<PreciseDecimal>,
    pub pe_mrq: Option<PreciseDecimal>,
    pub pb_mrq: Option<PreciseDecimal>,
    pub ps_ttm: Option<PreciseDecimal>,
    pub pcf_ttm: Option<PreciseDecimal>,
}

pub type AnomalyData = TimestampedItems<AnomalyItem>;

#[derive(Debug, Clone, PartialEq, Eq, Deserialize)]
pub struct AnomalyItem {
    pub stock_name: String,
    pub analysis_content: String,
    pub keyword_list: Vec<String>,
    pub thscode: AShareCode,
    pub tag_name: String,
}

pub type HotStockData = TimestampedItems<HotStockItem>;

#[derive(Debug, Clone, PartialEq, Eq, Deserialize)]
pub struct HotStockItem {
    pub thscode: AShareCode,
    pub ticker: String,
    pub name: String,
    pub rank: u64,
    pub heat: String,
    pub rank_change: Option<i64>,
    pub rank_trend: RankTrend,
}

#[derive(Debug, Clone, PartialEq, Eq, Deserialize)]
pub struct HotStockHistoryData {
    pub date: NaturalDate,
    pub date_ms: UnixMillis,
    pub item: Vec<HotStockHistoryItem>,
}

#[derive(Debug, Clone, PartialEq, Eq, Deserialize)]
pub struct HotStockHistoryItem {
    pub thscode: AShareCode,
    pub ticker: String,
    pub name: String,
    pub rank: u64,
}

pub type HotStockTrendData = TimestampedItems<HotStockTrendItem>;

#[derive(Debug, Clone, PartialEq, Eq, Deserialize)]
pub struct HotStockTrendItem {
    pub thscode: AShareCode,
    pub ticker: String,
    pub date: NaturalDate,
    pub date_ms: UnixMillis,
    pub rank: u64,
}

#[derive(Debug, Clone, PartialEq, Deserialize)]
pub struct DragonTigerData {
    pub timestamp: UnixMillis,
    pub board_type: DragonTigerBoard,
    pub trade_date: NaturalDate,
    pub count: u64,
    pub stock_count: u64,
    pub stock_items: Vec<DragonTigerStockItem>,
    pub hot_money_items: Vec<HotMoneyItem>,
}

#[derive(Debug, Clone, PartialEq, Deserialize)]
pub struct ConceptItem {
    pub name: String,
}

#[derive(Debug, Clone, PartialEq, Deserialize)]
pub struct DragonTigerStockItem {
    pub thscode: AShareCode,
    pub ticker: String,
    pub name: String,
    #[serde(default)]
    pub concept_list: Vec<ConceptItem>,
    pub change: Option<f64>,
    pub net_value: Option<f64>,
    pub net_rate: Option<f64>,
    pub hot_rank: Option<u64>,
    pub buy_value: Option<f64>,
    pub sell_value: Option<f64>,
    pub limit_reason: Option<String>,
    pub range_days: Option<u64>,
    pub org_net_value: Option<f64>,
    pub org_net_rate: Option<f64>,
    pub org_buy_num: Option<u64>,
    pub org_sell_num: Option<u64>,
    pub amount: Option<f64>,
    pub hot_money_net_value: Option<f64>,
    pub hot_money_net_rate: Option<f64>,
    pub hot_money_item_net_value: Option<f64>,
    pub hot_money_item_net_rate: Option<f64>,
}

#[derive(Debug, Clone, PartialEq, Deserialize)]
pub struct HotMoneyItem {
    pub name: String,
    pub buying: f64,
    pub rows: Vec<DragonTigerStockItem>,
}

#[derive(Debug, Clone, PartialEq, Eq, Deserialize)]
pub struct Pagination {
    pub total: u64,
    pub pages: u64,
    pub size: u16,
    pub page: u32,
}

#[derive(Debug, Clone, PartialEq, Deserialize)]
pub struct PoolData<T> {
    pub timestamp: UnixMillis,
    pub pagination: Pagination,
    pub item: Vec<T>,
}

#[derive(Debug, Clone, PartialEq, Deserialize)]
pub struct LimitUpItem {
    pub thscode: AShareCode,
    pub ticker: String,
    pub name: String,
    pub is_st: bool,
    pub is_new: bool,
    pub last_price: f64,
    pub price_change_ratio_pct: f64,
    pub limit_up_time: String,
    pub limit_up_reason: Option<String>,
    pub continue_day_text: String,
    pub continue_day_cnt: u64,
    pub seal_money: f64,
    pub max_seal_money: f64,
}

#[derive(Debug, Clone, PartialEq, Deserialize)]
pub struct LimitDownItem {
    pub thscode: AShareCode,
    pub ticker: String,
    pub name: String,
    pub last_price: f64,
    pub price_change_ratio_pct: f64,
    pub first_limit_time: String,
    pub last_limit_time: String,
    pub turnover_ratio_pct: f64,
}

#[derive(Debug, Clone, PartialEq, Deserialize)]
pub struct LimitBreakItem {
    pub thscode: AShareCode,
    pub ticker: String,
    pub name: String,
    pub last_price: f64,
    pub price_change_ratio_pct: f64,
    pub open_times: u64,
    pub turnover_ratio_pct: f64,
    pub turnover: f64,
}

pub type LimitUpData = PoolData<LimitUpItem>;
pub type LimitDownData = PoolData<LimitDownItem>;
pub type LimitBreakData = PoolData<LimitBreakItem>;

#[derive(Debug, Clone, PartialEq, Eq, Deserialize)]
pub struct LadderData {
    pub timestamp: UnixMillis,
    pub window: LadderWindow,
    pub item: Vec<LadderDay>,
}

#[derive(Debug, Clone, PartialEq, Eq, Deserialize)]
pub struct LadderWindow {
    pub length: u64,
    pub date_list: Vec<CompactDate>,
    pub board_caps: LadderBoardCaps,
}

#[derive(Debug, Clone, PartialEq, Eq, Deserialize)]
pub struct LadderBoardCaps {
    pub two_board: u64,
    pub three_board: u64,
    pub four_board: u64,
    pub five_board: u64,
    pub six_board: u64,
    pub seven_over: u64,
}

#[derive(Debug, Clone, PartialEq, Eq, Deserialize)]
pub struct LadderDay {
    pub date: CompactDate,
    pub boards: LadderBoards,
}

#[derive(Debug, Clone, PartialEq, Eq, Deserialize)]
pub struct LadderBoards {
    pub two_board: Vec<LadderStock>,
    pub three_board: Vec<LadderStock>,
    pub four_board: Vec<LadderStock>,
    pub five_board: Vec<LadderStock>,
    pub six_board: Vec<LadderStock>,
    pub seven_over: Vec<LadderStock>,
}

#[derive(Debug, Clone, PartialEq, Eq, Deserialize)]
pub struct LadderStock {
    pub thscode: AShareCode,
    pub ticker: String,
    pub name: String,
    pub board_num: u64,
    pub seal_nextday: Option<bool>,
    pub sign_level: u64,
}