getQuote API

getQuote

The getQuote API is used to request price data, either real-time, delayed or end-of-day, by symbol on stocks, indexes, mutual funds, ETFs, futures, foreign exchange, or cryptocurrencies.

View All APIs

First Name^*

Last Name^*

Email Address^*

Phone^*

Company^*

Role^*

Industry^*

Country^*

Comments/Questions^*

By submitting this form you are opting in to receive email communications from Barchart for related product, service or company information, updates and announcements. You can unsubscribe at anytime. View our Privacy Policy.

Inputs

symbols^required

A symbol or code that identifies a financial instrument. Multiple symbols separated by a comma may be used. For futures, notation such as for the active contract or for the first nearby is supported, as is for all futures contracts for a given root symbol, as is for all options contracts for a given underlying futures symbol.

Type

list (A comma or semi-colon delimited string.)

Example

AAPL,GOOG

fields^optional

The fields requested.

Type

list (A comma or semi-colon delimited string.)

Example

fiftyTwoWkHigh,fiftyTwoWkHighDate,fiftyTwoWkLow,fiftyTwoWkLowDate

only^optional

Returns only specified fields

Type

list (A comma or semi-colon delimited string.)

Example

symbol,name

Outputs

symbol
always returned

A symbol or code that identifies a financial instrument.

string
A sequence of characters. (example: GOOG)

exchange
always returned

Exchange code for the marketplace where the financial instruments are listed.

string
A sequence of characters. (example: GOOG)

name
always returned

The type of symbol used.

string
A sequence of characters. (example: GOOG)

dayCode
always returned

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
A sequence of characters. (example: GOOG)

serverTimestamp
always returned

The time the message was generated on the server.

dateTime
A date and time in the format of YYYY-MM-DD HH:MI:SS<TIMEZONE_OFFSET>.

mode
always returned

An indicator representing if the quote is real-time ("R"), delayed ("I") or end-of-day ("D").

string
A sequence of characters. (example: GOOG)

lastPrice
always returned

The last price the instrument traded.

double
A numeric type defining a number with fractional parts. (example: 2.14)

tradeSize
as requested

The size of the last traded price / transaction.

int
A numeric type defining a whole number. (example: 2)

tradeTimestamp
always returned

The exchange timestamp for the last traded price.

dateTime
A date and time in the format of YYYY-MM-DD HH:MI:SS<TIMEZONE_OFFSET>.

netChange
always returned

The difference between the last traded price and the previous close.

double
A numeric type defining a number with fractional parts. (example: 2.14)

percentChange
always returned

The percent difference between the last traded price and the previous close.

double
A numeric type defining a number with fractional parts. (example: 2.14)

tick
as requested

An indicator representing whether the last traded price was up ("+"), the same (".") or below ("-") the previous last price.

string
A sequence of characters. (example: GOOG)

previousLastPrice
as requested

The price previous to the current last price.

double
A numeric type defining a number with fractional parts. (example: 2.14)

previousTimestamp
as requested

The exchange timestamp of the previous last price.

date
A date in the format of YYYY-MM-DD.

bid
as requested

The current bid price.

double
A numeric type defining a number with fractional parts. (example: 2.14)

bidSize
as requested

The size (quantity) of the current bid price.

int
A numeric type defining a whole number. (example: 2)

ask
as requested

The current ask price.

double
A numeric type defining a number with fractional parts. (example: 2.14)

askSize
as requested

The size (quantity) of the current ask price.

int
A numeric type defining a whole number. (example: 2)

unitCode
always returned

N/A

string
A sequence of characters. (example: GOOG)

open
always returned

The opening (first) price for the session.

double
A numeric type defining a number with fractional parts. (example: 2.14)

high
always returned

The highest traded price for the session.

double
A numeric type defining a number with fractional parts. (example: 2.14)

low
always returned

The lowest traded price for the session.

double
A numeric type defining a number with fractional parts. (example: 2.14)

close
always returned

The last traded price for the session.

double
A numeric type defining a number with fractional parts. (example: 2.14)

flag
always returned

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
A sequence of characters. (example: GOOG)

previousClose
as requested

The last traded price for the previous session.

double
A numeric type defining a number with fractional parts. (example: 2.14)

settlement
as requested

The settlement price determined the exchange.

double
A numeric type defining a number with fractional parts. (example: 2.14)

previousSettlement
as requested

The settlement price for the previous session.

double
A numeric type defining a number with fractional parts. (example: 2.14)

volume
always returned

The quantity of shares or contracts traded.

int
A numeric type defining a whole number. (example: 2)

openInterest
as requested

The quantity of open interest for futures.

double
A numeric type defining a number with fractional parts. (example: 2.14)

fiftyTwoWkHigh
as requested

The highest price over the past 52 weeks.

double
A numeric type defining a number with fractional parts. (example: 2.14)

fiftyTwoWkHighDate
as requested

The date in which the high price was reached over the past 52 weeks.

date
A date in the format of YYYY-MM-DD.

fiftyTwoWkLow
as requested

The low price over the past 52 weeks.

double
A numeric type defining a number with fractional parts. (example: 2.14)

fiftyTwoWkLowDate
as requested

The date in which the low price was reached over the past 52 weeks.

date
A date in the format of YYYY-MM-DD.

avgVolume
as requested

The average daily volume.

int
A numeric type defining a whole number. (example: 2)

impliedVolatility
as requested

N/A

double
A numeric type defining a number with fractional parts. (example: 2.14)

twentyDayAvgVol
as requested

N/A

int
A numeric type defining a whole number. (example: 2)

month
as requested

Contract month returned for futures.

string
A sequence of characters. (example: GOOG)

year
as requested

Contract year returned for futures.

string
A sequence of characters. (example: GOOG)

expirationDate
as requested

The expiration date for the futures contract. Only returns a value for futures.

date
A date in the format of YYYY-MM-DD.

lastTradingDay
as requested

The last trading day of the futures contract. Only returns a value for futures.

string
A sequence of characters. (example: GOOG)

twelveMnthPct
as requested

N/A

double
A numeric type defining a number with fractional parts. (example: 2.14)

twelveMnthPctDate
as requested

N/A

date
A date in the format of YYYY-MM-DD.

Status Code Responses

200

Success

400

Bad Request

The request was invalid, please see the message for more information.

500

Internal Server Error

Something is not working correctly, please contact support.

JSON

GET

GET https://marketdata.websol.barchart.com/getQuote.json?apikey=YOUR_API_KEY&symbols=AAPL%2CGOOG&fields=fiftyTwoWkHigh%2CfiftyTwoWkHighDate%2CfiftyTwoWkLow%2CfiftyTwoWkLowDate
Host: marketdata.websol.barchart.com

POST

POST https://marketdata.websol.barchart.com/getQuote.json
Host: marketdata.websol.barchart.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length

apikey=YOUR_API_KEY&symbols=AAPL%2CGOOG&fields=fiftyTwoWkHigh%2CfiftyTwoWkHighDate%2CfiftyTwoWkLow%2CfiftyTwoWkLowDate

Response

{
    "status": {
        "code": 200,
        "message": "Success."
    },
    "results": [
        {
            "symbol": "AAPL",
            "name": "Apple Inc",
            "dayCode": "M",
            "serverTimestamp": "2020-11-23T14:43:32-06:00",
            "mode": "i",
            "lastPrice": 114.06,
            "tradeTimestamp": "2020-11-23T15:28:32-06:00",
            "netChange": -3.280000000000001,
            "percentChange": -2.8,
            "unitCode": "2",
            "open": 117.18,
            "high": 117.62,
            "low": 113.8,
            "close": null,
            "numTrades": 863685,
            "dollarVolume": 11884408114.9661,
            "flag": "",
            "volume": 103095086,
            "previousVolume": 73604195,
            "fiftyTwoWkHigh": 137.98,
            "fiftyTwoWkHighDate": "2020-09-02",
            "fiftyTwoWkLow": 53.15,
            "fiftyTwoWkLowDate": "2020-03-23"
        },
        {
            "symbol": "GOOG",
            "name": "Alphabet Cl C",
            "dayCode": "M",
            "serverTimestamp": "2020-11-23T14:43:29-06:00",
            "mode": "i",
            "lastPrice": 1737.5,
            "tradeTimestamp": "2020-11-23T15:28:22-06:00",
            "netChange": -4.690000000000055,
            "percentChange": -0.27,
            "unitCode": "2",
            "open": 1749.6,
            "high": 1753.9,
            "low": 1717.72,
            "close": null,
            "numTrades": 42071,
            "dollarVolume": 2979295117.8689,
            "flag": "",
            "volume": 1575835,
            "previousVolume": 2313600,
            "fiftyTwoWkHigh": 1818.06,
            "fiftyTwoWkHighDate": "2020-11-09",
            "fiftyTwoWkLow": 1013.54,
            "fiftyTwoWkLowDate": "2020-03-23"
        }
    ]
}

XML

GET

GET https://marketdata.websol.barchart.com/getQuote.xml?apikey=YOUR_API_KEY&symbols=AAPL%2CGOOG&fields=fiftyTwoWkHigh%2CfiftyTwoWkHighDate%2CfiftyTwoWkLow%2CfiftyTwoWkLowDate
Host: marketdata.websol.barchart.com

POST

POST https://marketdata.websol.barchart.com/getQuote.xml
Host: marketdata.websol.barchart.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length

apikey=YOUR_API_KEY&symbols=AAPL%2CGOOG&fields=fiftyTwoWkHigh%2CfiftyTwoWkHighDate%2CfiftyTwoWkLow%2CfiftyTwoWkLowDate

Response


<?xml version="1.0" encoding="utf-8"?>
 <getQuote>
  <status>
   <code>200</code>
   <message>Success.</message>
  </status>
  <item>
   <symbol>AAPL</symbol>
   <name>Apple Inc</name>
   <dayCode>M</dayCode>
   <serverTimestamp>2020-11-23T14:43:32-06:00</serverTimestamp>
   <mode>i</mode>
   <lastPrice>114.06</lastPrice>
   <tradeTimestamp>2020-11-23T15:28:32-06:00</tradeTimestamp>
   <netChange>-3.28</netChange>
   <percentChange>-2.8</percentChange>
   <unitCode>2</unitCode>
   <open>117.18</open>
   <high>117.62</high>
   <low>113.8</low>
   <close></close>
   <numTrades>863685</numTrades>
   <dollarVolume>11884408114.966</dollarVolume>
   <flag></flag>
   <volume>103095486</volume>
   <previousVolume>73604195</previousVolume>
   <fiftyTwoWkHigh>137.98</fiftyTwoWkHigh>
   <fiftyTwoWkHighDate>2020-09-02</fiftyTwoWkHighDate>
   <fiftyTwoWkLow>53.15</fiftyTwoWkLow>
   <fiftyTwoWkLowDate>2020-03-23</fiftyTwoWkLowDate>
  </item>
  <item>
   <symbol>GOOG</symbol>
   <name>Alphabet Cl C</name>
   <dayCode>M</dayCode>
   <serverTimestamp>2020-11-23T14:43:32-06:00</serverTimestamp>
   <mode>i</mode>
   <lastPrice>1737.5</lastPrice>
   <tradeTimestamp>2020-11-23T15:28:22-06:00</tradeTimestamp>
   <netChange>-4.6900000000001</netChange>
   <percentChange>-0.27</percentChange>
   <unitCode>2</unitCode>
   <open>1749.6</open>
   <high>1753.9</high>
   <low>1717.72</low>
   <close></close>
   <numTrades>42071</numTrades>
   <dollarVolume>2979295117.8689</dollarVolume>
   <flag></flag>
   <volume>1575840</volume>
   <previousVolume>2313600</previousVolume>
   <fiftyTwoWkHigh>1818.06</fiftyTwoWkHigh>
   <fiftyTwoWkHighDate>2020-11-09</fiftyTwoWkHighDate>
   <fiftyTwoWkLow>1013.54</fiftyTwoWkLow>
   <fiftyTwoWkLowDate>2020-03-23</fiftyTwoWkLowDate>
  </item>
 </getQuote>

CSV

GET

GET https://marketdata.websol.barchart.com/getQuote.csv?apikey=YOUR_API_KEY&symbols=AAPL%2CGOOG&fields=fiftyTwoWkHigh%2CfiftyTwoWkHighDate%2CfiftyTwoWkLow%2CfiftyTwoWkLowDate
Host: marketdata.websol.barchart.com

POST

POST https://marketdata.websol.barchart.com/getQuote.csv
Host: marketdata.websol.barchart.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length

apikey=YOUR_API_KEY&symbols=AAPL%2CGOOG&fields=fiftyTwoWkHigh%2CfiftyTwoWkHighDate%2CfiftyTwoWkLow%2CfiftyTwoWkLowDate

Response

symbol,name,dayCode,serverTimestamp,mode,lastPrice,tradeTimestamp,netChange,percentChange,unitCode,open,high,low,close,numTrades,dollarVolume,flag,volume,previousVolume,fiftyTwoWkHigh,fiftyTwoWkHighDate,fiftyTwoWkLow,fiftyTwoWkLowDate
"AAPL","Apple Inc","M","2020-11-23T14:43:32-06:00","i","114.06","2020-11-23T15:28:32-06:00","-3.28","-2.8","2","117.18","117.62","113.8","","863685","11884408114.966","","103095486","73604195","137.98","2020-09-02","53.15","2020-03-23"
"GOOG","Alphabet Cl C","M","2020-11-23T14:43:32-06:00","i","1737.5","2020-11-23T15:28:22-06:00","-4.6900000000001","-0.27","2","1749.6","1753.9","1717.72","","42071","2979295117.8689","","1575840","2313600","1818.06","2020-11-09","1013.54","2020-03-23"

PHP

<?php

$ondemand = new SoapClient('https://marketdata.websol.barchart.com/service?wsdl');

$params = [
    'apikey' => 'YOUR_API_KEY',
    'symbols' => 'AAPL,GOOG',
    'fields' => 'fiftyTwoWkHigh,fiftyTwoWkHighDate,fiftyTwoWkLow,fiftyTwoWkLowDate',
];

$result = $ondemand->getQuote($params);
var_dump($result);

Classic ASP

Dim ondemand
Dim result

Set ondemand = Server.CreateObject("MSSOAP.SoapClient30")
ondemand.ClientProperty("ServerHTTPRequest") = True
ondemand.MSSoapInit("https://marketdata.websol.barchart.com/service?wsdl")

Set result = ondemand.getQuote("YOUR_API_KEY", "AAPL,GOOG", "fiftyTwoWkHigh,fiftyTwoWkHighDate,fiftyTwoWkLow,fiftyTwoWkLowDate")

Perl

use SOAP::Lite;
use SOAP::WSDL;

my $ondemand = SOAP::Lite
    -> service('https://marketdata.websol.barchart.com/service?wsdl');

my $result = $ondemand->getQuote('YOUR_API_KEY', 'AAPL,GOOG', 'fiftyTwoWkHigh,fiftyTwoWkHighDate,fiftyTwoWkLow,fiftyTwoWkLowDate');

print $result;

Python

from suds.client import Client
ondemand = Client('https://marketdata.websol.barchart.com/service?wsdl')

result = client.service.getQuote('YOUR_API_KEY', 'AAPL,GOOG', 'fiftyTwoWkHigh,fiftyTwoWkHighDate,fiftyTwoWkLow,fiftyTwoWkLowDate')

print result

Ruby

require 'savon'

ondemand = Savon.client(wsdl: 'https://marketdata.websol.barchart.com/service?wsdl')

response = ondemand.call(
    :getQuote,
    message: {
        apikey: 'YOUR_API_KEY',
        symbols: 'AAPL,GOOG',
        fields: 'fiftyTwoWkHigh,fiftyTwoWkHighDate,fiftyTwoWkLow,fiftyTwoWkLowDate',
    }
)

response.body