Quotes

Retrieve a real-time or historical quote for a specific option contract, identified by its OCC option symbol.

Making Requests

The Options resource offers GetQuoteAsync for one contract and GetQuotesAsync for several. Unlike stock quotes, the options backend does not batch symbols: GetQuotesAsync fans out one request per contract (bounded by the client's MaxConcurrentRequests) and returns a dictionary keyed by option symbol, so each contract keeps its own response metadata.

// One contract
Task<OptionsQuotesResponse> GetQuoteAsync(
    string optionSymbol, DateOnly? date = null, DateOnly? from = null, DateOnly? to = null,
    MarketDataRequestOptions? options = null, CancellationToken cancellationToken = default)
Task<OptionsQuotesResponse> GetQuoteAsync(OptionsQuoteRequest request, ...)

// Several contracts, one request each
Task<IReadOnlyDictionary<string, OptionsQuotesResponse>> GetQuotesAsync(
    string[] optionSymbols, DateOnly? date = null, DateOnly? from = null, DateOnly? to = null,
    MarketDataRequestOptions? options = null, CancellationToken cancellationToken = default)
Task<IReadOnlyDictionary<string, OptionsQuotesResponse>> GetQuotesAsync(OptionsQuotesRequest request, ...)

Request types

new OptionsQuoteRequest(string optionSymbol)
{
    Date = DateOnly,     // a single historical date
    From = DateOnly,     // historical window start
    To = DateOnly        // historical window end
}

new OptionsQuotesRequest(params string[] optionSymbols)   // or any IEnumerable<string>
{
    Date = DateOnly, From = DateOnly, To = DateOnly
}

Returns

OptionsQuotesResponse wrapping IReadOnlyList<OptionQuote> — a single row for a live quote, or one row per trading day for a historical window. See chain for the full OptionQuote record.

Examples

using MarketDataApp;

using var client = await MarketDataClient.CreateAsync();

// Live quote for one contract.
var quote = (await client.Options.GetQuoteAsync("AAPL271217C00250000")).Values[0];
Console.WriteLine($"{quote.OptionSymbol}: bid/ask={quote.Bid}/{quote.Ask}  IV={quote.Iv:P1}  delta={quote.Delta:F2}");

// Several contracts — one response per symbol.
var quotes = await client.Options.GetQuotesAsync(["AAPL271217C00250000", "AAPL271217P00250000"]);
foreach (var (symbol, response) in quotes)
{
    Console.WriteLine($"{symbol}: mid={response.Values[0].Mid}  (request {response.RequestId})");
}

For CSV output, call client.Options.GetQuoteCsvAsync(...) and read .Csv. See Settings.