This project provides a set of functions to receive data from the the yahoo! finance website via their API. This project is licensed under Apache 2.0 or MIT license (see files LICENSE-Apache2.0 and LICENSE-MIT).
There is already an existing rust library yahoo-finance-rs, which I intended to use for my own projects. However, due some issues in the implementation (the library panics in some cases if yahoo does provide somehow invalid data), I currently can't use it. Once this issue is fixed, I might switch back and drop development of this library.
Since version 0.3 and the upgrade to reqwest
0.10, all requests to the yahoo API return futures, using async
features.
Therefore, the functions need to be called from within another async
function with .await
or via funtions like block_on
. The examples are based on the tokio
runtime applying the tokio-test
crate.
Use the blocking
feature to get the previous behavior back: i.e. yahoo_finance_api = {"version": "0.3", features = ["blocking"]}
.
Get the latest available quote: ```rust use yahoofinanceapi as yahoo; use std::time::{Duration, UNIXEPOCH}; use chrono::prelude::*; use tokiotest;
fn main() {
let provider = yahoo::YahooConnector::new();
// get the latest quotes in 1 minute intervals
let response = tokiotest::blockon(provider.getlatestquotes("AAPL", "1m")).unwrap();
// extract just the latest valid quote summery
// including timestamp,open,close,high,low,volume
let quote = response.lastquote().unwrap();
let time: DateTime
//!
Get history of quotes for given time period:
rust
use yahoofinanceapi as yahoo;
use std::time::{Duration, UNIXEPOCH};
use chrono::{Utc,TimeZone};
use tokiotest;
fn main() { let provider = yahoo::YahooConnector::new(); let start = Utc.ymd(2020, 1, 1).andhmsmilli(0, 0, 0, 0); let end = Utc.ymd(2020, 1, 31).andhmsmilli(23, 59, 59, 999); // returns historic quotes with daily interval let resp = tokiotest::blockon(provider.getquotehistory("AAPL", start, end)).unwrap(); let quotes = resp.quotes().unwrap(); println!("Apple's quotes in January: {:?}", quotes); }
``` Another method to retrieve a range of quotes is by requesting the quotes for a given period and lookup frequency. Here is an example retrieving the daily quotes for the last month:
```rust use yahoofinanceapi as yahoo; use std::time::{Duration, UNIXEPOCH}; use chrono::{Utc,TimeZone}; use tokiotest;
fn main() { let provider = yahoo::YahooConnector::new(); let response = tokiotest::blockon(provider.getquoterange("AAPL", "1d", "1mo")).unwrap(); let quotes = response.quotes().unwrap(); println!("Apple's quotes of the last month: {:?}", quotes); } ```