Bulk Candles

Get bulk candle data for stocks. This endpoint returns bulk daily candle data for multiple stocks. Unlike the standard candles endpoint, this endpoint returns a single daily for each symbol provided. The typical use-case for this endpoint is to get a complete market snapshot during trading hours, though it can also be used for bulk snapshots of historical daily candles.

Endpoint

https://api.marketdata.app/v1/stocks/bulkcandles/{resolution}/

Method

GET

Request Example

HTTP

GET https://api.marketdata.app/v1/stocks/bulkcandles/D/?symbols=AAPL,META,MSFT

NodeJS

app.js

fetch(
  "https://api.marketdata.app/v1/stocks/bulkcandles/D/?symbols=AAPL,META,MSFT"
)
  .then((res) => {
    console.log(res);
  })
  .catch((err) => {
    console.log(err);
  });

Python

app.py

import requests

url = "https://api.marketdata.app/v1/stocks/bulkcandles/D/?symbols=AAPL,META,MSFT"
response = requests.request("GET", url)

print(response.text)

Go

bulkStockCandles.go

import (
  "fmt"

  api "github.com/MarketDataApp/sdk-go"
)

func ExampleBulkStockCandlesRequest_get() {
	symbols := []string{"AAPL", "META", "MSFT"}
	candles, err := BulkStockCandles().Resolution("D").Symbols(symbols).Get()
	if err != nil {
		fmt.Print(err)
		return
	}
  
	for _, candle := range candles {
		fmt.Println(candle)
	}
}

Response Example

{
  "s": "ok",
  "symbol": ["AAPL", "META", "MSFT"],
  "o": [196.16, 345.58, 371.49],
  "h": [196.95, 353.6, 373.26],
  "l": [195.89, 345.12, 369.84],
  "c": [196.94, 350.36, 373.26],
  "v": [40714051, 17729362, 20593658],
  "t": [1703048400,1703048400,1703048400]
}

Request Parameters

Required

• resolution string The duration of each candle. Only daily candles are supported at this time.

  • Daily Resolutions: (daily, D, 1D)

• symbols string The ticker symbols to return in the response, separated by commas. The symbols parameter may be omitted if the snapshot parameter is set to true.

Optional

• snapshot boolean Returns candles for all available symbols for the date indicated. The symbols parameter can be omitted if snapshot is set to true.

• date date The date of the candles to be returned. If no date is specified, during market hours the candles returned will be from the current session. If the market is closed the candles will be from the most recent session. Accepted date inputs: ISO 8601, unix, spreadsheet.

• adjustsplits boolean Adjust historical data for for historical splits and reverse splits. Market Data uses the CRSP methodology for adjustment. Daily candles default: true.

Response Attributes

Success

• s string

  Will always be ok when there is data for the candles requested.

• symbol string

  The ticker symbol of the stock.

• o array[number]

  Open price.

• h array[number]

  High price.

• l array[number]

  Low price.

• c array[number]

  Close price.

• v array[number]

  Volume.

• t array[number]

  Candle time (Unix timestamp, Exchange Timezone). Daily candles are returned at 00:00:00 without times.

No Data

• s string

  Status will be no_data if no candles are found for the request.

Error

• s string

  Status will be error if the request produces an error response.

• errmsg string

  An error message.

Notes

• The stocks/bulkcandles endpoint will consume one API credit for each symbol returned in the response.