dhan-rs 0.1.7

Unofficial Rust client library for the DhanHQ Broker API v2 — orders, market data, WebSocket feeds, and more
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

#![allow(missing_docs)]
//! Statement types — Ledger Report, Trade History.

use serde::Deserialize;

// ---------------------------------------------------------------------------
// Ledger Entry
// ---------------------------------------------------------------------------

/// A single ledger entry from the trading account.
///
/// Returned by `GET /v2/ledger?from-date={}&to-date={}`.
#[derive(Debug, Clone, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct LedgerEntry {
    pub dhan_client_id: Option<String>,
    pub narration: Option<String>,
    pub voucherdate: Option<String>,
    pub exchange: Option<String>,
    pub voucherdesc: Option<String>,
    pub vouchernumber: Option<String>,
    pub debit: Option<String>,
    pub credit: Option<String>,
    pub runbal: Option<String>,
}

/// Wire shapes observed or published for the ledger endpoint.
///
/// The current HTML documentation and linked OpenAPI describe one ledger
/// object. Older clients expected an array, so both shapes are accepted without
/// inventing an undocumented envelope.
#[derive(Debug, Clone, Deserialize)]
#[serde(untagged)]
pub enum LedgerResponse {
    /// Current documented object response.
    Entry(LedgerEntry),
    /// Historical array response retained for compatibility.
    Entries(Vec<LedgerEntry>),
}

impl LedgerResponse {
    /// Convert either supported wire shape into the crate's established list
    /// representation.
    pub fn into_entries(self) -> Vec<LedgerEntry> {
        match self {
            Self::Entry(entry) => vec![entry],
            Self::Entries(entries) => entries,
        }
    }
}

// ---------------------------------------------------------------------------
// Trade History Entry
// ---------------------------------------------------------------------------

/// A single historical trade entry.
///
/// Returned by `GET /v2/trades/{from-date}/{to-date}/{page}`.
#[derive(Debug, Clone, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct TradeHistoryEntry {
    pub dhan_client_id: Option<String>,
    pub order_id: Option<String>,
    pub exchange_order_id: Option<String>,
    pub exchange_trade_id: Option<String>,
    pub transaction_type: Option<String>,
    pub exchange_segment: Option<String>,
    pub product_type: Option<String>,
    pub order_type: Option<String>,
    pub trading_symbol: Option<String>,
    pub custom_symbol: Option<String>,
    pub security_id: Option<String>,
    #[serde(default)]
    pub traded_quantity: Option<i64>,
    #[serde(default)]
    pub traded_price: Option<f64>,
    pub isin: Option<String>,
    pub instrument: Option<String>,
    #[serde(default)]
    pub sebi_tax: Option<f64>,
    #[serde(default)]
    pub stt: Option<f64>,
    #[serde(default)]
    pub brokerage_charges: Option<f64>,
    #[serde(default)]
    pub service_tax: Option<f64>,
    #[serde(default)]
    pub exchange_transaction_charges: Option<f64>,
    #[serde(default)]
    pub stamp_duty: Option<f64>,
    pub create_time: Option<String>,
    pub update_time: Option<String>,
    pub exchange_time: Option<String>,
    pub drv_expiry_date: Option<String>,
    pub drv_option_type: Option<String>,
    #[serde(default)]
    pub drv_strike_price: Option<f64>,
}