adaq-data-stock-us 0.1.3

Rust reimplementation of yfinance for US equity market data from Yahoo Finance.
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

//! `quoteSummary` family: `info`, `fast_info`, holders, analysis, sustainability,
//! funds, and calendar endpoints.
//!
//! Mirrors yfinance's `scrapers/quote.py` + `holders.py` + `analysis.py` +
//! `funds.py`. The `v10/finance/quoteSummary` endpoint takes a `modules` list;
//! we request the relevant modules and parse typed structs. The full raw JSON
//! is retained on [`Info::raw`] so no upstream field is lost.
//!
//! This module is split into concept submodules:
//! - [`info`] — `Info` / `FastInfo` (+ `shares` / `shares_full`)
//! - [`holders`] — `Holders` / `HolderRow`
//! - [`summary`] — `Sustainability` / `AnalystPriceTargets`
//! - [`analysis`] — estimates / recommendation / upgrade-downgrade tables
//! - [`funds`] — `FundsData` (mutual-fund / ETF)
//! - [`calendar`] — `Calendar` / `SecFiling`
//!
//! All public types and the shared [`quote_summary`] fetcher are re-exported at
//! this crate-root module so existing callers (`client`, `blocking`, `lib`) keep
//! referencing `crate::quote::*` unchanged.

use crate::error::{Result, YfError};
use crate::http::YfSession;
use crate::json::yf_result_first;
use serde_json::Value;

mod analysis;
mod calendar;
mod funds;
mod holders;
mod info;
mod summary;

pub use analysis::{NamedTable, RecommendationTrend, UpgradesDowngrades};
pub use calendar::{Calendar, SecFiling};
pub use funds::{FundHolding, FundsData};
pub use holders::{HolderRow, Holders};
pub use info::{FastInfo, Info};
pub use summary::{AnalystPriceTargets, Sustainability};

/// Default `modules` list for the full [`Info`] blob (mirrors yfinance's
/// `Ticker.info` request).
pub const MODULES_INFO: &[&str] = &[
    "assetProfile",
    "incomeStatementHistory",
    "balanceSheetHistory",
    "cashflowStatementHistory",
    "incomeStatementHistoryQuarterly",
    "balanceSheetHistoryQuarterly",
    "cashflowStatementHistoryQuarterly",
    "defaultKeyStatistics",
    "financialData",
    "calendarEvents",
    "secFilings",
    "recommendationTrend",
    "upgradeDowngradeHistory",
    "institutionOwnership",
    "fundOwnership",
    "majorHoldersBreakdown",
    "insiderTransactions",
    "insiderHolders",
    "netSharePurchaseActivity",
    "earnings",
    "earningsHistory",
    "earningsTrend",
    "quoteType",
    "price",
    "summaryDetail",
    "esgScores",
    "fundProfile",
    "fundOverview",
    "topHoldings",
    "fundPerformance",
];

/// Fetch a raw `quoteSummary` result for the given modules.
pub async fn quote_summary(session: &YfSession, ticker: &str, modules: &[&str]) -> Result<Value> {
    let urls = YfSession::urls();
    let url = format!("{}/v10/finance/quoteSummary/{}", urls.query2, ticker);
    let params = vec![("modules", modules.join(","))];
    let value = session.get_json(&url, &params).await?;
    yf_result_first(&value, "quoteSummary")
        .map_err(|_| YfError::DataMissing(format!("quoteSummary.result for {ticker}")))
        .cloned()
}

/// Convert an epoch-seconds `Option<f64>` into a UTC datetime, tolerating
/// missing nodes. Shared by the submodules.
pub(crate) fn ts_to_date(sec: Option<f64>) -> Option<chrono::DateTime<chrono::Utc>> {
    sec.and_then(|s| chrono::DateTime::from_timestamp(s as i64, 0))
}