Skip to main content

Market Data API

Operations (42)

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: "1Day",
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: "1Day",
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.cryptoPerpetualFutures — CryptoPerpetualFuturesApi

Crypto perpetual-futures latest market data.

alpaca.marketData.cryptoPerpetualFutures.cryptoPerpLatestBars

Latest bar for one or more crypto perpetual-futures contracts.

await alpaca.marketData.cryptoPerpetualFutures.cryptoPerpLatestBars({
loc: "global",
symbols: "BTC-PERP",
});
alpaca.marketData.cryptoPerpetualFutures.cryptoPerpLatestQuotes

Latest quote for one or more perpetual-futures contracts.

await alpaca.marketData.cryptoPerpetualFutures.cryptoPerpLatestQuotes({
loc: "global",
symbols: "BTC-PERP",
});
alpaca.marketData.cryptoPerpetualFutures.cryptoPerpLatestTrades

Latest trade for one or more perpetual-futures contracts.

await alpaca.marketData.cryptoPerpetualFutures.cryptoPerpLatestTrades({
loc: "global",
symbols: "BTC-PERP",
});
alpaca.marketData.cryptoPerpetualFutures.cryptoPerpLatestOrderbooks

Latest order book for one or more perpetual-futures contracts.

await alpaca.marketData.cryptoPerpetualFutures.cryptoPerpLatestOrderbooks({
loc: "global",
symbols: "BTC-PERP",
});
alpaca.marketData.cryptoPerpetualFutures.cryptoPerpLatestFuturesPricing

Latest funding/mark pricing for perpetual-futures contracts.

await alpaca.marketData.cryptoPerpetualFutures.cryptoPerpLatestFuturesPricing({
loc: "global",
symbols: "BTC-PERP",
});

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: "1Day",
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.indices — IndexApi

Index historical and latest values.

alpaca.marketData.indices.indexValues

Historical index values (paginated).

await alpaca.marketData.indices.indexValues({
symbols: "SPX",
start: new Date("2024-01-01"),
});
alpaca.marketData.indices.indexLatestValues

Latest values for one or more indices.

await alpaca.marketData.indices.indexLatestValues({ symbols: "SPX" });

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: "1Day",
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-action data.

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"),
});