Skip to main content

Market Data API

Operations (36)

alpaca.marketData.stocks — StockApi​

US-equity bars, trades, quotes, auctions and snapshots.

alpaca.marketData.stocks.stockBars​

Historical bars for one or more stocks (paginated).

await alpaca.marketData.stocks.stockBars({
symbols: "AAPL,MSFT",
timeframe: TimeFrame.Day,
start: new Date("2024-01-01"),
});
alpaca.marketData.stocks.stockTrades​

Historical trades for one or more stocks (paginated).

await alpaca.marketData.stocks.stockTrades({
symbols: "AAPL",
start: new Date("2024-01-02"),
});
alpaca.marketData.stocks.stockQuotes​

Historical quotes for one or more stocks (paginated).

await alpaca.marketData.stocks.stockQuotes({
symbols: "AAPL",
start: new Date("2024-01-02"),
});
alpaca.marketData.stocks.stockAuctions​

Historical opening/closing auctions for stocks (paginated).

await alpaca.marketData.stocks.stockAuctions({
symbols: "AAPL",
start: new Date("2024-01-02"),
});
alpaca.marketData.stocks.stockSnapshots​

Latest snapshot (trade, quote, bars) for one or more stocks.

await alpaca.marketData.stocks.stockSnapshots({ symbols: "AAPL,MSFT" });
alpaca.marketData.stocks.stockLatestBars​

Latest minute bar for one or more stocks.

await alpaca.marketData.stocks.stockLatestBars({ symbols: "AAPL,MSFT" });
alpaca.marketData.stocks.stockLatestQuotes​

Latest quote for one or more stocks.

await alpaca.marketData.stocks.stockLatestQuotes({ symbols: "AAPL,MSFT" });
alpaca.marketData.stocks.stockLatestTrades​

Latest trade for one or more stocks.

await alpaca.marketData.stocks.stockLatestTrades({ symbols: "AAPL,MSFT" });
alpaca.marketData.stocks.stockMetaConditions​

Trade/quote condition-code mappings for a tape.

await alpaca.marketData.stocks.stockMetaConditions({
ticktype: "trade",
tape: "A",
});
alpaca.marketData.stocks.stockMetaExchanges​

Exchange-code mappings.

await alpaca.marketData.stocks.stockMetaExchanges();

alpaca.marketData.crypto — CryptoApi​

Crypto bars, trades, quotes, orderbooks and snapshots.

alpaca.marketData.crypto.cryptoBars​

Historical crypto bars (paginated); loc selects the data region.

await alpaca.marketData.crypto.cryptoBars({
loc: "us",
symbols: "BTC/USD,ETH/USD",
timeframe: TimeFrame.Day,
start: new Date("2024-01-01"),
});
alpaca.marketData.crypto.cryptoTrades​

Historical crypto trades (paginated).

await alpaca.marketData.crypto.cryptoTrades({
loc: "us",
symbols: "BTC/USD",
start: new Date("2024-01-02"),
});
alpaca.marketData.crypto.cryptoQuotes​

Historical crypto quotes (paginated).

await alpaca.marketData.crypto.cryptoQuotes({
loc: "us",
symbols: "BTC/USD",
start: new Date("2024-01-02"),
});
alpaca.marketData.crypto.cryptoSnapshots​

Latest snapshot for one or more crypto pairs.

await alpaca.marketData.crypto.cryptoSnapshots({
loc: "us",
symbols: "BTC/USD,ETH/USD",
});
alpaca.marketData.crypto.cryptoLatestBars​

Latest bar for one or more crypto pairs.

await alpaca.marketData.crypto.cryptoLatestBars({
loc: "us",
symbols: "BTC/USD",
});
alpaca.marketData.crypto.cryptoLatestQuotes​

Latest quote for one or more crypto pairs.

await alpaca.marketData.crypto.cryptoLatestQuotes({
loc: "us",
symbols: "BTC/USD",
});
alpaca.marketData.crypto.cryptoLatestTrades​

Latest trade for one or more crypto pairs.

await alpaca.marketData.crypto.cryptoLatestTrades({
loc: "us",
symbols: "BTC/USD",
});
alpaca.marketData.crypto.cryptoLatestOrderbooks​

Latest order book for one or more crypto pairs.

await alpaca.marketData.crypto.cryptoLatestOrderbooks({
loc: "us",
symbols: "BTC/USD",
});

alpaca.marketData.fixedIncome — FixedIncomeApi​

Fixed-income latest prices and quotes.

alpaca.marketData.fixedIncome.fixedIncomeLatestPrices​

Latest fixed-income prices by ISIN.

await alpaca.marketData.fixedIncome.fixedIncomeLatestPrices({
isins: "US0378331005",
});
alpaca.marketData.fixedIncome.fixedIncomeLatestQuotes​

Latest fixed-income quotes by ISIN.

await alpaca.marketData.fixedIncome.fixedIncomeLatestQuotes({
isins: "US0378331005",
tradeSize: 100,
});

alpaca.marketData.forex — ForexApi​

Foreign-exchange historical and latest rates.

alpaca.marketData.forex.rates​

Historical forex rates for currency pairs (paginated).

await alpaca.marketData.forex.rates({
currencyPairs: "EUR/USD",
timeframe: TimeFrame.Day,
start: new Date("2024-01-01"),
});
alpaca.marketData.forex.latestRates​

Latest forex rates for one or more currency pairs.

await alpaca.marketData.forex.latestRates({
currencyPairs: "EUR/USD,GBP/USD",
});

alpaca.marketData.logos — LogosApi​

Company logo images.

alpaca.marketData.logos.logos​

Company logo image bytes for a symbol.

await alpaca.marketData.logos.logos({ symbol: "AAPL" });

alpaca.marketData.news — NewsApi​

Market news articles.

alpaca.marketData.news.news​

Latest news articles across stocks and crypto (paginated).

await alpaca.marketData.news.news({ symbols: "AAPL,TSLA", limit: 10 });

alpaca.marketData.options — OptionApi​

Options bars, trades, chains and snapshots.

alpaca.marketData.options.optionBars​

Historical option bars (paginated).

await alpaca.marketData.options.optionBars({
symbols: "AAPL250117C00150000",
timeframe: TimeFrame.Day,
start: new Date("2024-01-01"),
});
alpaca.marketData.options.optionTrades​

Historical option trades (paginated).

await alpaca.marketData.options.optionTrades({
symbols: "AAPL250117C00150000",
start: new Date("2024-01-02"),
});
alpaca.marketData.options.optionChain​

Snapshots for an underlying's full option chain (paginated).

await alpaca.marketData.options.optionChain({
underlyingSymbol: "AAPL",
type: "call",
});
alpaca.marketData.options.optionSnapshots​

Latest snapshots for one or more option contracts.

await alpaca.marketData.options.optionSnapshots({
symbols: "AAPL250117C00150000",
});
alpaca.marketData.options.optionLatestQuotes​

Latest quotes for one or more option contracts.

await alpaca.marketData.options.optionLatestQuotes({
symbols: "AAPL250117C00150000",
});
alpaca.marketData.options.optionLatestTrades​

Latest trades for one or more option contracts.

await alpaca.marketData.options.optionLatestTrades({
symbols: "AAPL250117C00150000",
});
alpaca.marketData.options.optionMetaConditions​

Option trade/quote condition-code mappings.

await alpaca.marketData.options.optionMetaConditions({ ticktype: "trade" });
alpaca.marketData.options.optionMetaExchanges​

Option exchange-code mappings.

await alpaca.marketData.options.optionMetaExchanges();

alpaca.marketData.screener — ScreenerApi​

Market movers and most-active screeners.

alpaca.marketData.screener.mostActives​

Most-active stocks by volume or trade count.

await alpaca.marketData.screener.mostActives({ by: "volume", top: 10 });
alpaca.marketData.screener.movers​

Top market gainers and losers.

await alpaca.marketData.screener.movers({ marketType: "stocks", top: 10 });

alpaca.marketData.corporateActions — CorporateActionsApi​

Historical corporate actions and typed, resumable async SSE updates.

alpaca.marketData.corporateActions.corporateActions​

Historical corporate-action data by symbol and type (paginated).

await alpaca.marketData.corporateActions.corporateActions({
symbols: "AAPL",
types: "cash_dividend",
start: new Date("2024-01-01"),
});
alpaca.marketData.corporateActions.subscribeToCorporateActionsEventsSSE​

Typed async stream of corporate-action mutations; close it or abort its signal when done.

const events = await alpaca.marketData.corporateActions.subscribeToCorporateActionsEventsSSE({ region: "us" });
try {
for await (const event of events) console.log(event.action, event.ca);
} finally {
events.close();
}