market-data 0.5.0

A Rust lib to fetch & enhance historical time-series stock market data
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

# market-data

A Rust lib to fetch & enhance historical time-series stock market data.

This library provides a stateless, async-first API to download historical stock data from various providers and enhance it with common technical indicators.

## Features

- **Async-first**: Built on `tokio` and `reqwest`.
- **Stateless Architecture**: Reusable clients and immutable request objects.
- **Multiple Publishers**: Supports Finnhub, Alpha Vantage, Massive (formerly Polygon.io), Twelvedata, and Yahoo Finance.
- **Technical Indicators**: Built-in support for SMA, EMA, RSI, MACD, and Stochastic Oscillator.

## Installation

Add this to your `Cargo.toml`:

```toml
[dependencies]
market-data = "0.5"
tokio = { version = "1.0", features = ["full"] }
```

## Usage

Each publisher provides a set of methods to create request objects, which are then passed to the `MarketClient`.

```rust
use market_data::{MarketClient, Twelvedata, Interval};

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    // 1. Select a Publisher (e.g., Twelvedata)
    let site = Twelvedata::new("YOUR_TOKEN".to_string());
    
    // 2. Create the MarketClient
    let client = MarketClient::new(site);

    // 3. Create a stateless request
    let request = client.site.intraday_series("MSFT", 150, Interval::Min15)?;

    // 4. Fetch the data
    let data = client.fetch(request).await?;

    // 5. Enhance the data with technical indicators
    let enhanced_data = data
        .enhance_data()
        .with_sma(10)
        .with_ema(20)
        .with_rsi(14)
        .with_macd(12, 26, 9)
        .calculate();

    // 6. Print the results
    println!("{}", enhanced_data);

    Ok(())
}
```

### Supported Publishers

Details on rate limits and historical data depth can be found in [Publishers.md](Publishers.md).

- [x] [Finnhub](https://finnhub.io/docs/api)
- [x] [Alpha Vantage](https://www.alphavantage.co/documentation/)
- [x] [Massive](https://massive.com/docs/rest/stocks/aggregates/custom-bars) (formerly Polygon.io)
- [x] [Twelvedata](https://twelvedata.com/docs#time-series)
- [x] [Yahoo Finance](https://finance.yahoo.com/) (Unofficial, no token required)

### Supported Market Technical Indicators

- [x] [Simple Moving Average (SMA)](https://www.investopedia.com/terms/s/sma.asp)
- [x] [Exponential Moving Averages (EMA)](https://www.investopedia.com/terms/e/ema.asp)
- [x] [Relative Strength Index (RSI)](https://www.investopedia.com/terms/r/rsi.asp)
- [x] [Stochastic Oscillator](https://www.investopedia.com/terms/s/stochasticoscillator.asp)
- [x] [Moving Average Convergence/Divergence (MACD)](https://www.investopedia.com/terms/m/macd.asp)

## For Development

To run the examples, export your API keys:

```bash
export Finnhub_TOKEN=<your_token>
export Twelvedata_TOKEN=<your_token>
# etc...
```

Run an example:

```bash
cargo run --example series_finnhub
```

## Contributing

Contributions are welcome! If you'd like to add a new publisher or technical indicator, please raise a PR or create an issue.

## License

Apache-2.0