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
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262

#![feature(try_trait)]

//!
//! # General
//!
//! An rust API-Wrapper for the CryptoCompare API.
//!
//! Link to www.cryptocompare.com/api/ [API](https://www.cryptocompare.com/api/).
//!

extern crate reqwest;
extern crate serde_json;
extern crate time;

use serde_json::Value;
use std::io::Read;

static BASE_URL: &str = "https://min-api.cryptocompare.com/data/";

///
/// Informations for the request.
///
pub struct Options<'a> {
    /// Exchange the request should go to. List is at [API](https://www.cryptocompare.com/api/)
    pub exchanges: &'a str,
    /// If the value should be tried to convert to BTC or not.
    pub try_conversion: bool
}

///
/// An object with trading info.
///
#[derive(Debug)]
pub struct Dataset {
    /// Market price when timeslot closed.
    pub close: f64,
    /// Highest market price in timeslot.
    pub high: f64,
    /// LOwest market price in timeslot.
    pub low: f64,
    /// Market price when time slot opened.
    pub open: f64,
    /// Time in seconds after 1.1.1970.
    pub time: i64,
    /// Start volume.
    pub volumefrom: f64,
    /// End volume.
    pub volumeto: f64
}

///
/// Get general info for all the coins available via CryptoCompare.
///
/// # Example
/// ```
/// let coin_list = cryptocompare::get_coin_list()
/// ```
///
pub fn get_coin_list() -> Result<serde_json::Value, Box<::std::error::Error>> {
    let url = format!("{}all/coinlist", BASE_URL);

    let mut result = String::new();
    reqwest::get(&url)?.read_to_string(&mut result)?;
    let value: Value = serde_json::from_str(&mut result)?;

    Ok(value)
}

///
/// Get the latest price for a list of one or more currencies.
///
/// # Example
/// ```
///     let option: Options = Options {exchanges: "Bitfinex", try_conversion: false};
///     let price = cryptocompare::get_price("BTC", "USD", &option);
/// ```
///
pub fn get_price(fsym: &str, tsyms: &str, options: &Options) -> Result<serde_json::Value, Box<::std::error::Error>> {
    let mut url = format!("{}price?fsym={}&tsyms={}", BASE_URL, fsym, tsyms);
    if options.exchanges != "" { url = format!("{}&e={}", url, options.exchanges); }
    if !options.try_conversion { url = format!("{}&tryConversion={}", url, options.try_conversion); }

    let mut result = String::new();
    reqwest::get(&url)?.read_to_string(&mut result)?;
    let value: Value = serde_json::from_str(&mut result)?;

    Ok(value)
}

///
/// Get a matrix of currency prices.
///
/// # Example
/// ```
///     let option: Options = Options {exchanges: "Bitfinex", try_conversion: false};
///     let price_multi = cryptocompare::get_price_multi("IOT", "USD,BTC,ETH", &option);
/// ```
///
pub fn get_price_multi(fsyms: &str, tsyms: &str, options: &Options) -> Result<serde_json::Value, Box<::std::error::Error>> {
    let mut url = format!("{}pricemulti?fsyms={}&tsyms={}", BASE_URL, fsyms, tsyms);
    if options.exchanges != "" { url = format!("{}&e={}", url, options.exchanges); }
    if !options.try_conversion { url = format!("{}&tryConversion={}", url, options.try_conversion); }

    let mut result = String::new();
    reqwest::get(&url)?.read_to_string(&mut result)?;
    let value: Value = serde_json::from_str(&mut result)?;

    Ok(value)
}

///
/// Get all the current trading info of any list of cryptocurrencies in any other currency that you need.
///
/// If the crypto does not trade directly into the toSymbol requested, BTC will be used for conversion
///
/// # Example
/// ```
///     let option: Options = Options {exchanges: "Bitfinex", try_conversion: false};
///     let price_multi_full = cryptocompare::get_price_multi_full("IOT", "USD,BTC,ETH", &option);
/// ```
///
pub fn get_price_multi_full(fsyms: &str, tsyms: &str, options: &Options) -> Result<serde_json::Value, Box<::std::error::Error>> {
    let mut url = format!("{}pricemultifull?fsyms={}&tsyms={}", BASE_URL, fsyms, tsyms);
    if options.exchanges != "" { url = format!("{}&e={}", url, options.exchanges); }
    if !options.try_conversion { url = format!("{}&tryConversion={}", url, options.try_conversion); }

    let mut result = String::new();
    reqwest::get(&url)?.read_to_string(&mut result)?;
    let value: Value = serde_json::from_str(&mut result)?;

    Ok(value)
}

///
/// Get the price of any cryptocurrency in any other currency that you need at a given timestamp.
///
/// The price comes from the daily info - so it would be the price at the end of the day GMT based on the requested TS.
/// If the crypto does not trade directly into the toSymbol requested, BTC will be used for conversion.
/// Tries to get direct trading pair data, if there is none or it is more than 30 days before the ts requested, it uses BTC conversion.
///
/// # Example
/// ```
///     let option: Options = Options { exchanges: "Bitfinex", try_conversion: false };
///     let price_historical = cryptocompare::get_price_historical("IOT", "USD,BTC,ETH", &option);
/// ```
///
pub fn get_price_historical(fsym: &str, tsyms: &str, options: &Options) -> Result<serde_json::Value, Box<::std::error::Error>> {
    let mut url = format!("{}pricehistorical?fsym={}&tsyms={}&ts={}", BASE_URL, fsym, tsyms, time::get_time().sec);
    if options.exchanges != "" { url = format!("{}&e={}", url, options.exchanges); }
    if !options.try_conversion { url = format!("{}&tryConversion={}", url, options.try_conversion); }

    let mut result = String::new();
    reqwest::get(&url)?.read_to_string(&mut result)?;
    let value: Value = serde_json::from_str(&mut result)?;

    Ok(value)
}

///
/// Get open, high, low, close, volumefrom and volumeto daily historical data.
///
/// The values are based on 00:00 GMT time.
/// It uses BTC conversion if data is not available because the coin is not trading in the specified currency.
///
/// # Example
/// ```
///     let option: Options = Options { exchanges: "Bitfinex", try_conversion: false };
///     let limit: u64 = 3;
///     let history_day = cryptocompare::get_history_day("BTC", "USD", &option, &limit);
/// ```
///
pub fn get_history_day(fsym: &str, tsym: &str, options: &Options, limit: &u64) -> Result<serde_json::Value, Box<::std::error::Error>> {
    let mut url = format!("{}histoday?fsym={}&tsym={}&limit={}&aggregate=1", BASE_URL, fsym, tsym, limit);
    if options.exchanges != "" { url = format!("{}&e={}", url, options.exchanges); }
    if !options.try_conversion { url = format!("{}&tryConversion={}", url, options.try_conversion); }

    let mut result = String::new();
    reqwest::get(&url)?.read_to_string(&mut result)?;
    let value: Value = serde_json::from_str(&mut result)?;

    Ok(value)
}

///
/// Get open, high, low, close, volumefrom and volumeto from the each hour historical data.
///
/// It uses BTC conversion if data is not available because the coin is not trading in the specified currency.
///
/// # Example
/// ```
///     let option: Options = Options { exchanges: "Bitfinex", try_conversion: false };
///     let limit: u64 = 3;
///     let history_hour = cryptocompare::get_history_hour("BTC", "USD", &option, &limit);
/// ```
///
pub fn get_history_hour(fsym: &str, tsym: &str, options: &Options, limit: &u64) -> Result<serde_json::Value, Box<::std::error::Error>> {
    let mut url = format!("{}histohour?fsym={}&tsym={}&limit={}&aggregate=1", BASE_URL, fsym, tsym, limit);
    if options.exchanges != "" { url = format!("{}&e={}", url, options.exchanges); }
    if !options.try_conversion { url = format!("{}&tryConversion={}", url, options.try_conversion); }

    let mut result = String::new();
    reqwest::get(&url)?.read_to_string(&mut result)?;
    let value: Value = serde_json::from_str(&mut result)?;

    Ok(value)
}

///
/// Get open, high, low, close, volumefrom and volumeto from the each minute historical data.
///
/// This data is only stored for 7 days, if you need more,use the hourly or daily path.
/// It uses BTC conversion if data is not available because the coin is not trading in the specified currency.
///
/// # Example
/// ```
///     let option: Options = Options { exchanges: "Bitfinex", try_conversion: false };
///     let limit: u64 = 3;
///     let history_minute = cryptocompare::get_history_minute("BTC", "USD", &option, &limit);
/// ```
///
pub fn get_history_minute(fsym: &str, tsym: &str, options: &Options, limit: &u64) -> Result<serde_json::Value, Box<::std::error::Error>> {
    let mut url = format!("{}histominute?fsym={}&tsym={}&limit={}&aggregate=1", BASE_URL, fsym, tsym, limit);
    if options.exchanges != "" { url = format!("{}&e={}", url, options.exchanges); }
    if !options.try_conversion { url = format!("{}&tryConversion={}", url, options.try_conversion); }

    let mut result = String::new();
    reqwest::get(&url)?.read_to_string(&mut result)?;
    let value: Value = serde_json::from_str(&mut result)?;

    Ok(value)
}

///
/// Helper function to parse a JSON-Value to a Vector of Datasets
///
/// # Example
/// ```
///     let option: Options = Options { exchanges: "Bitfinex", try_conversion: false };
///     let limit: u64 = 3;
///     let history_minute = cryptocompare::get_history_minute("BTC", "USD", &option, &limit).unwrap();
///     let vector = cryptocompare::parse_json_to_vector(history_minute).unwrap();
/// ```
///
pub fn parse_json_to_vector(object: Value) -> Result<Vec<Dataset>, Box<::std::option::NoneError>> {
    let mut vector: Vec<Dataset> = Vec::new();
    let array = object.as_object()?["Data"].as_array()?;

    for entry in array {
        let elem = entry.as_object()?;
        vector.push(Dataset {
            close: elem["close"].as_f64()?,
            high: elem["high"].as_f64()?,
            low: elem["low"].as_f64()?,
            open: elem["open"].as_f64()?,
            time: elem["time"].as_i64()?,
            volumefrom: elem["volumefrom"].as_f64()?,
            volumeto: elem["volumeto"].as_f64()?
        })
    }
    Ok(vector)
}