finance-query 3.0.0

A Rust library for querying financial data
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

//! Futures market data models.
//!
//! Canonical public types for futures contracts and quotes,
//! shared across Yahoo, Polygon, and other futures data providers.

use serde::{Deserialize, Serialize};

/// Commitments of Traders weekly positioning models (CFTC).
#[cfg(feature = "cftc")]
pub mod cot;

/// A futures contract quote.
///
/// Obtain via [`Providers::futures`](crate::Providers::futures)`(symbol).quote()`.
#[derive(Debug, Clone, Serialize, Deserialize)]
#[non_exhaustive]
pub struct FuturesQuote {
    /// Contract ticker symbol (e.g., `"ESM26"` for E-mini S&P June 2026)
    pub symbol: String,
    /// Human-readable contract name
    pub name: Option<String>,
    /// Underlying asset (e.g., `"S&P 500"`, `"Crude Oil"`)
    pub underlying: Option<String>,
    /// Exchange where the contract trades
    pub exchange: Option<String>,
    /// Contract expiration date as YYYY-MM-DD
    pub expiration_date: Option<String>,
    /// Current contract price
    pub price: Option<f64>,
    /// Price change
    pub change: Option<f64>,
    /// Price change as a percentage (e.g. `9.62` for 9.62%)
    pub change_percent: Option<f64>,
    /// Open interest (number of outstanding contracts)
    pub open_interest: Option<u64>,
    /// Session volume in contracts
    pub volume: Option<u64>,
    /// Unix timestamp of the last update, in **seconds**
    pub timestamp: Option<i64>,
}