cgko 0.1.4

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

//! Treasury API endpoints

use super::types::{
    EntityListItem, HoldingChart, PublicTreasuryByCoin, PublicTreasuryByEntity, TransactionHistory,
};
use crate::client::Client;
use crate::error::Result;

/// Treasury API (Public companies and governments holding crypto)
pub struct TreasuryApi<'a> {
    client: &'a Client,
}

impl<'a> TreasuryApi<'a> {
    #[must_use]
    pub fn new(client: &'a Client) -> Self {
        Self { client }
    }

    /// List all public entities (companies/governments)
    pub async fn entities(&self) -> Result<Vec<EntityListItem>> {
        self.client.get("/entities/list").await
    }

    /// Get public treasury holdings by coin ID
    ///
    /// # Arguments
    /// * `entity` - Entity type: "companies" or "governments"
    /// * `coin_id` - Coin ID (e.g., "bitcoin", "ethereum")
    pub async fn by_coin(&self, entity: &str, coin_id: &str) -> Result<PublicTreasuryByCoin> {
        let path = format!("/{entity}/public_treasury/{coin_id}");
        self.client.get(&path).await
    }

    /// Get public treasury holdings by entity ID
    pub async fn by_entity(&self, entity_id: &str) -> Result<PublicTreasuryByEntity> {
        let path = format!("/public_treasury/{entity_id}");
        self.client.get(&path).await
    }

    /// Get historical holdings chart for an entity's coin holdings
    pub async fn holding_chart(&self, entity_id: &str, coin_id: &str) -> Result<HoldingChart> {
        let path = format!("/public_treasury/{entity_id}/{coin_id}/holding_chart");
        self.client.get(&path).await
    }

    /// Get transaction history for an entity
    pub async fn transaction_history(&self, entity_id: &str) -> Result<TransactionHistory> {
        let path = format!("/public_treasury/{entity_id}/transaction_history");
        self.client.get(&path).await
    }
}