1 unstable release

0.1.0 May 23, 2023

#219 in #com

MIT license

14KB
242 lines

fxapi-rs: Rust Currency Converter

This package is a Rust wrapper for fxapi.com that aims to make the usage of the API as easy as possible in your project. Fxapi.com is a exchange rates API that provides historic and realtime foreign exchange data.

Installation

This crate is under development. Especially the response parsing needs some more testing. However, if you still want to use it, you can install it by adding this to your Cargo.toml:

[dependencies]
fxapi = "0.1.0"

Requirements

  1. API Key for fxapi.com
  2. Async runtime like tokio

Quickstart

use fxapi::Fxapi;
use fxapi::models;

async fn request_latest() -> Result<models::DetailsResponse, fxapi::Error> {
    let c_api = Fxapi::new("<your-api-key>")?;
    let details = c_api.latest("id-of-a-fuel-station").await?;
     Ok(details)
}

Endpoints accessible with a free account:

  • status
  • currencies
  • latest
  • historical

These advanced endpoints currently require a paid subscription:

  • convert
  • range

Find out more about our endpoints, parameters and response data structure in the docs

License

The MIT License (MIT). Please see License File for more information.

Dependencies

~4–18MB
~236K SLoC