digdigdig3 0.3.3

Unified async Rust API for 47 exchange connectors (REST + WebSocket). The core layer — pure ExchangeHub + connectors. Higher-level builder, persistence, replay, OB tracker live in `digdigdig3-station`.
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

//! # JQuants API Endpoints
//!
//! Base URL: https://api.jquants.com/v1

use crate::core::types::Symbol;

/// Base URLs for JQuants API
pub struct JQuantsUrls {
    pub rest_base: &'static str,
}

impl Default for JQuantsUrls {
    fn default() -> Self {
        Self {
            rest_base: "https://api.jquants.com/v1",
        }
    }
}

/// API endpoint enum
#[derive(Debug, Clone)]
pub enum JQuantsEndpoint {
    // Authentication
    AuthUser,          // POST /token/auth_user (get refresh token)
    AuthRefresh,       // POST /token/auth_refresh (get ID token)

    // Stock Price Data
    DailyQuotes,       // GET /prices/daily_quotes (daily OHLC)

    // Listed Issues / Symbols
    ListedInfo,        // GET /listed/info (symbol master)

    // Indices
    Indices,           // GET /indices (TOPIX OHLC)
    IndicesTopix,      // GET /indices/topix (TOPIX specific)

    // Derivatives
    DerivativesFutures,  // GET /derivatives/futures (futures OHLC)
    DerivativesOptions,  // GET /derivatives/options (options OHLC)

    // Financial Data
    FinStatements,     // GET /fins/statements (financial statements)
    FinDividend,       // GET /fins/dividend (cash dividends)
    FinAnnouncement,   // GET /fins/announcement (earnings calendar)

    // Market Trading Data
    MarketsTradingByType,  // GET /markets/trading_by_type
    MarketsShortSelling,   // GET /markets/short_selling
    MarketsBreakdown,      // GET /markets/breakdown
    MarketsMargin,         // GET /markets/margin
    MarketsTradingCalendar, // GET /markets/trading_calendar

    // Options
    OptionIndexOption,  // GET /option/index_option
}

impl JQuantsEndpoint {
    /// Get endpoint path
    pub fn path(&self) -> &'static str {
        match self {
            // Authentication
            Self::AuthUser => "/token/auth_user",
            Self::AuthRefresh => "/token/auth_refresh",

            // Stock Price Data
            Self::DailyQuotes => "/prices/daily_quotes",

            // Listed Issues
            Self::ListedInfo => "/listed/info",

            // Indices
            Self::Indices => "/indices",
            Self::IndicesTopix => "/indices/topix",

            // Derivatives
            Self::DerivativesFutures => "/derivatives/futures",
            Self::DerivativesOptions => "/derivatives/options",

            // Financial Data
            Self::FinStatements => "/fins/statements",
            Self::FinDividend => "/fins/dividend",
            Self::FinAnnouncement => "/fins/announcement",

            // Market Trading Data
            Self::MarketsTradingByType => "/markets/trading_by_type",
            Self::MarketsShortSelling => "/markets/short_selling",
            Self::MarketsBreakdown => "/markets/breakdown",
            Self::MarketsMargin => "/markets/margin",
            Self::MarketsTradingCalendar => "/markets/trading_calendar",

            // Options
            Self::OptionIndexOption => "/option/index_option",
        }
    }
}


/// Parse symbol from API format back to domain Symbol
///
/// JQuants returns stock codes. We convert them to Symbol with JPY quote.
pub fn _parse_symbol(code: &str) -> Symbol {
    Symbol {
        base: code.to_string(),
        quote: "JPY".to_string(),
        raw: Some(code.to_string()),
    }
}

#[cfg(test)]
mod tests {
    use super::*;

#[test]
    fn test_parse_symbol() {
        let symbol = _parse_symbol("6758");
        assert_eq!(symbol.base, "6758");
        assert_eq!(symbol.quote, "JPY");
    }
}