Bulk Quotes

Get a real-time price quote for a multiple stocks in a single API request.

tip

The bulkquotes endpoint is designed to return hundreds of symbols at once or full market snapshots. Response times for less than 50 symbols will be quicker using the standard quotes endpoint and sending your requests in parallel.

Endpoint

https://api.marketdata.app/v1/stocks/bulkquotes/

Method

GET

Request Example

HTTP

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

NodeJS

app.js

fetch("https://api.marketdata.app/v1/stocks/bulkquotes/?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/bulkquotes/?symbols=AAPL,META,MSFT"
response = requests.request("GET", url)

print(response.text)

Go

bulkStockQuotes.go

import (
  "fmt"

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

func ExampleBulkStockQuotesRequest() {
	symbols := []string{"AAPL", "META", "MSFT"}
	quotes, err := BulkStockQuotes().Symbols(symbols).Get()
	if err != nil {
		fmt.Print(err)
		return
	}
  
	for _, quote := range quotes {
		fmt.Println(quote)
	}
}

Response Example

{
    "s": "ok",
    "symbol": ["AAPL", "META", "MSFT"],
    "ask": [187.67, 396.9, 407.0],
    "askSize": [1, 6, 1],
    "bid": [187.65, 396.8, 406.97],
    "bidSize": [1, 3, 3],
    "mid": [187.66, 396.85, 406.985],
    "last": [187.65, 396.85, 407.0],
    "change": [-4.079999999999984, -4.169999999999959, -2.7200000000000273],
    "changepct": [-0.021279924894382643, -0.010398483866141239, -0.006638680074197078],
    "volume": [55299411, 18344385, 29269513],
    "updated": [1706650085, 1706650085, 1706650085]
}

Request Parameters

Required

• 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 a full market snapshot with quotes for all symbols when set to true. The symbols parameter may be omitted if the snapshot parameter is set.

Response Attributes

Success

• s string

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

• symbol array[string]

  The symbol of the stock.

• ask array[number]

  The ask price of the stock.

• askSize array[number]

  The number of shares offered at the ask price.

• bid array[number]

  The bid price.

• bidSize array[number]

  The number of shares that may be sold at the bid price.

• mid array[number]

  The midpoint price between the ask and the bid.

• last array[number]

  The last price the stock traded at.

• change array[number]

  The difference in price in dollars (or the security's currency if different from dollars) compared to the closing price of the previous day.

• changepct array[number]

  The difference in price in percent compared to the closing price of the previous day.

• 52weekHigh array[number]

  The 52-week high for the stock. This parameter is omitted unless the optional 52week request parameter is set to true.

• 52weekLow array[number]

  The 52-week low for the stock. This parameter is omitted unless the optional 52week request parameter is set to true.

• volume array[number]

  The number of shares traded during the current session.

• updated array[date]

  The date/time of the current stock quote.

No Data

• s string

  Status will be no_data if no quote can be found for the symbol.

Error

• s string

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

• errmsg string

  An error message.

Notes

• The bulkquotes endpoint will consume one request for each symbol returned in the response.