Struct AlpacaOptionContractQuery 

pub struct AlpacaOptionContractQuery {
    pub underlying_symbols: Vec<String>,
    pub expiration_date_gte: Option<NaiveDate>,
    pub expiration_date_lte: Option<NaiveDate>,
    pub strike_price_gte: Option<Decimal>,
    pub strike_price_lte: Option<Decimal>,
    pub option_type: Option<OptionKind>,
    pub style: Option<OptionExercise>,
    pub limit: Option<usize>,
}

Query parameters for option contract discovery.

Use builder methods to construct the query, then pass to AlpacaOptionsClient::fetch_contracts.

Example

use rustrade_data::exchange::alpaca::options::AlpacaOptionContractQuery;
use chrono::NaiveDate;
use rust_decimal_macros::dec;

let query = AlpacaOptionContractQuery::new(vec!["AAPL".into(), "TSLA".into()])
    .expiration_gte(NaiveDate::from_ymd_opt(2024, 1, 1).unwrap())
    .expiration_lte(NaiveDate::from_ymd_opt(2024, 3, 31).unwrap())
    .strike_gte(dec!(100))
    .strike_lte(dec!(200))
    .call_only();

Fields

underlying_symbols: Vec<String>

Filter by underlying symbols (e.g., [“AAPL”, “TSLA”]).

expiration_date_gte: Option<NaiveDate>

Minimum expiration date (inclusive).

expiration_date_lte: Option<NaiveDate>

Maximum expiration date (inclusive).

strike_price_gte: Option<Decimal>

Minimum strike price (inclusive).

strike_price_lte: Option<Decimal>

Maximum strike price (inclusive).

option_type: Option<OptionKind>

Filter by option type (call or put).

style: Option<OptionExercise>

Filter by exercise style (american or european).

limit: Option<usize>

Page size (default 1000, max 10000).

Implementations

impl AlpacaOptionContractQuery

pub fn new(underlying_symbols: Vec<String>) -> Self

Create a new query for the given underlying symbols.

pub fn expiration_gte(self, date: NaiveDate) -> Self

Filter contracts expiring on or after this date.

pub fn expiration_lte(self, date: NaiveDate) -> Self

Filter contracts expiring on or before this date.

pub fn strike_gte(self, strike: Decimal) -> Self

Filter contracts with strike price at or above this value.

pub fn strike_lte(self, strike: Decimal) -> Self

Filter contracts with strike price at or below this value.

pub fn call_only(self) -> Self

Filter to call options only.

pub fn put_only(self) -> Self

Filter to put options only.

pub fn option_type(self, kind: OptionKind) -> Self

Filter by option type.

pub fn style(self, style: OptionExercise) -> Self

Filter by exercise style.

pub fn limit(self, limit: usize) -> Self

Set page size (max 10000).

Trait Implementations

impl Clone for AlpacaOptionContractQuery

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 AlpacaOptionContractQuery

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

Formats the value using the given formatter.

impl Default for AlpacaOptionContractQuery

fn default() -> Self

Returns the “default value” for a type.