Quotes

Retrieve quotes for one or more specific option contracts, including full Greeks.

Making Requests

Use the quotes() method on the options resource to fetch quotes for individual option contracts identified by their OCC symbol. When multiple symbols are provided, the SDK fans out concurrently and merges the results.

Output Format	Result Payload	Description
internal (default)	OptionsQuotes[] or OptionsQuotesHuman[]	Array of decoded quote records, one per contract.
json	Raw JSON object	The compressed, array-keyed response object.
csv	Blob	CSV payload. Use .save(filename) to write it.

quotes

// Positional form
quotes<P>(
  symbols: string | string[],
  params?: P,
): MarketDataResult<OptionsQuotes[] | OptionsQuotesHuman[]>

// Object form
quotes<P>(
  params: P & { symbols: string | string[] },
): MarketDataResult<OptionsQuotes[] | OptionsQuotesHuman[]>

Fetches quotes for one or more option contracts.

Parameters

• symbols (string | string[])

  A single OCC-format option symbol (e.g. "AAPL271217C00250000") or an array of symbols. When you pass an array, the SDK fetches each contract concurrently and merges the results.

• outputFormat (optional): The format of the returned data. Alias: format.

• dateFormat (optional): Date format. Alias: dateformat.

• columns (optional): Columns to include.

• addHeaders (optional): Whether to include headers in CSV output. Alias: headers.

• useHumanReadable (optional): Use human-readable field names. Alias: human.

• mode (optional): The data mode to use.

Additional endpoint-specific parameters like from, to, and date are passed through to the REST API. See REST API Options Quotes for the full list.

Returns

• MarketDataResult<OptionsQuotes[] | OptionsQuotesHuman[] | Blob>

Single Contract

import { MarketDataClient } from "marketdata-sdk-js";

const client = new MarketDataClient();

const result = await client.options.quotes("AAPL271217C00250000");

result.match(
  (quotes) => {
    const q = quotes[0];
    console.log(
      `${q.optionSymbol}: bid=${q.bid} ask=${q.ask} delta=${q.delta}`
    );
  },
  (error) => console.error(error.message),
);

Multiple Contracts

import { MarketDataClient } from "marketdata-sdk-js";

const client = new MarketDataClient();

const result = await client.options.quotes([
  "AAPL271217C00250000",
  "AAPL271217P00250000",
  "AAPL271217C00300000",
]);

result.match(
  (quotes) => {
    for (const q of quotes) {
      console.log(`${q.optionSymbol}: mid=${q.mid}`);
    }
  },
  (error) => console.error(error.message),
);

Human Readable

import { MarketDataClient } from "marketdata-sdk-js";

const client = new MarketDataClient();

const result = await client.options.quotes("AAPL271217C00250000", {
  human: true,
});

result.match(
  (quotes) => console.log(quotes[0]),
  (error) => console.error(error.message),
);

OptionsQuotes

OptionsQuotes uses the same field shape as OptionsChain: optionSymbol, underlying, expiration, side, strike, bid, ask, mid, last, openInterest, volume, inTheMoney, intrinsicValue, extrinsicValue, iv, delta, gamma, theta, vega, and so on.

See OptionsChain for the complete list of fields.

OptionsQuotesHuman

OptionsQuotesHuman is returned when human: true is set. Field shape mirrors OptionsChainHuman — same columns, Title_Case names.