lighter-sdk 0.1.1

Rust SDK for interacting with the Lighter exchange over REST, WebSocket, and signer-backed transaction flows.
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
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215

use serde::{Deserialize, Serialize};

use super::de::{opt_f64_from_string_or_number, opt_i64_from_string_or_number};
use super::order::SimpleOrder;

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct OrderBook {
    #[serde(default)]
    pub symbol: Option<String>,
    #[serde(default, deserialize_with = "opt_i64_from_string_or_number")]
    pub market_id: Option<i64>,
    #[serde(default)]
    pub market_type: Option<String>,
    #[serde(default, deserialize_with = "opt_i64_from_string_or_number")]
    pub base_asset_id: Option<i64>,
    #[serde(default, deserialize_with = "opt_i64_from_string_or_number")]
    pub quote_asset_id: Option<i64>,
    #[serde(default)]
    pub status: Option<String>,
    #[serde(default, deserialize_with = "opt_f64_from_string_or_number")]
    pub taker_fee: Option<f64>,
    #[serde(default, deserialize_with = "opt_f64_from_string_or_number")]
    pub maker_fee: Option<f64>,
    #[serde(default, deserialize_with = "opt_f64_from_string_or_number")]
    pub liquidation_fee: Option<f64>,
    #[serde(default, deserialize_with = "opt_f64_from_string_or_number")]
    pub min_base_amount: Option<f64>,
    #[serde(default, deserialize_with = "opt_f64_from_string_or_number")]
    pub min_quote_amount: Option<f64>,
    #[serde(default, deserialize_with = "opt_f64_from_string_or_number")]
    pub order_quote_limit: Option<f64>,
    #[serde(default, deserialize_with = "opt_i64_from_string_or_number")]
    pub supported_size_decimals: Option<i64>,
    #[serde(default, deserialize_with = "opt_i64_from_string_or_number")]
    pub supported_price_decimals: Option<i64>,
    #[serde(default, deserialize_with = "opt_i64_from_string_or_number")]
    pub supported_quote_decimals: Option<i64>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct OrderBooks {
    pub code: i64,
    #[serde(default)]
    pub message: Option<String>,
    #[serde(default)]
    pub order_books: Vec<OrderBook>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct OrderBookDepth {
    pub code: i64,
    #[serde(default)]
    pub message: Option<String>,
    #[serde(default, deserialize_with = "opt_i64_from_string_or_number")]
    pub total_asks: Option<i64>,
    #[serde(default)]
    pub asks: Vec<SimpleOrder>,
    #[serde(default, deserialize_with = "opt_i64_from_string_or_number")]
    pub total_bids: Option<i64>,
    #[serde(default)]
    pub bids: Vec<SimpleOrder>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct PriceLevel {
    pub price: String,
    pub size: String,
}

impl PriceLevel {
    pub fn price_f64(&self) -> Option<f64> {
        self.price.parse::<f64>().ok()
    }

    pub fn size_f64(&self) -> Option<f64> {
        self.size.parse::<f64>().ok()
    }
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct OrderBookDetails {
    pub code: i64,
    #[serde(default)]
    pub message: Option<String>,
    #[serde(default)]
    pub order_book_details: Vec<PerpsOrderBookDetail>,
    #[serde(default)]
    pub spot_order_book_details: Vec<SpotOrderBookDetail>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct PerpsOrderBookDetail {
    #[serde(default)]
    pub symbol: Option<String>,
    #[serde(default, deserialize_with = "opt_i64_from_string_or_number")]
    pub market_id: Option<i64>,
    #[serde(default)]
    pub market_type: Option<String>,
    #[serde(default, deserialize_with = "opt_i64_from_string_or_number")]
    pub base_asset_id: Option<i64>,
    #[serde(default, deserialize_with = "opt_i64_from_string_or_number")]
    pub quote_asset_id: Option<i64>,
    #[serde(default)]
    pub status: Option<String>,
    #[serde(default, deserialize_with = "opt_f64_from_string_or_number")]
    pub taker_fee: Option<f64>,
    #[serde(default, deserialize_with = "opt_f64_from_string_or_number")]
    pub maker_fee: Option<f64>,
    #[serde(default, deserialize_with = "opt_f64_from_string_or_number")]
    pub liquidation_fee: Option<f64>,
    #[serde(default, deserialize_with = "opt_f64_from_string_or_number")]
    pub min_base_amount: Option<f64>,
    #[serde(default, deserialize_with = "opt_f64_from_string_or_number")]
    pub min_quote_amount: Option<f64>,
    #[serde(default, deserialize_with = "opt_f64_from_string_or_number")]
    pub order_quote_limit: Option<f64>,
    #[serde(default, deserialize_with = "opt_i64_from_string_or_number")]
    pub supported_size_decimals: Option<i64>,
    #[serde(default, deserialize_with = "opt_i64_from_string_or_number")]
    pub supported_price_decimals: Option<i64>,
    #[serde(default, deserialize_with = "opt_i64_from_string_or_number")]
    pub supported_quote_decimals: Option<i64>,
    #[serde(default, deserialize_with = "opt_i64_from_string_or_number")]
    pub size_decimals: Option<i64>,
    #[serde(default, deserialize_with = "opt_i64_from_string_or_number")]
    pub price_decimals: Option<i64>,
    #[serde(default, deserialize_with = "opt_i64_from_string_or_number")]
    pub quote_multiplier: Option<i64>,
    #[serde(default, deserialize_with = "opt_i64_from_string_or_number")]
    pub default_initial_margin_fraction: Option<i64>,
    #[serde(default, deserialize_with = "opt_i64_from_string_or_number")]
    pub min_initial_margin_fraction: Option<i64>,
    #[serde(default, deserialize_with = "opt_i64_from_string_or_number")]
    pub maintenance_margin_fraction: Option<i64>,
    #[serde(default, deserialize_with = "opt_i64_from_string_or_number")]
    pub closeout_margin_fraction: Option<i64>,
    #[serde(default, deserialize_with = "opt_f64_from_string_or_number")]
    pub last_trade_price: Option<f64>,
    #[serde(default, deserialize_with = "opt_i64_from_string_or_number")]
    pub daily_trades_count: Option<i64>,
    #[serde(default, deserialize_with = "opt_f64_from_string_or_number")]
    pub daily_base_token_volume: Option<f64>,
    #[serde(default, deserialize_with = "opt_f64_from_string_or_number")]
    pub daily_quote_token_volume: Option<f64>,
    #[serde(default, deserialize_with = "opt_f64_from_string_or_number")]
    pub daily_price_low: Option<f64>,
    #[serde(default, deserialize_with = "opt_f64_from_string_or_number")]
    pub daily_price_high: Option<f64>,
    #[serde(default, deserialize_with = "opt_f64_from_string_or_number")]
    pub daily_price_change: Option<f64>,
    #[serde(default, deserialize_with = "opt_f64_from_string_or_number")]
    pub open_interest: Option<f64>,
    #[serde(default)]
    pub daily_chart: Option<serde_json::Map<String, serde_json::Value>>,
    #[serde(default)]
    pub market_config: Option<serde_json::Map<String, serde_json::Value>>,
    #[serde(flatten)]
    pub extra: serde_json::Map<String, serde_json::Value>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct SpotOrderBookDetail {
    #[serde(default)]
    pub symbol: Option<String>,
    #[serde(default, deserialize_with = "opt_i64_from_string_or_number")]
    pub market_id: Option<i64>,
    #[serde(default)]
    pub market_type: Option<String>,
    #[serde(default, deserialize_with = "opt_i64_from_string_or_number")]
    pub base_asset_id: Option<i64>,
    #[serde(default, deserialize_with = "opt_i64_from_string_or_number")]
    pub quote_asset_id: Option<i64>,
    #[serde(default)]
    pub status: Option<String>,
    #[serde(default, deserialize_with = "opt_f64_from_string_or_number")]
    pub taker_fee: Option<f64>,
    #[serde(default, deserialize_with = "opt_f64_from_string_or_number")]
    pub maker_fee: Option<f64>,
    #[serde(default, deserialize_with = "opt_f64_from_string_or_number")]
    pub liquidation_fee: Option<f64>,
    #[serde(default, deserialize_with = "opt_f64_from_string_or_number")]
    pub min_base_amount: Option<f64>,
    #[serde(default, deserialize_with = "opt_f64_from_string_or_number")]
    pub min_quote_amount: Option<f64>,
    #[serde(default, deserialize_with = "opt_f64_from_string_or_number")]
    pub order_quote_limit: Option<f64>,
    #[serde(default, deserialize_with = "opt_i64_from_string_or_number")]
    pub supported_size_decimals: Option<i64>,
    #[serde(default, deserialize_with = "opt_i64_from_string_or_number")]
    pub supported_price_decimals: Option<i64>,
    #[serde(default, deserialize_with = "opt_i64_from_string_or_number")]
    pub supported_quote_decimals: Option<i64>,
    #[serde(default, deserialize_with = "opt_i64_from_string_or_number")]
    pub size_decimals: Option<i64>,
    #[serde(default, deserialize_with = "opt_i64_from_string_or_number")]
    pub price_decimals: Option<i64>,
    #[serde(default, deserialize_with = "opt_f64_from_string_or_number")]
    pub last_trade_price: Option<f64>,
    #[serde(default, deserialize_with = "opt_i64_from_string_or_number")]
    pub daily_trades_count: Option<i64>,
    #[serde(default, deserialize_with = "opt_f64_from_string_or_number")]
    pub daily_base_token_volume: Option<f64>,
    #[serde(default, deserialize_with = "opt_f64_from_string_or_number")]
    pub daily_quote_token_volume: Option<f64>,
    #[serde(default, deserialize_with = "opt_f64_from_string_or_number")]
    pub daily_price_low: Option<f64>,
    #[serde(default, deserialize_with = "opt_f64_from_string_or_number")]
    pub daily_price_high: Option<f64>,
    #[serde(default, deserialize_with = "opt_f64_from_string_or_number")]
    pub daily_price_change: Option<f64>,
    #[serde(default)]
    pub daily_chart: Option<serde_json::Map<String, serde_json::Value>>,
    #[serde(flatten)]
    pub extra: serde_json::Map<String, serde_json::Value>,
}