getQuote
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.