cgko 0.1.0

Unofficial Rust client for the CoinGecko API (cgko)
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

//! Simple price API endpoints

use super::types::*;
use crate::client::Client;
use crate::error::Result;

/// Simple price API
pub struct SimpleApi<'a> {
    client: &'a Client,
}

impl<'a> SimpleApi<'a> {
    pub fn new(client: &'a Client) -> Self {
        Self { client }
    }

    /// Get price for coins in given currencies
    ///
    /// # Example
    /// ```no_run
    /// # async fn example() -> gecko::error::Result<()> {
    /// let client = gecko::Client::new()?;
    /// let prices = client.simple().price(&["bitcoin", "ethereum"], &["usd", "eur"]).await?;
    /// # Ok(())
    /// # }
    /// ```
    pub async fn price(&self, ids: &[&str], vs_currencies: &[&str]) -> Result<PricesResponse> {
        let path = format!(
            "/simple/price?ids={}&vs_currencies={}",
            ids.join(","),
            vs_currencies.join(",")
        );
        self.client.get(&path).await
    }

    /// Get price with options
    pub async fn price_with_options(
        &self,
        ids: &[&str],
        vs_currencies: &[&str],
        options: &PriceOptions,
    ) -> Result<PricesResponse> {
        let path = format!(
            "/simple/price?ids={}&vs_currencies={}{}",
            ids.join(","),
            vs_currencies.join(","),
            options.to_query_string()
        );
        self.client.get(&path).await
    }

    /// Get token prices by contract address
    ///
    /// # Arguments
    /// * `platform` - Asset platform (e.g., "ethereum", "polygon-pos")
    /// * `contract_addresses` - Token contract addresses
    /// * `vs_currencies` - Target currencies
    pub async fn token_price(
        &self,
        platform: &str,
        contract_addresses: &[&str],
        vs_currencies: &[&str],
    ) -> Result<TokenPricesResponse> {
        let path = format!(
            "/simple/token_price/{}?contract_addresses={}&vs_currencies={}",
            platform,
            contract_addresses.join(","),
            vs_currencies.join(",")
        );
        self.client.get(&path).await
    }

    /// Get list of supported vs currencies
    pub async fn supported_vs_currencies(&self) -> Result<SupportedCurrencies> {
        self.client.get("/simple/supported_vs_currencies").await
    }
}