Updated: 2017-05-22

getQuote

By Barchart

    The getQuote API is used to request price data, either real-time, delayed or end-of-day, by symbol.

    Query Parameters

    Parameter Description Data Type
    fields The fields requested.
    mode Parameter to change quote type to real-time ("R"), delayed ("I") or end-of-day ("D") if available.
    symbols A symbol or code that identifies a financial instrument. Multiple symbols separated by a comma may be used. For futures, notation such as <root_symbol0> for the active contract or <root_symbol1> for the first nearby is supported, as is <root_symbol^F> for all futures contracts for a given root symbol, as is <root_symbol^O> for all options contracts for a given underlying futures symbol.

    Response Fields

    Field Description Data Type
    afterHoursNetChange The after hour net change for the instrument double
    afterHoursPercentChange The after hour percent change for the instrument double
    afterHoursPrice The after hour price for the instrument double
    afterHoursTimestamp The after hour price for the instrument dateTime
    ask The current ask price. double
    askSize The size (quantity) of the current ask price. int
    averageMonthlyVolume The average one month volume. int
    averageQuarterlyVolume The average 3 month volume. int
    averageWeeklyVolume The average volume for the last five trading days. int
    avgVolume The average daily volume. int
    bid The current bid price. double
    bidSize The size (quantity) of the current bid price. int
    close The last traded price for the session. double
    dayCode The day code for the session. Day codes are "1-9" for days 1 through 9, "0" (zero) for the 10th of the month, and "A - U" for days 11 through 31. string
    dividendRateAnnual The total dividend payout over one year. float
    dividendYieldAnnual The annual dividend divided by the current share price. float
    dollarVolume double
    exDividendDate The last possible date to have owned shares of a stock and still be entitled to the associated dividend. date
    exchangeMargin The margin maintenance required for the future. string
    expirationDate The expiration date for the futures contract. Only returns a value for futures. date
    fiftyTwoWkHigh The highest price over the past 52 weeks. double
    fiftyTwoWkHighDate The date in which the high price was reached over the past 52 weeks. date
    fiftyTwoWkLow The low price over the past 52 weeks. double
    fiftyTwoWkLowDate The date in which the low price was reached over the past 52 weeks. date
    flag If present, can be one of the following: "c" meaning that the market is closed for this instrument. "p" meaning that the market is in a pre-open state. This occurs when there are bids and offers being placed, but no trade has occured yet. This is normally seen shortly before the official opening time for busy markets, but can also be seen throughout the day for lightly traded markets. "s" meaning that the instrument has settled, and that this is the final, settlement price. string
    high The highest traded price for the session. double
    impliedVolatility double
    lastPrice The last price the instrument traded. double
    lastTradingDay The last trading day of the futures contract. Only returns a value for futures. string
    low The lowest traded price for the session. double
    mode An indicator representing if the quote is real-time ("R"), delayed ("I") or end-of-day ("D"). string
    month Contract month returned for futures. string
    name The type of symbol used. string
    netChange The difference between the last traded price and the previous close. double
    numTrades The number of individual transactions over the course of a trading session. int
    oneMonthHigh The highest price over the last month. double
    oneMonthHighDate The date when the high price was reached over the last month. date
    oneMonthLow The lowest price over the last month. double
    oneMonthLowDate The date when the low price was reached over the last month. date
    open The opening (first) price for the session. double
    openInterest The quantity of open interest for futures. double
    percentChange The percent difference between the last traded price and the previous close. double
    preMarketNetChange The pre market net change for the instrument double
    preMarketPercentChange The pre market percent change for the instrument double
    preMarketPrice The pre market price for the instrument double
    preMarketTimestamp The pre market price for the instrument dateTime
    previousClose The last traded price for the previous session. double
    previousLastPrice The price previous to the current last price. double
    previousSettlement The settlement price for the previous session. double
    previousTimestamp The exchange timestamp of the previous last price. date
    previousVolume The quantity of shares or contracts traded from the previous day. int
    serverTimestamp The time the message was generated on the server. dateTime
    settlement The settlement price determined the exchange. double
    sharesOutstanding The total number of shares outstanding. int
    sixMonthHigh The highest price over the last 6 month. double
    sixMonthHighDate The date when the high price was reached over the last 6 month. date
    sixMonthLow The lowest price over the last 6 month. double
    sixMonthLowDate The date when the low price was reached over the last 6 month. date
    symbol A symbol or code that identifies a financial instrument. string
    threeMonthHigh The highest price over the last 3 month. double
    threeMonthHighDate The date when the high price was reached over the last 3 month. date
    threeMonthLow The lowest price over the last 3 month. double
    threeMonthLowDate The date when the low price was reached over the last 3 month. date
    tick An indicator representing whether the last traded price was up ("+"), the same (".") or below ("-") the previous last price. string
    tradeSize The size of the last traded price / transaction. int
    tradeTimestamp The exchange timestamp for the last traded price. dateTime
    twelveMnthPct double
    twelveMnthPctDate date
    twentyDayAvgVol double
    unitCode string
    volume The quantity of shares or contracts traded. int
    year Contract year returned for futures. string

    About the Vendor

    From market data feeds to website content solutions and trading software to our flagship financial portal, Barchart.com, and individual subscription services, Barchart is the definitive source for comprehensive financial data and information.