Struct CryptoCoin 

pub struct CryptoCoin { /* private fields */ }

A cryptocurrency coin backed by configured data providers.

Created via Providers::crypto.

Implementations

impl CryptoCoin

pub fn cache(self, ttl: Duration) -> Self

Cache responses for ttl instead of the default 60 seconds, deduplicating concurrent identical requests.

pub fn cache_forever(self) -> Self

Cache responses for the handle’s lifetime instead of the default 60 seconds.

pub fn no_cache(self) -> Self

Disable caching — every call fetches fresh data.

pub fn id(&self) -> &str

The handle’s identifier string.

impl CryptoCoin

pub async fn quote(&self, vs_currency: &str) -> Result<CryptoQuote>

Fetch the current quote for this coin priced in vs_currency (e.g., "usd").

pub async fn tvl(&self) -> Result<ProtocolTvl>

Fetch total value locked for this handle read as a DeFi protocol slug (e.g. providers.crypto("aave")).

Routed through Capability::CRYPTO; only DefiLlama serves it, so route CRYPTO to include Provider::DefiLlama. The id is a protocol slug here, not a coin id — most DefiLlama slugs happen to match their CoinGecko id, but not all do. The response is cached on the handle, so a repeat call costs nothing.

pub async fn tvl_history(&self) -> Result<Vec<TvlPoint>>

Fetch this protocol’s full TVL history, oldest first.

Same routing and slug semantics as tvl.

pub async fn chart( &self, vs_currency: &str, interval: Interval, range: TimeRange, ) -> Result<Chart>

Fetch historical OHLCV candles for this coin priced in vs_currency.

Unlike quote (which uses the coin id, e.g. "bitcoin"), the CHART route is symbol-based, so the chart symbol is built as "{ID}-{VS}" uppercased (e.g. "BTC-USD"). This resolves on the default Yahoo route only when the handle’s id is the coin’s ticker (providers.crypto("BTC")); coins identified by a CoinGecko id should route Capability::CHART to a crypto-aware provider.

With the crypto feature, .route(Capability::CHART, [Provider::CoinGecko]) serves history keylessly by coin id. CoinGecko picks its own bar granularity from the requested range, so interval is advisory there, and its OHLC endpoint carries no volume — those candles report volume: 0.

pub async fn history( &self, vs_currency: &str, range: TimeRange, ) -> Result<Chart>

Fetch historical candles over range at a sensible default interval (TimeRange::default_interval).

pub async fn indicators( &self, vs_currency: &str, interval: Interval, range: TimeRange, ) -> Result<IndicatorsSummary>

Compute all technical indicators from this coin’s chart data (priced in vs_currency).

pub async fn indicator( &self, indicator: Indicator, vs_currency: &str, interval: Interval, range: TimeRange, ) -> Result<IndicatorResult>

Compute a single technical indicator from this coin’s chart data.

pub async fn news(&self, limit: u32) -> Result<Vec<News>>

Fetch market-wide crypto news via Capability::CRYPTO (currently FMP only). Not scoped to this handle’s coin id.

pub async fn risk( &self, vs_currency: &str, interval: Interval, range: TimeRange, ) -> Result<RiskSummary>

Compute a risk summary from this coin’s chart data, annualised with the 24/7 crypto calendar (365 days/year). beta is always None.