barchart.com APIbarchart.com ↗
Access Barchart market data via API: stock quotes, options chains with Greeks, gamma exposure, historical OHLCV, top stocks by weighted alpha, and futures prices.
curl -X GET 'https://api.parse.bot/scraper/1cda4487-4915-4e6a-b0de-627d66a03c5a/get_stock_quotes?symbols=AAPL%2CMSFT%2CSPY' \ -H 'X-API-Key: $PARSE_API_KEY'
Get current quotes for a list of stock symbols. Returns real-time price data including last price, price change, percent change, and symbol metadata.
| Param | Type | Description |
|---|---|---|
| symbolsrequired | string | Comma-separated list of stock or ETF symbols (e.g. 'AAPL,MSFT,SPY') |
{
"type": "object",
"fields": {
"data": "array of quote objects with symbol, symbolName, lastPrice, priceChange, percentChange, symbolCode, symbolType, and raw numeric values",
"count": "integer total items returned",
"total": "integer total items available"
},
"sample": {
"data": {
"data": [
{
"raw": {
"symbol": "AMD",
"lastPrice": 449.7,
"symbolCode": "STK",
"symbolName": "Adv Micro Devices",
"symbolType": 1,
"priceChange": 4.2,
"percentChange": 0.0094
},
"symbol": "AMD",
"lastPrice": "449.70",
"symbolCode": "STK",
"symbolName": "Adv Micro Devices",
"symbolType": 1,
"priceChange": "+4.20",
"percentChange": "+0.94%"
}
],
"count": 2,
"total": 2,
"errors": null
},
"status": "success"
}
}About the barchart.com API
The Barchart API exposes 6 endpoints covering equities, options, and futures market data from Barchart.com. You can retrieve real-time stock quotes with price change and percent change fields, full options chains including Greeks and open interest via get_options_chain, gamma exposure grouped by strike price, daily and 5-minute OHLCV history, ranked top stocks by weighted alpha, and full futures contract ladders for roots like CL, GC, and ES.
Quotes, Options, and Greeks
The get_stock_quotes endpoint accepts a comma-separated symbols parameter (e.g. AAPL,MSFT,SPY) and returns per-symbol objects containing lastPrice, priceChange, percentChange, symbolName, symbolCode, and symbolType. The response also includes count and total integers for pagination awareness. The get_options_chain endpoint takes a required symbol and an optional expiration date in YYYY-MM-DD format; omitting the date defaults to the nearest available expiration. Each contract in the returned array includes strikePrice, expirationDate, bidPrice, askPrice, volume, openInterest, and symbolType distinguishing calls from puts.
Gamma Exposure and Historical Data
get_gamma_exposure returns a nested structure keyed by strike price, where each key maps to an array of option contracts carrying gamma, delta, openInterest, lastPrice, and symbolType. This layout makes it straightforward to aggregate net gamma across strikes. The get_historical_data endpoint supports both daily and 5min intervals via the interval parameter and a max_records cap. Each OHLCV candle object includes date, open, high, low, close, and volume as strings. The symbol field accepts standard equity tickers as well as futures notation like GC*0 for front-month Gold.
Top Stocks and Futures
get_top_stocks requires no input and returns a ranked list of equities sorted by weightedAlpha, alongside percentChange1y for year-over-year context. The get_futures_prices endpoint takes a required root_symbol (e.g. CL, GC, ES) and an optional timeframe. Each contract in the contracts array includes contractName, lastPrice, priceChange, percentChange, settlementPrice, volume, openInterest, and high/low prices. The response also returns the cleaned rootSymbol string and a totalContracts count.
- Build a multi-symbol watchlist dashboard using
get_stock_quoteswith livelastPriceandpercentChangefields - Construct options flow scanners by pulling full chains via
get_options_chainand filtering byvolumeoropenInterest - Visualize net gamma exposure by strike for SPY or AAPL using
get_gamma_exposuredelta and gamma fields - Backtest trading strategies by loading daily or 5-minute OHLCV series from
get_historical_datawith amax_recordslimit - Screen for momentum stocks by ranking
weightedAlphaandpercentChange1ydata fromget_top_stocks - Track full futures contract ladders for crude oil or gold using
get_futures_priceswith roots like CL or GC - Monitor settlement prices and open interest shifts across futures expirations using the
settlementPriceandopenInterestfields
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Barchart have an official developer API?+
What does `get_options_chain` return, and how do I target a specific expiration?+
strikePrice, expirationDate, bidPrice, askPrice, volume, openInterest, and symbolType (call or put). Pass a date string in YYYY-MM-DD format as the expiration parameter to target a specific expiration. Omitting it defaults to the nearest available date.Does the historical data endpoint support intraday intervals other than 5 minutes?+
get_historical_data supports daily and 5min as the two available interval values. Other intraday resolutions such as 1-minute or hourly bars are not exposed. You can fork this API on Parse and revise it to add endpoints for additional intervals if your use case requires them.Does the API cover earnings estimates, analyst ratings, or fundamental data for stocks?+
How fresh is the quote data returned by `get_stock_quotes`?+
get_stock_quotes endpoint returns current quote data reflecting Barchart's live feed, but Barchart's own display rules apply delays (typically 15–20 minutes for non-subscribers on US equities). Real-time values depend on the data entitlements associated with the underlying source. The response fields lastPrice, priceChange, and percentChange reflect whatever the current feed provides.