Skip to content

Get Quotes (Batch)

read-only · idempotent

Get current prices for multiple symbols in a single call.

Batch version of get_quote — returns quotes for up to 50 symbols at once. Reduces round-trips when checking prices for multiple positions or watchlists.

Each symbol is resolved independently: live bid/ask from QUOTE session if available, otherwise fallback to last fill price from TRADE session. Symbols that fail are reported in the errors array without blocking successful ones.

PARAMETERS:

  • symbols: Array of symbol names (e.g., [“EURUSD”, “XAUUSD”, “GBPUSD”])
    • 1-50 symbols per request
    • Same format as get_quote symbol parameter

RESPONSE FIELDS:

  • quotes: Array of quote objects (same fields as get_quote per symbol)
  • errors: Array of { symbol, error } for symbols with no price data
  • count: Number of successful quotes
  • errorCount: Number of failed symbols

USAGE:

  • Use instead of calling get_quote N times in a loop
  • Call subscribe_quotes first if you need live prices for the symbols
  • Check the errors array to identify symbols that need subscription

This is a read-only operation with no risk checks.

ParameterTypeRequiredDescription
symbolsstringYesArray of symbols to get quotes for (e.g., [‘EURUSD’, ‘XAUUSD’])