Package markets.alpaca.client.data

Class AlpacaStocks

java.lang.Object

markets.alpaca.client.data.AlpacaStocks

public final class AlpacaStocks
extends Object

Handwritten convenience facade for common Market Data stock workflows.

This class wraps the generated Market Data StockApi and exposes typed request objects for common operations. Use generatedApi() when an endpoint is not covered by this facade.

See Also:

• Market Data OpenAPI spec

Constructor Summary

Constructors

Constructor	Description
AlpacaStocks(StockApi generatedApi)	Creates a facade around a generated Market Data StockApi.
AlpacaStocks(ApiClient dataClient)	Creates a facade from a generated Market Data ApiClient.

Method Summary

Modifier and Type	Method	Description
StockApi	generatedApi()	Returns the generated API for operations not covered by this facade.
StockTradesResp	trades(StockTradesRequest request)	Returns historical stock trades for one or more symbols.
StockTradesRespSingle	tradesForSymbol(StockTradesRequest request)	Returns historical stock trades through the single-symbol endpoint.
ApiResponse<StockTradesRespSingle>	tradesForSymbolWithHttpInfo(StockTradesRequest request)	Returns single-symbol historical stock trades with HTTP status code and response headers.
ApiResponse<StockTradesResp>	tradesWithHttpInfo(StockTradesRequest request)	Returns historical stock trades with HTTP status code and response headers.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

AlpacaStocks

public AlpacaStocks(StockApi generatedApi)

Creates a facade around a generated Market Data StockApi.

AlpacaStocks

public AlpacaStocks(ApiClient dataClient)

Creates a facade from a generated Market Data ApiClient.

Method Details

generatedApi

public StockApi generatedApi()

Returns the generated API for operations not covered by this facade.

trades

public StockTradesResp trades(StockTradesRequest request)
                       throws ApiException

Returns historical stock trades for one or more symbols.

Use StockTradesRequest.builder() to set symbols, time range, feed, currency, pagination token, and sort order without depending on generated parameter ordering.

Throws:

ApiException

tradesWithHttpInfo

public ApiResponse<StockTradesResp> tradesWithHttpInfo(StockTradesRequest request)
                                                throws ApiException

Returns historical stock trades with HTTP status code and response headers.

Use this overload for pagination and rate-limit headers.

Throws:

ApiException

tradesForSymbol

public StockTradesRespSingle tradesForSymbol(StockTradesRequest request)
                                      throws ApiException

Returns historical stock trades through the single-symbol endpoint.

The request must contain exactly one symbol. The single-symbol response model differs from the multi-symbol response model generated from the OpenAPI spec.

Throws:

ApiException

tradesForSymbolWithHttpInfo

public ApiResponse<StockTradesRespSingle> tradesForSymbolWithHttpInfo(StockTradesRequest request)
                                                               throws ApiException

Returns single-symbol historical stock trades with HTTP status code and response headers.

Throws:

ApiException