exchangerateapi-rust 0.1.0

Rust client for exchangerateapi.net: latest and historical endpoints
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

# exchangerateapi-rust

[![Crates.io](https://img.shields.io/crates/v/exchangerateapi-rust.svg)](https://crates.io/crates/exchangerateapi-rust)
[![Docs](https://img.shields.io/badge/docs-rustdoc-blue)](https://docs.rs/exchangerateapi-rust)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)

Rust client for [exchangerateapi.net](https://exchangerateapi.net) with two focused endpoints.

## Install

Add to `Cargo.toml`:

```toml
exchangerateapi-rust = "0.1"
```

## Quick start

```rust
use exchangerateapi_rust::Client;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let api_key = std::env::var("EXCHANGERATEAPI_KEY").unwrap_or_else(|_| "YOUR_API_KEY".into());
    let client = Client::new(api_key)?;

    let latest = client.latest("USD", None).await?;
    println!("latest: {}", latest.rates);
    Ok(())
}
```

## Usage

- Latest with optional symbols
- Historical by date and base

```rust
let subset = client.latest("EUR", Some(&["USD","GBP","JPY"])) .await?;
let hist = client.historical("2024-01-02", "USD", None).await?;
```

## Examples

Run with your API key:

```bash
EXCHANGERATEAPI_KEY=your_api_key cargo run --example latest
EXCHANGERATEAPI_KEY=your_api_key cargo run --example historical
```

## Free usage

A generous free tier exists for development and light workloads. Review current limits at [exchangerateapi.net](https://exchangerateapi.net).

## License

MIT