firstrade 0.1.0

A SDK for the Firstrade API
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
120
121
122

use http::StatusCode;
use serde::{Deserialize, Serialize};

// ==================== WatchList ====================
#[derive(Serialize, Deserialize)]
pub struct WatchListResponse {
    #[serde(rename = "statusCode")]
    #[serde(with = "http_serde::status_code")]
    pub status_code: StatusCode,
    pub error: String,
    pub message: String,
    pub items: Option<Vec<WatchList>>,
}

#[derive(Serialize, Deserialize)]
pub struct WatchList {
    pub list_id: i64,
    pub name: String,
    #[serde(rename = "isDefault")]
    pub is_default: bool,
}

// ==================== WatchListQuote ====================
#[derive(Serialize, Deserialize)]
pub struct WatchListQuoteResponse {
    #[serde(rename = "statusCode")]
    #[serde(with = "http_serde::status_code")]
    pub status_code: StatusCode,
    pub error: String,
    pub message: String,
    pub result: Option<WatchListQuote>,
}

#[derive(Serialize, Deserialize)]
pub struct WatchListQuote {
    pub list_id: i64,
    pub name: String,
    pub list_items: Vec<ItemQuote>,
}

#[derive(Serialize, Deserialize)]
pub struct ItemQuote {
    pub watchlist_id: i64,
    pub sec_type: i64,
    pub symbol: String,
    pub quantity: i64,
    pub last: f64,
    pub bid: f64,
    pub ask: f64,
    pub vol: i64,
    pub change: f64,
    pub change_percent: f64,
    pub day_gain_amount: i64,
    pub unit_cost: i64,
    pub cost: i64,
    pub gain_amount: i64,
    pub gain_percent: i64,
    pub bidsize: i64,
    pub asksize: i64,
    pub high: f64,
    pub low: f64,
    pub close_price: f64,
    pub open_price: f64,
    pub update_time: String,
}

// ==================== AddWatchListResponse ====================

#[derive(Serialize, Deserialize)]
pub struct AddWatchListResponse {
    #[serde(rename = "statusCode")]
    #[serde(with = "http_serde::status_code")]
    pub status_code: StatusCode,
    pub error: String,
    pub message: String,
    #[serde(rename = "refCode")]
    pub ref_code: Option<i32>,
    pub result: Option<WatchListResult>,
}

#[derive(Serialize, Deserialize)]
#[serde(untagged)]
pub enum WatchListResult {
    AddNewWatchList(AddNewWatchList),
    AddNewSymbol(AddNewSymbol),
}

#[derive(Serialize, Deserialize)]
pub struct AddNewWatchList {
    pub list_id: i64,
    pub result: String,
}

#[derive(Serialize, Deserialize)]
pub struct AddNewSymbol {
    pub watchlist_id: i64,
    pub result: String,
}

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

    #[test]
    fn test_delete_from_watchlist_deserialization() {
        let json_data = json!(
        {
            "statusCode": 200,
            "error": "",
            "message": "Normal",
            "result": {
                "watchlist_id": 55725063,
                "result": "success"
            }
        });
        let result: AddWatchListResponse = serde_json::from_value(json_data).unwrap();
        assert_eq!(result.status_code, StatusCode::OK);
        assert_eq!(result.error, "");
        assert_eq!(result.message, "Normal");
    }
}