Struct Commodity 

pub struct Commodity { /* private fields */ }

A commodity backed by configured data providers.

Created via Providers::commodity.

Implementations

impl Commodity

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

Cache responses for ttl, deduplicating concurrent identical requests. Off by default (each call fetches fresh).

pub fn symbol(&self) -> &str

The handle’s identifier string.

impl Commodity

pub async fn quote(&self) -> Result<CommodityQuote>

Fetch the current quote for this commodity.

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

Fetch historical OHLCV candles for this commodity.

The symbol is passed to the CHART route as-is. Note this expects the route’s chart-symbol form (e.g. the Yahoo futures symbol GC=F for gold), which differs from the commodity names (WHEAT) some providers use for quote.

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

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

impl Commodity

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

Compute all technical indicators from this handle’s chart data.

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

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

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

Compute a risk summary (VaR, Sharpe/Sortino/Calmar, max drawdown) from this handle’s chart data. Annualised with this asset class’s trading calendar, so non-daily intervals scale correctly. beta is always None (no benchmark for non-equity handles).