Struct OptionContractQuery 

pub struct OptionContractQuery {

    pub underlying_ticker: Option<String>,
    pub contract_type: Option<OptionKind>,
    pub expiration_date: Option<NaiveDate>,
    pub expiration_date_gte: Option<NaiveDate>,
    pub expiration_date_gt: Option<NaiveDate>,
    pub expiration_date_lte: Option<NaiveDate>,
    pub expiration_date_lt: Option<NaiveDate>,
    pub strike_price: Option<Decimal>,
    pub strike_price_gte: Option<Decimal>,
    pub strike_price_gt: Option<Decimal>,
    pub strike_price_lte: Option<Decimal>,
    pub strike_price_lt: Option<Decimal>,
    pub expired: Option<bool>,
    pub as_of: Option<NaiveDate>,
    pub limit: Option<u16>,
    pub order: Option<SortOrder>,
    pub sort: Option<String>,
}

Filter parameters for the /v3/reference/options/contracts endpoint.

All fields are optional. Construct with OptionContractQuery::new and chain setters. The fetch method handles pagination automatically.

Example

use rustrade_data::exchange::massive::OptionContractQuery;
use chrono::NaiveDate;

let query = OptionContractQuery::new()
    .underlying_ticker("AAPL")
    .contract_type(OptionKind::Call)
    .expiration_date_gte(NaiveDate::from_ymd_opt(2024, 1, 1).unwrap())
    .strike_price_gte(dec!(150))
    .strike_price_lte(dec!(200))
    .limit(500);

Fields

underlying_ticker: Option<String>

Filter by underlying stock ticker.

contract_type: Option<OptionKind>

Filter by contract type (call/put).

expiration_date: Option<NaiveDate>

Filter by exact expiration date.

expiration_date_gte: Option<NaiveDate>

Filter by expiration date >= value.

expiration_date_gt: Option<NaiveDate>

Filter by expiration date > value.

expiration_date_lte: Option<NaiveDate>

Filter by expiration date <= value.

expiration_date_lt: Option<NaiveDate>

Filter by expiration date < value.

strike_price: Option<Decimal>

Filter by exact strike price.

strike_price_gte: Option<Decimal>

Filter by strike price >= value.

strike_price_gt: Option<Decimal>

Filter by strike price > value.

strike_price_lte: Option<Decimal>

Filter by strike price <= value.

strike_price_lt: Option<Decimal>

Filter by strike price < value.

expired: Option<bool>

Include expired contracts (default: false).

as_of: Option<NaiveDate>

Point-in-time query date (default: today).

limit: Option<u16>

Results per page (max 1000).

order: Option<SortOrder>

Sort direction.

sort: Option<String>

Field to sort by.

Implementations

impl OptionContractQuery

pub fn new() -> Self

Create a new empty query.

pub fn underlying_ticker(self, v: impl Into<String>) -> Self

Filter by underlying stock ticker (e.g., “AAPL”).

pub fn contract_type(self, v: OptionKind) -> Self

Filter by contract type (Call or Put).

pub fn expiration_date(self, v: NaiveDate) -> Self

Filter by exact expiration date.

pub fn expiration_date_gte(self, v: NaiveDate) -> Self

Filter by expiration date >= value.

pub fn expiration_date_gt(self, v: NaiveDate) -> Self

Filter by expiration date > value.

pub fn expiration_date_lte(self, v: NaiveDate) -> Self

Filter by expiration date <= value.

pub fn expiration_date_lt(self, v: NaiveDate) -> Self

Filter by expiration date < value.

pub fn strike_price(self, v: Decimal) -> Self

Filter by exact strike price.

pub fn strike_price_gte(self, v: Decimal) -> Self

Filter by strike price >= value.

pub fn strike_price_gt(self, v: Decimal) -> Self

Filter by strike price > value.

pub fn strike_price_lte(self, v: Decimal) -> Self

Filter by strike price <= value.

pub fn strike_price_lt(self, v: Decimal) -> Self

Filter by strike price < value.

pub fn expired(self, v: bool) -> Self

Include expired contracts (default: false).

pub fn as_of(self, v: NaiveDate) -> Self

Point-in-time query date (default: today).

pub fn limit(self, v: u16) -> Self

Set results per page (clamped to max 1000).

pub fn order(self, v: SortOrder) -> Self

Set sort direction.

pub fn sort(self, v: impl Into<String>) -> Self

Set field to sort by.

pub fn validate(&self) -> Result<(), MassiveError>

Validate the query for conflicting filters.

Trait Implementations

impl Clone for OptionContractQuery

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for OptionContractQuery

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for OptionContractQuery

fn default() -> Self

Returns the “default value” for a type.