Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Julien-R44/cli-candlestick-chart
📈 Display candlestick charts right into your terminal.
https://github.com/Julien-R44/cli-candlestick-chart
candlestick-chart cli cryptocurrency financial rust terminal trading
Last synced: 2 months ago
JSON representation
📈 Display candlestick charts right into your terminal.
- Host: GitHub
- URL: https://github.com/Julien-R44/cli-candlestick-chart
- Owner: Julien-R44
- License: mit
- Created: 2021-11-11T23:50:34.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2022-11-29T07:49:25.000Z (about 2 years ago)
- Last Synced: 2024-08-09T21:32:12.394Z (5 months ago)
- Topics: candlestick-chart, cli, cryptocurrency, financial, rust, terminal, trading
- Language: Rust
- Homepage:
- Size: 151 KB
- Stars: 249
- Watchers: 9
- Forks: 21
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
Draw candlesticks charts right into your terminal. 📈
* [Features](#features)
* [API Usage](#api-usage)
* [Binary Usage](#binary-usage)
* [Examples](#examples)
# Features
- Customizable
- Auto-fit to terminal size
- Shipped as library with simple API
- Shipped as binary for standalone usage
# API Usage
Add this to your `Cargo.toml`
```toml
[dependencies]
cli-candlestick-chart = "0.3"
```
```rust
use cli_candlestick_chart::{Candle, Chart};
fn main() {
// Add some candles
let candles: Vec = vec![
Candle::new(133.520004, 133.610001, 126.760002, 129.410004),
Candle::new(128.889999, 131.740005, 128.429993, 131.009995),
Candle::new(127.720001, 131.050003, 126.379997, 126.599998),
Candle::new(128.360001, 131.630005, 127.860001, 130.919998),
Candle::new(132.429993, 132.630005, 130.229996, 132.050003),
];
// Create and display the chart
let mut chart = Chart::new(&candles);
// Set the chart title
chart.set_name(String::from("BTC/USDT"));
// Set customs colors
chart.set_bear_color(1, 205, 254);
chart.set_bull_color(255, 107, 153);
chart.set_vol_bull_color(1, 205, 254);
chart.set_vol_bear_color(255, 107, 153);
chart.set_volume_pane_height(6);
chart.set_volume_pane_enabled(false);
chart.draw();
}
```
# Binary Usage
Download the latest release for your platform [here](https://github.com/Julien-R44/cli-candlestick-chart/releases)
```
USAGE:
cli-candlestick-chart.exe [OPTIONS] --mode
FLAGS:
-h, --help Prints help information
-V, --version Prints version information
OPTIONS:
--bear-color Sets the descending candles color in hexadecimal.
--bull-color Sets the ascending candles color in hexadecimal.
--chart-name Sets the chart name.
-f, --file [MODE:*-file] File to read candles from.`
-m, --mode Select the method for retrieving the candles.
[possible values: stdin, csv-file, json-file]
```
When requesting the CSV file mode, the library expects a CSV file with `open,high,low,close` headers fields.
When requesting the JSON or stdin mode, the library expects a JSON with the following format :
```
[
{
"open": 28994.009766,
"high": 29600.626953,
"low": 28803.585938,
"close": 29374.152344,
"volume": 13456 // Optional
},
...
]
```
# Examples
## API
[Basic example with CSV parsing](https://github.com/Julien-R44/cli-candlestick-chart/blob/main/examples/basic-with-csv-parsing.rs) : Run with `cargo run --example basic-with-csv-parsing --features=serde,csv`
[Fetch candles from binance](https://github.com/Julien-R44/cli-candlestick-chart/blob/main/examples/fetch-from-binance.rs) : Run with `cargo run --example fetch-from-binance --features=serde,reqwest`
## Binary
- Read CSV from file :
```bash
./cli-candlestick-chart \
--mode=csv-file \
-f=./examples/BTC-USD.csv \
--chart-name="My BTC Chart" \
--bear-color="#b967ff" \
--bull-color="ff6b99"
```
- Read from stdin :
```bash
echo '[
{
"open": 28994.009766,
"high": 29600.626953,
"low": 28803.585938,
"close": 29374.152344
},
{
"open": 29376.455078,
"high": 33155.117188,
"low": 29091.181641,
"close": 32127.267578
}
]' | ./cli-candlestick-chart \
--mode=stdin \
--chart-name="My BTC Chart" \
--bear-color="#b967ff" \
--bull-color="ff6b99"
```
## Other versions
If you prefer Python, there is a port of the library, developed by [BoboTiG](https://github.com/BoboTiG), right there : https://github.com/BoboTiG/py-candlestick-chart