The Alpaca Market Data API delivers real-time and historical pricing data for US stocks (SIP and IEX feeds), options (OPRA), and crypto. Supports REST and WebSocket streaming with bars, quotes, trades, snapshots, and corporate actions endpoints. 7+ years of historical data available.
openapi: 3.0.0
info:
title: Market Data API
description: 'Access Alpaca’s historical and real-time US stock market and crypto data through REST API and WebSocket. There are APIs for Stock Pricing, Crypto Pricing, and News.'
version: 2.0.0
contact:
name: Alpaca Support
email: [email protected]
url: 'https://alpaca.markets/support'
termsOfService: 'https://s3.amazonaws.com/files.alpaca.markets/disclosures/library/TermsAndConditions.pdf'
servers:
- url: 'https://data.alpaca.markets'
description: Production
- description: Sandbox
url: 'https://data.sandbox.alpaca.markets'
tags:
- name: Stock Pricing Data API
- name: Crypto Pricing Data API
- name: News
- name: Logo
- name: Screener
- name: Forex
paths:
/v2/stocks/bars:
get:
tags:
- Stock Pricing Data API
summary: Get Bar data for multiple stock symbols
parameters:
- $ref: '#/components/parameters/stock-symbols'
- $ref: '#/components/parameters/start'
- $ref: '#/components/parameters/end'
- $ref: '#/components/parameters/timeframe'
- $ref: '#/components/parameters/limit'
- $ref: '#/components/parameters/page_token'
- $ref: '#/components/parameters/adjustment'
- $ref: '#/components/parameters/feed'
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/MultiBarsResponse'
examples:
example-1:
value:
bars:
AAPL:
- t: '2022-02-28T05:00:00Z'
o: 163.02
h: 165.42
l: 162.43
c: 165.12
v: 90552883
'n': 743379
vw: 164.274348
TSLA:
- t: '2022-02-28T05:00:00Z'
o: 815.72
h: 876.86
l: 814.7075
c: 870.43
v: 32122773
'n': 848700
vw: 855.748243
next_page_token: null
operationId: getBarsForMultipleStockSymbols
description: |-
The Multi Bars API returns aggregate historical data for multiple given ticker symbols over a specified time period.
Returned results are sorted by symbol first then by Bar timestamp. This means that you are likely to see only one symbol in your first response if there are enough Bars for that symbol to hit the limit you requested on that request.
In these situations if you keep requesting again with the next_page_token you will eventually reach the next symbols if any Bars were found for them.
/v2/stocks/bars/latest:
get:
summary: Get Latest Bar data for multiple stock symbols
tags:
- Stock Pricing Data API
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/LatestMultiBarsResponse'
examples:
example-1:
value:
bars:
AAPL:
t: '2022-03-10T20:01:00Z'
o: 158.715
h: 158.73
l: 158.61
c: 158.615
v: 1211
'n': 21
vw: 158.680756
TSLA:
t: '2022-03-10T20:01:00Z'
o: 834.27
h: 834.27
l: 832.46
c: 832.46
v: 1257
'n': 48
vw: 833.55574
operationId: getLatestBarsForMultipleStockSymbols
description: The Bars API returns aggregate historical data for the requested security. Returns the latest bar data for the queried stock symbols.
parameters:
- $ref: '#/components/parameters/stock-symbols'
- $ref: '#/components/parameters/feed'
'/v2/stocks/{symbol}/bars':
get:
tags:
- Stock Pricing Data API
summary: Bars
parameters:
- $ref: '#/components/parameters/start'
- $ref: '#/components/parameters/end'
- $ref: '#/components/parameters/timeframe'
- $ref: '#/components/parameters/limit'
- $ref: '#/components/parameters/page_token'
- $ref: '#/components/parameters/feed'
- $ref: '#/components/parameters/adjustment'
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/BarsResponse'
examples:
getBarsStocks-example-1:
value:
bars:
- t: '2021-02-01T16:01:00Z'
o: 133.32
h: 133.74
l: 133.31
c: 133.5
v: 9876
- t: '2021-02-01T16:02:00Z'
o: 133.5
h: 133.58
l: 133.44
c: 133.58
v: 3567
symbol: AAPL
next_page_token: MjAyMS0wMi0wMVQxNDowMjowMFo7MQ==
operationId: getBarsForStockSymbol
description: The Bars API returns aggregate historical data for the requested security. Returns bars for the queried stock symbol.
parameters:
- $ref: '#/components/parameters/stock-symbol'
'/v2/stocks/{symbol}/bars/latest':
get:
tags:
- Stock Pricing Data API
summary: Get Latest Bars for Symbol
operationId: getLatestBarForStockSymbol
description: The Bars API returns aggregate historical data for the requested security. Returns the latest bar data for the queried stock symbol.
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/LatestBarResponse'
examples:
example-1:
value:
symbol: AAPL
bar:
t: '2022-03-10T19:26:00Z'
o: 158.035
h: 158.21
l: 158.035
c: 158.21
v: 800
'n': 15
vw: 158.113144
parameters:
- $ref: '#/components/parameters/feed'
parameters:
- $ref: '#/components/parameters/stock-symbol'
/v2/stocks/trades:
get:
tags:
- Stock Pricing Data API
summary: Get Trade data for multiple stock symbols
parameters:
- $ref: '#/components/parameters/stock-symbols'
- $ref: '#/components/parameters/start'
- $ref: '#/components/parameters/end'
- $ref: '#/components/parameters/limit'
- $ref: '#/components/parameters/page_token'
- $ref: '#/components/parameters/feed'
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/MultiTradesResponse'
examples:
geMultiTradesStocks-example-1:
value:
trades:
SPY:
- t: '2021-02-06T13:04:56.334320128Z'
x: C
p: 387.62
s: 100
c:
- ' '
- T
i: 52983525029461
z: B
- t: '2021-02-06T13:09:42.325484032Z'
x: C
p: 387.69
s: 100
c:
- ' '
- T
i: 52983525033813
z: B
next_page_token: MjAyMS0wMi0wNlQxMzowOTo0Mlo7MQ==
operationId: getTradesForMultipleStockSymbols
description: |-
The Multi Trades API provides historical trade data for multiple given ticker symbols over a specified time period.
Returned results are sorted by symbol first then by Trade timestamp. This means that you are likely to see only one symbol in your first response if there are enough Trades for that symbol to hit the limit you requested on that request.
In these situations if you keep requesting again with the next_page_token you will eventually reach the next symbols if any Trades were found for them.
/v2/stocks/trades/latest:
get:
summary: Get Latest Trades data for multiple stock symbols
tags:
- Stock Pricing Data API
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/LatestMultiTradesResponse'
examples:
example-1:
value:
trades:
TSLA:
t: '2022-03-11T17:24:55.143671726Z'
x: V
p: 801.83
s: 100
c:
- '@'
i: 9924
z: C
AAPL:
t: '2022-03-11T17:24:56.321817175Z'
x: V
p: 155.105
s: 300
c:
- '@'
i: 7741
z: C
operationId: getLatestTradesForMultipleStockSymbols
description: Returns the latest trades data for the queried stock symbols.
parameters:
- $ref: '#/components/parameters/stock-symbols'
- $ref: '#/components/parameters/feed'
'/v2/stocks/{symbol}/trades':
get:
tags:
- Stock Pricing Data API
summary: Trades
parameters:
- $ref: '#/components/parameters/start'
- $ref: '#/components/parameters/end'
- name: symbol
in: path
schema:
type: string
required: true
description: The symbol to query for
example: AAPL
- $ref: '#/components/parameters/limit'
- $ref: '#/components/parameters/page_token'
- $ref: '#/components/parameters/feed'
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/TradesResponse'
examples:
getTradeStocks-example-1:
value:
trades:
- t: '2021-02-06T13:04:56.334320128Z'
x: C
p: 387.62
s: 100
c:
- ' '
- T
i: 52983525029461
z: B
- t: '2021-02-06T13:09:42.325484032Z'
x: C
p: 387.69
s: 100
c:
- ' '
- T
i: 52983525033813
z: B
symbol: SPY
next_page_token: MjAyMS0wMi0wNlQxMzowOTo0Mlo7MQ==
operationId: getTradesForStockSymbol
description: The Trades API provides historical trade data for a given ticker symbol on a specified date. Returns trades for the queried stock signal.
parameters:
- $ref: '#/components/parameters/stock-symbol'
'/v2/stocks/{symbol}/trades/latest':
get:
tags:
- Stock Pricing Data API
summary: Latest Trade
parameters:
- name: symbol
in: path
schema:
type: string
required: true
description: The symbol to query for
example: AAPL
- $ref: '#/components/parameters/feed'
responses:
'200':
description: Successful response
content:
application/json:
examples:
example-1:
value:
symbol: AAPL
trade:
t: '2022-02-01T17:46:51.111055251Z'
x: V
p: 173.06
s: 100
c:
- '@'
i: 6519
z: C
schema:
$ref: '#/components/schemas/LatestTradeResponse'
operationId: getLatestTradeForStockSymbol
description: The Latest Trade API provides the latest trade data for a given ticker symbol.
parameters:
- $ref: '#/components/parameters/stock-symbol'
/v2/stocks/quotes:
get:
tags:
- Stock Pricing Data API
summary: Get Quotes for multiple stock symbols
parameters:
- $ref: '#/components/parameters/stock-symbols'
- $ref: '#/components/parameters/start'
- $ref: '#/components/parameters/end'
- $ref: '#/components/parameters/limit'
- $ref: '#/components/parameters/page_token'
- $ref: '#/components/parameters/feed'
responses:
'200':
description: |
Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/MultiQuotesReponse'
examples:
example-1:
value:
quotes:
AAPL:
- t: '2022-03-11T13:13:49.975594385Z'
ax: V
ap: 159.97
as: 1
bx: V
bp: 0
bs: 0
c:
- R
z: C
next_page_token: QUFQTHwyMDIyLTAzLTExVDEzOjEzOjQ5Ljk3NTU5NDM4NVp8MDFEQzVERDY=
operationId: getQuotesForMultipleStockSymbols
description: |-
The Multi Quotes API provides NBBO quotes for multiple given ticker symbols over a specified time period.
Returned results are sorted by symbol first then by Quote timestamp. This means that you are likely to see only one symbol in your first response if there are enough Quotes for that symbol to hit the limit you requested on that request.
In these situations if you keep requesting again with the next_page_token you will eventually reach the next symbols if any Quotes were found for them.
/v2/stocks/quotes/latest:
get:
summary: Get Latest Quotes for multiple stock symbols
tags:
- Stock Pricing Data API
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/LatestMultiQuotesResponse'
examples:
example-1:
value:
quotes:
AAPL:
t: '2022-03-11T18:40:13.514830169Z'
ax: V
ap: 156.47
as: 3
bx: V
bp: 156.45
bs: 1
c:
- R
z: C
TSLA:
t: '2022-03-11T18:40:12.416216587Z'
ax: V
ap: 850
as: 1
bx: V
bp: 798
bs: 2
c:
- R
z: C
operationId: getLatestQuotesForMultipleStockSymbols
description: Returns the latest quotes data for the queried stock symbols.
parameters:
- $ref: '#/components/parameters/stock-symbols'
- $ref: '#/components/parameters/feed'
'/v2/stocks/{symbol}/quotes':
get:
tags:
- Stock Pricing Data API
summary: Get Quotes for stock symbol
parameters:
- $ref: '#/components/parameters/start'
- $ref: '#/components/parameters/end'
- name: symbol
in: path
schema:
type: string
required: true
description: The symbol to query for
example: AAPL
- $ref: '#/components/parameters/limit'
- $ref: '#/components/parameters/page_token'
- $ref: '#/components/parameters/feed'
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/QuotesResponse'
examples:
getQuotesStocks-example-1:
value:
quotes:
- t: '2022-02-01T09:00:00.000448Z'
ax: K
ap: 175
as: 1
bx: Q
bp: 174.96
bs: 4
c:
- R
z: C
- t: '2022-02-01T09:00:00.000448Z'
ax: K
ap: 175
as: 12
bx: Q
bp: 174.96
bs: 4
c:
- R
z: C
symbol: AAPL
next_page_token: null
operationId: getQuotesForStockSymbol
description: The Quotes API provides NBBO quotes for a single given ticker symbol at a specified date. Returns quotes (NBBOs) for the querried stock symbol.
parameters:
- $ref: '#/components/parameters/stock-symbol'
'/v2/stocks/{symbol}/quotes/latest':
get:
tags:
- Stock Pricing Data API
summary: Get Latest Quote for stock symbol
parameters:
- name: symbol
in: path
schema:
type: string
required: true
description: The symbol to query for
example: AAPL
- $ref: '#/components/parameters/feed'
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/LatestQuoteResponse'
examples:
example-1:
value:
symbol: AAPL
quote:
t: '2022-02-01T17:51:03.204726425Z'
ax: V
ap: 173.24
as: 4
bx: V
bp: 173.21
bs: 4
c:
- R
z: C
operationId: getLatestQuoteForStockSymbol
description: The Latest Quote API provides the latest quote data for a given ticker symbol.
parameters:
- $ref: '#/components/parameters/stock-symbol'
/v2/stocks/snapshots:
get:
tags:
- Stock Pricing Data API
summary: Get Snapshots for multiple stock symbols
parameters:
- $ref: '#/components/parameters/stock-symbols'
- $ref: '#/components/parameters/feed'
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/MultiSnapshotResponse'
examples:
example-1:
value:
AAPL:
latestTrade:
t: '2022-03-11T19:08:43.947998695Z'
x: V
p: 156.055
s: 100
c:
- '@'
i: 10593
z: C
latestQuote:
t: '2022-03-11T19:09:06.125564144Z'
ax: V
ap: 157.2
as: 5
bx: V
bp: 156.08
bs: 1
c:
- R
z: C
minuteBar:
t: '2022-03-11T19:08:00Z'
o: 156.02
h: 156.1
l: 156.02
c: 156.055
v: 4483
'n': 26
vw: 156.055956
dailyBar:
t: '2022-03-11T05:00:00Z'
o: 158.94
h: 159.25
l: 154.76
c: 156.055
v: 1180799
'n': 10408
vw: 156.545239
prevDailyBar:
t: '2022-03-10T05:00:00Z'
o: 160.23
h: 160.38
l: 155.98
c: 158.52
v: 1889292
'n': 17072
vw: 157.845202
TSLA:
latestTrade:
t: '2022-03-11T19:08:59.479520429Z'
x: V
p: 796.95
s: 100
c:
- '@'
i: 13647
z: C
latestQuote:
t: '2022-03-11T19:09:06.159593323Z'
ax: V
ap: 850
as: 1
bx: V
bp: 796.49
bs: 1
c:
- R
z: C
minuteBar:
t: '2022-03-11T19:08:00Z'
o: 796.78
h: 797.4
l: 796.78
c: 796.95
v: 2139
'n': 46
vw: 797.116889
dailyBar:
t: '2022-03-11T05:00:00Z'
o: 840.38
h: 843.055
l: 795.33
c: 796.95
v: 466980
'n': 13232
vw: 811.369454
prevDailyBar:
t: '2022-03-10T05:00:00Z'
o: 851.5
h: 853.355
l: 810.76
c: 838.21
v: 578475
'n': 16118
vw: 828.766436
operationId: getSnapshotsForMultipleStockSymbols
description: 'The Snapshot API for multiple tickers provides the latest trade, latest quote, minute bar daily bar and previous daily bar data for the given ticker symbols.'
'/v2/stocks/{symbol}/snapshot':
get:
tags:
- Stock Pricing Data API
summary: Get a Snapshot for a stock symbol
parameters:
- name: symbol
in: path
schema:
type: string
required: true
description: The symbol to query for
example: AAPL
- $ref: '#/components/parameters/feed'
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/Snapshot'
examples:
getSnapshotStocks-example-1:
value:
symbol: AAPL
latestTrade:
t: '2021-05-11T20:00:00.435997104Z'
x: Q
p: 125.91
s: 5589631
c:
- '@'
- M
i: 179430
z: C
latestQuote:
t: '2021-05-11T22:05:02.307304704Z'
ax: P
ap: 125.68
as: 12
bx: P
bp: 125.6
bs: 4
c:
- R
minuteBar:
t: '2021-05-11T22:02:00Z'
o: 125.66
h: 125.66
l: 125.66
c: 125.66
v: 396
dailyBar:
t: '2021-05-11T04:00:00Z'
o: 123.5
h: 126.27
l: 122.77
c: 125.91
v: 125863164
prevDailyBar:
t: '2021-05-10T04:00:00Z'
o: 129.41
h: 129.54
l: 126.81
c: 126.85
v: 79569305
operationId: getSnapshotForStockSymbol
description: 'The Snapshot API for one ticker provides the latest trade, latest quote, minute bar daily bar and previous daily bar data for a given ticker symbol. This endpoint returns the snapshot for the requested security.'
parameters:
- $ref: '#/components/parameters/stock-symbol'
/v1beta1/crypto/trades:
get:
tags:
- Crypto Pricing Data API
summary: Get Trade data for multiple crypto symbols
parameters:
- $ref: '#/components/parameters/start'
- $ref: '#/components/parameters/end'
- $ref: '#/components/parameters/crypto-exchanges'
- $ref: '#/components/parameters/limit'
- $ref: '#/components/parameters/page_token'
- $ref: '#/components/parameters/crypto-symbols'
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/MultiTradesResponse'
examples:
example-1:
value:
trades:
BTCUSD:
- t: '2022-03-02T06:00:00.028455Z'
x: CBSE
p: 44299.16
s: 0.001
tks: B
i: 289852921
- t: '2022-03-02T06:00:00.028455Z'
x: CBSE
p: 44299.15
s: 0.001
tks: B
i: 289852922
next_page_token: QlRDVVNEfDIwMjItMDMtMDJUMDY6MDA6MDAuMDI4NDU1MDAwWnxDQlNFfDA5MjIzMzcyMDM3MTQ0NjI4NzMw
operationId: getTradesForMultipleCryptoSymbols
description: |-
The Multi Trades API provides historical trade data for a list of given crypto symbols on a specified date. Returns trades for the queried crypto symbols.
Returned results are sorted by symbol first then by Trade timestamp. This means that you are likely to see only one symbol in your first response if there are enough Trades for that symbol to hit the limit you requested on that request.
In these situations if you keep requesting again with the next_page_token you will eventually reach the next symbols if any Trades were found for them.
/v1beta1/crypto/trades/latest:
get:
summary: Get Latest Trade data for multiple Crypto symbols
tags:
- Crypto Pricing Data API
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/LatestMultiTradesResponse'
examples:
example-1:
value:
trades:
ETHUSD:
t: '2022-03-08T22:13:55.777631Z'
x: FTXU
p: 2562.8
s: 0.881
tks: S
i: 26271234
BTCUSD:
t: '2022-03-08T22:14:47.379901Z'
x: FTXU
p: 38510
s: 0.05
tks: B
i: 26271277
operationId: getLatestTradesForMultipleCryptoSymbols
description: 'Provides latest trade data for a list of given crypto symbols. '
parameters:
- $ref: '#/components/parameters/crypto-symbols'
- $ref: '#/components/parameters/crypto-exchange'
'/v1beta1/crypto/{symbol}/trades':
get:
tags:
- Crypto Pricing Data API
summary: Get Trade data for a crypto symbol
parameters:
- $ref: '#/components/parameters/start'
- $ref: '#/components/parameters/end'
- $ref: '#/components/parameters/crypto-exchanges'
- $ref: '#/components/parameters/limit'
- $ref: '#/components/parameters/page_token'
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/TradesResponse'
examples:
example-1:
value:
trades:
- t: '2022-02-27T11:04:55.82622Z'
x: FTXU
p: 39330
s: 0.0003
tks: B
i: 25783365
symbol: BTCUSD
next_page_token: QlRDVVNEfDIwMjItMDItMjdUMTE6MDQ6NTUuODI2MjIwMDAwWnxGVFhVfDA5MjIzMzcyMDM2ODgwNTU5MTcz
operationId: getTradesForCryptoSymbol
description: The Trades API provides historical trade data for a given crypto symbol on a specified date. Returns trades for the queried crypto symbol
parameters:
- $ref: '#/components/parameters/crypto-symbol'
'/v1beta1/crypto/{symbol}/trades/latest':
get:
tags:
- Crypto Pricing Data API
summary: Latest Trades
parameters:
- $ref: '#/components/parameters/crypto-exchange'
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/LatestTradeResponse'
examples:
example-1:
value:
symbol: BTCUSD
trade:
t: '2022-03-08T22:27:26.573044Z'
x: FTXU
p: 38614
s: 0.0019
tks: S
i: 26271424
operationId: getLatestTradesForCryptoSymbol
description: The Latest Trades API provides the latest historical trade data for a given crypto symbol. Returns trades for the queried crypto symbol.
parameters:
- $ref: '#/components/parameters/crypto-symbol'
/v1beta1/crypto/bars:
get:
tags:
- Crypto Pricing Data API
summary: Get Bars for multiple Crypto symbols
description: |-
returns aggregate historical data for the requested crypto symbols.
Returned results are sorted by symbol first then by Bar timestamp. This means that you are likely to see only one symbol in your first response if there are enough Bars for that symbol to hit the limit you requested on that request.
In these situations if you keep requesting again
# --- truncated at 32 KB (97 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/alpaca/refs/heads/main/openapi/alpaca-data-api-openapi.yml