Pull Requests and Suggestions for Improvements are highly welcomed and appreciated

CoinGecko API Client for Rust

Simple API Client for CoinGecko written in Rust

Available endpoint

| Endpoint | Status | Testing | Function | |:-------------------------------:|:-------:|:-------:|:--------------------------------:| | /ping | ✓ | | ping | | /simple/price | ✓ | | simplepriceshort, simpleprice | | /simple/supportedvscurrencies | ✓ | ✓ | SimpleSupportedVSCurrencies | | /coins/list | ✓ | ✓ | CoinsList | | /coins/market | ✓ | ✓ | CoinsMarket | | /coins/{id} | ✓ | ✓ | CoinsID | | /coins/{id}/history | ✓ | ✓ | CoinsIDHistory | | /coins/{id}/marketchart | ✓ | ✓ | CoinsIDMarketChart | | /events/countries | WIP | WIP | EventsCountries | | /events/types | WIP | WIP | EventsType | | /exchange_rates | ✓ | ✓ | ExchangeRate | | /global | ✓ | ✓ | Global |

More api Endpoints than listed here will be supported in the Future. As soon as I start working on additional Endpoints the Table will be updated.

rustls and OpenSSL/native-tls

By Default this Crate uses the rustls backend of reqwest, if you need native-tls/openSSL you need to activate the native-tls feature toml rustgecko = { version = "*" , features = ["native-tls"] }

Shortcut Methods

Some Methods with a lot of boolean Flags have a shorter Version i.E "simplepriceshort" for if you just want to retrieve Some Data and leave the Rest of the Params as their Default.

Usage

```rust use rustgecko::client::GeckoClient;

fn main() { let client = GeckoClient::default(); } ```

In a Production Setting or when you have a Coingecko Subscription you might want to supply your own Client with Credentials or with any other additional configuration.

```rust use rustgecko::client::GeckoClient;

fn main() { use reqwest::header; let mut headers = header::HeaderMap::new();

// Consider marking security-sensitive headers with `set_sensitive`.
let mut auth_value = header::HeaderValue::from_static("secret");
auth_value.set_sensitive(true);
headers.insert("x-cg-pro-api-key", auth_value);

// get a client builder
let client = reqwest::Client::builder()
    .default_headers(headers)
    .build()
    .unwrap();

let _ = GeckoClient::new_with_custom_client(client, "https://some.url");

} ```

Error Handling

Every 4XX Response is turned into an error of type reqwest::Error and propagated up the call chain.
For handling reqwest errors reference the Docs -> https://docs.rs/reqwest/0.7.2/reqwest/struct.Error.html

```rust async fn main() { if let Err(err) = GeckoClient::default().exchangerates().await { match err.status() { Some(StatusCode::TOOMANYREQUESTS) => info!("we have to slow down"), Some(_) => info!("Something else happened"), None => info!("We got an error without a status code"), } } }

```

License

MIT

THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.