Quotes

Retrieve real-time quotes (bid, ask, mid, last, volume, etc.) for one or more stock symbols.

Making Requests

The Stocks resource offers two quote methods:

• GetQuoteAsync(...) — a single symbol.
• GetQuotesAsync(...) — several symbols in one request (the stocks backend batches a comma list). The result is a single response with one row per symbol.

// Single symbol
Task<StockQuotesResponse> GetQuoteAsync(
    string symbol, bool? extended = null, bool? candle = null, bool? week52 = null,
    MarketDataRequestOptions? options = null, CancellationToken cancellationToken = default)
Task<StockQuotesResponse> GetQuoteAsync(StockQuoteRequest request, ...)

// Multiple symbols, one request
Task<StockQuotesResponse> GetQuotesAsync(
    string[] symbols, bool? extended = null, bool? candle = null, bool? week52 = null,
    MarketDataRequestOptions? options = null, CancellationToken cancellationToken = default)
Task<StockQuotesResponse> GetQuotesAsync(StockQuotesRequest request, ...)

Request types

// Single symbol
new StockQuoteRequest(string symbol)
{
    Extended = bool,   // include extended-session prices
    Candle = bool,     // add OHLC columns
    Week52 = bool      // add 52-week high/low
}

// Multiple symbols, one request
new StockQuotesRequest(params string[] symbols)   // or any IEnumerable<string>
{
    Extended = bool,
    Candle = bool,
    Week52 = bool
}

Returns

StockQuotesResponse wrapping IReadOnlyList<StockQuote> (one element for GetQuoteAsync, one per symbol for GetQuotesAsync). All fields are nullable: Columns can project any field away, and the backend maps NaN to null for closed or illiquid markets.

public record StockQuote(
    string? Symbol,
    decimal? Ask, long? AskSize,
    decimal? Bid, long? BidSize,
    decimal? Mid, decimal? Last,
    decimal? Change, double? ChangePct,        // ChangePct is a fraction: 0.0123 == +1.23%
    long? Volume, DateTimeOffset? Updated,     // Updated is America/New_York
    // opt-in via Candle = true:
    decimal? Open, decimal? High, decimal? Low, decimal? Close,
    // opt-in via Week52 = true:
    decimal? Week52High, decimal? Week52Low);

Examples

using MarketDataApp;
using MarketDataApp.Stocks;

using var client = await MarketDataClient.CreateAsync();

// A single quote — the response is a list; a single symbol is row 0.
var quote = (await client.Stocks.GetQuoteAsync("AAPL")).Values[0];
Console.WriteLine($"{quote.Symbol}: bid={quote.Bid} ask={quote.Ask} last={quote.Last}");

// Several symbols in one request, with the 52-week range opted in.
var quotes = await client.Stocks.GetQuotesAsync(["AAPL", "MSFT", "GOOG"], week52: true);
foreach (var row in quotes.Values)
{
    Console.WriteLine($"{row.Symbol}: last={row.Last}  52w {row.Week52Low}–{row.Week52High}");
}

// The same call with a request object, grouping the optional flags.
var detailed = await client.Stocks.GetQuotesAsync(
    new StockQuotesRequest("AAPL", "MSFT") { Candle = true, Extended = true });

For CSV output, call client.Stocks.GetQuoteCsvAsync(...) or GetQuotesCsvAsync(...) and read .Csv. See Settings.