© 2018 Barchart.com, Inc. | Terms of Use & Privacy Policy
209 W. Jackson, 2nd Floor | Chicago, IL 60606
The getQuote API is used to request price data, either real-time, delayed or end-of-day, by symbol. In addition to Last Price or Settlement, other fields such as Open, High, Low, Close, Bid, Ask, 52-week high and low, and more are available.
All APIsEasily run calculations on delayed BATS data with the simplicity of Microsoft Excel
getQuote into Excel getHistory into ExcelA symbol or code that identifies a financial instrument. Multiple symbols separated by a comma may be used. For futures, notation such as <root_symbol*0> for the active contract or <root_symbol*1> for the first nearby is supported, as is <root_symbol^F> for all futures contracts for a given root symbol.
The fields requested.
Returns only specified fields
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": "O",
"serverTimestamp": "2018-05-25T13:07:11-05:00",
"mode": "i",
"lastPrice": 189.15,
"tradeTimestamp": "2018-05-25T13:52:08-05:00",
"netChange": 1,
"percentChange": 0.53,
"unitCode": "2",
"open": 188.23,
"high": 189.65,
"low": 187.65,
"close": 0,
"numTrades": 52385,
"dollarVolume": 1858177099.457,
"flag": "",
"volume": 11072000,
"previousVolume": 23230301,
"fiftyTwoWkHigh": 190.37,
"fiftyTwoWkHighDate": "2018-05-10",
"fiftyTwoWkLow": 142.2,
"fiftyTwoWkLowDate": "2017-06-16"
},
{
"symbol": "GOOG",
"name": "Alphabet Class C",
"dayCode": "O",
"serverTimestamp": "2018-05-25T13:07:08-05:00",
"mode": "i",
"lastPrice": 1076.92,
"tradeTimestamp": "2018-05-25T13:52:04-05:00",
"netChange": -2.3199999999999,
"percentChange": -0.21,
"unitCode": "2",
"open": 1079.02,
"high": 1082.56,
"low": 1075.93,
"close": 0,
"numTrades": 1967,
"dollarVolume": 292532711.9219,
"flag": "",
"volume": 474987,
"previousVolume": 766400,
"fiftyTwoWkHigh": 1186.89,
"fiftyTwoWkHighDate": "2018-01-29",
"fiftyTwoWkLow": 894.79,
"fiftyTwoWkLowDate": "2017-07-03"
}
]
}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>
O</dayCode>
<serverTimestamp>
2018-05-25T13:07:11-05:00</serverTimestamp>
<mode>
i</mode>
<lastPrice>
189.15</lastPrice>
<tradeTimestamp>
2018-05-25T13:52:08-05:00</tradeTimestamp>
<netChange>
1</netChange>
<percentChange>
0.53</percentChange>
<unitCode>
2</unitCode>
<open>
188.23</open>
<high>
189.65</high>
<low>
187.65</low>
<close>
0</close>
<numTrades>
52385</numTrades>
<dollarVolume>
1858177099.457</dollarVolume>
<flag></flag>
<volume>
11072000</volume>
<previousVolume>
23230301</previousVolume>
<fiftyTwoWkHigh>
190.37</fiftyTwoWkHigh>
<fiftyTwoWkHighDate>
2018-05-10</fiftyTwoWkHighDate>
<fiftyTwoWkLow>
142.2</fiftyTwoWkLow>
<fiftyTwoWkLowDate>
2017-06-16</fiftyTwoWkLowDate>
</item>
<item>
<symbol>
GOOG</symbol>
<name>
Alphabet Class C</name>
<dayCode>
O</dayCode>
<serverTimestamp>
2018-05-25T13:07:08-05:00</serverTimestamp>
<mode>
i</mode>
<lastPrice>
1076.92</lastPrice>
<tradeTimestamp>
2018-05-25T13:52:04-05:00</tradeTimestamp>
<netChange>
-2.3199999999999</netChange>
<percentChange>
-0.21</percentChange>
<unitCode>
2</unitCode>
<open>
1079.02</open>
<high>
1082.56</high>
<low>
1075.93</low>
<close>
0</close>
<numTrades>
1967</numTrades>
<dollarVolume>
292532711.9219</dollarVolume>
<flag></flag>
<volume>
474987</volume>
<previousVolume>
766400</previousVolume>
<fiftyTwoWkHigh>
1186.89</fiftyTwoWkHigh>
<fiftyTwoWkHighDate>
2018-01-29</fiftyTwoWkHighDate>
<fiftyTwoWkLow>
894.79</fiftyTwoWkLow>
<fiftyTwoWkLowDate>
2017-07-03</fiftyTwoWkLowDate>
</item>
</getQuote>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","O","2018-05-25T13:07:11-05:00","i","189.15","2018-05-25T13:52:08-05:00","1","0.53","2","188.23","189.65","187.65","0","52385","1858177099.457","","11072000","23230301","190.37","2018-05-10","142.2","2017-06-16"
"GOOG","Alphabet Class C","O","2018-05-25T13:07:08-05:00","i","1076.92","2018-05-25T13:52:04-05:00","-2.3199999999999","-0.21","2","1079.02","1082.56","1075.93","0","1967","292532711.9219","","474987","766400","1186.89","2018-01-29","894.79","2017-07-03"
<?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);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")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;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 resultrequire '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.bodyAPI stands for application program interface and is a set of routines, protocols, and tools for building software applications. An API specifies how different pieces of software should interact with one another. Typically, APIs are used when programming graphical user interface components. A good API makes it easier for a developer to program by providing specific building blocks, in Barchart’s case - financial market data.
Barchart’s free market data API only allows for both getQuote and getHistory APIs. Any additional APIs require a paid subscription to Barchart OnDemand. For pricing, please contact solutions@barchart.com
The free market data API includes data from AMEX, NYSE, NASDAQ in end of day frequency. BATS equity and Forex data is included on a 15-minute delay.
No. You are limited to end of day US stocks and futures with the free market data API. To upgrade, please contact solutions@barchart.com.
No. You are limited to end of day US stocks and futures with the free market data API. To upgrade, please contact solutions@barchart.com.
No. You will need to upgrade to Barchart OnDemand in order to receive futures or equity options data. Please contact solutions@barchart.com.
Every user is able to make 2,500 getQuote queries and 1,000 getHistory queries per day.
You can query for XML, JSON, or CSV by changing the extension of the API. See the highlighted section in the API query below.
https://marketdata.websol.barchart.com/getHistory.xml?apikey=YOUR_API_KEY&symbol=IBM&type=daily&startDate=20160608000000
https://marketdata.websol.barchart.com/getHistory.json?apikey=YOUR_API_KEY&symbol=IBM&type=daily&startDate=20160608000000
https://marketdata.websol.barchart.com/getHistory.csv?apikey=YOUR_API_KEY&symbol=IBM&type=daily&startDate=20160608000000
End of day data is updated by 16:45 Central Standard Time.
See: https://www.barchart.com/ondemand/api/getQuote/free. Click on the “Sample Code” button.
First, check to make sure you are using your supplied API key and it is correct. If you are still getting this message it could mean you're connecting to the wrong endpoint.
With the free service, you need to request data from marketdata.websol.barchart.com as opposed to ondemand.websol.barchart.com.
INCORRECT: https://ondemand.websol.barchart.com/getQuote.json?apikey=YOUR_API_KEY&symbols=AAPL
CORRECT: https://marketdata.websol.barchart.com/getQuote.json?apikey=YOUR_API_KEY&symbols=AAPL
Our APIs can be used without us enabling CORS by using JSONP, which can be used to overcome the CORS issue.
Below is sample code of this:
<script src="https://ajax.googleapis.com/ajax/libs/jquery/2.1.4/jquery.min.js"></script>
<script src="https://ajax.googleapis.com/ajax/libs/jqueryui/1.11.4/jquery-ui.min.js"></script>
<script>
var apiResult = document.getElementById("quoteData"),
getQuoteURL = "https://marketdata.websol.barchart.com/getQuote.jsonp";
$.ajax({
method: "POST",
crossDomain: true,
dataType: "jsonp",
url: getQuoteURL,
data: {
"apikey": "YOUR_API_KEY",
"symbols": "IBM"
},
success: function(data) {
var html = "";
for (var k in data.results) {
html += "Symbol: " + data.results[k]['symbol'] + "<br />";
html += "Last: " + data.results[k]['lastPrice'] + "<br />";
html += "Change: " + data.results[k]['netChange'] + "<br />";
html += "Pct. Chg.: " + data.results[k]['percentChange'] + "<br />";
html += "Volume: " + data.results[k]['volume'] + "<br />";
html += "Trade Time: " + data.results[k]['tradeTimestamp'] + "<br /><br />";
}
apiResult.innerHTML = html;
},
error: function() {
console.log('Something went wrong!');
}
});
</script>With getHistory splits and dividends are automatically adjusted into the historical data set. If you would like to remove historical splits and dividends, include the parameters ÷nds=false and &splits=false to the historical data query.
© 2018 Barchart.com, Inc. | Terms of Use & Privacy Policy
209 W. Jackson, 2nd Floor | Chicago, IL 60606