Polygon Stocks:snapshot API
The stocks:snapshot API from Polygon — 3 operation(s) for stocks:snapshot.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/polygon-stocks-snapshot-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
description: The future of fintech.
title: Polygon Stocks:snapshot API
version: 1.0.0
servers:
- description: Polygon Platform API
url: https://api.polygon.io
- description: Polygon Platform API (Staging)
url: https://api.staging.polygon.io
security:
- apiKey: []
tags:
- name: stocks:snapshot
paths:
/v2/snapshot/locale/us/markets/stocks/tickers:
get:
description: 'Get the most up-to-date market data for all traded stock symbols.
<br />
<br />
Note: Snapshot data is cleared at 3:30am EST and gets populated as data is received from the exchanges. This can happen as early as 4am EST.
'
operationId: GetStocksSnapshotTickers
parameters:
- description: A case-sensitive comma separated list of tickers to get snapshots for. For example, AAPL,TSLA,GOOG. Empty string defaults to querying all tickers.
in: query
name: tickers
schema:
items:
type: string
type: array
- description: 'Include OTC securities in the response. Default is false (don''t include OTC securities).
'
in: query
name: include_otc
schema:
type: boolean
responses:
'200':
content:
application/json:
example:
count: 1
status: OK
tickers:
- day:
c: 20.506
dv: '37216.0'
h: 20.64
l: 20.506
o: 20.64
v: 37216
vw: 20.616
lastQuote:
P: 20.6
S: 22
p: 20.5
s: 13
t: 1605192959994246100
lastTrade:
c:
- 14
- 41
ds: '2416.0'
i: '71675577320245'
p: 20.506
s: 2416
t: 1605192894630916600
x: 4
min:
av: 37216
c: 20.506
dav: '37216.0'
dv: '5000.0'
h: 20.506
l: 20.506
n: 1
o: 20.506
t: 1684428600000
v: 5000
vw: 20.5105
prevDay:
c: 20.63
h: 21
l: 20.5
o: 20.79
v: 292738
vw: 20.6939
ticker: BCAT
todaysChange: -0.124
todaysChangePerc: -0.601
updated: 1605192894630916600
schema:
allOf:
- properties:
count:
description: The total number of results for this request.
type: integer
status:
description: The status of this request's response.
type: string
required:
- status
type: object
- properties:
tickers:
description: An array of snapshot data for the specified tickers.
items:
properties:
day:
description: The most recent daily bar for this ticker.
properties:
c:
description: The close price for the symbol in the given time period.
format: double
type: number
dv:
description: The volume including fractional shares, respresented as a string.
type: string
h:
description: The highest price for the symbol in the given time period.
format: double
type: number
l:
description: The lowest price for the symbol in the given time period.
format: double
type: number
o:
description: The open price for the symbol in the given time period.
format: double
type: number
otc:
description: Whether or not this aggregate is for an OTC ticker. This field will be left off if false.
type: boolean
v:
description: The trading volume of the symbol in the given time period.
format: double
type: number
vw:
description: The volume weighted average price.
format: double
type: number
required:
- o
- h
- l
- c
- v
- vw
type: object
fmv:
description: Fair market value is only available on Business plans. It is our proprietary algorithm to generate a real-time, accurate, fair market value of a tradable security. For more information, <a rel="nofollow" target="_blank" href="https://massive.com/contact">contact us</a>.
format: double
type: number
lastQuote:
description: The most recent quote for this ticker. This is only returned if your current plan includes quotes.
properties:
P:
description: The ask price.
format: double
type: number
S:
description: The ask size in lots.
type: integer
p:
description: The bid price.
format: double
type: number
s:
description: The bid size in lots.
type: integer
t:
description: The nanosecond accuracy SIP Unix Timestamp. This is the timestamp of when the SIP received this message from the exchange which produced it.
type: integer
required:
- p
- s
- P
- S
- t
type: object
lastTrade:
description: The most recent trade for this ticker. This is only returned if your current plan includes trades.
properties:
c:
description: The trade conditions.
items:
type: integer
type: array
ds:
description: The size of the trade including fractional shares, respresented as a string.
type: string
i:
description: 'The Trade ID which uniquely identifies a trade. These are unique per
combination of ticker, exchange, and TRF. For example: A trade for AAPL
executed on NYSE and a trade for AAPL executed on NASDAQ could potentially
have the same Trade ID.
'
type: string
p:
description: 'The price of the trade. This is the actual dollar value per whole share of
this trade. A trade of 100 shares with a price of $2.00 would be worth a
total dollar value of $200.00.
'
format: double
type: number
s:
description: The size (volume) of the trade.
type: integer
t:
description: The nanosecond accuracy SIP Unix Timestamp. This is the timestamp of when the SIP received this message from the exchange which produced it.
type: integer
x:
description: The exchange ID. See <a href="https://massive.com/docs/rest/stocks/market-operations/exchanges" alt="Exchanges">Exchanges</a> for Massive's mapping of exchange IDs.
type: integer
required:
- c
- i
- p
- s
- t
- x
- ds
type: object
min:
description: The most recent minute bar for this ticker.
properties:
av:
description: The accumulated volume.
type: integer
c:
description: The close price for the symbol in the given time period.
format: double
type: number
dav:
description: The accumulated volume including fractional shares, respresented as a string.
type: string
dv:
description: The volume including fractional shares, respresented as a string.
type: string
h:
description: The highest price for the symbol in the given time period.
format: double
type: number
l:
description: The lowest price for the symbol in the given time period.
format: double
type: number
n:
description: The number of transactions in the aggregate window.
type: integer
o:
description: The open price for the symbol in the given time period.
format: double
type: number
otc:
description: Whether or not this aggregate is for an OTC ticker. This field will be left off if false.
type: boolean
t:
description: The Unix millisecond timestamp for the start of the aggregate window.
type: integer
v:
description: The trading volume of the symbol in the given time period.
format: double
type: number
vw:
description: The volume weighted average price.
format: double
type: number
required:
- av
- dav
- o
- h
- l
- c
- v
- vw
- t
- n
type: object
prevDay:
description: The previous day's bar for this ticker.
properties:
c:
description: The close price for the symbol in the given time period.
format: double
type: number
h:
description: The highest price for the symbol in the given time period.
format: double
type: number
l:
description: The lowest price for the symbol in the given time period.
format: double
type: number
o:
description: The open price for the symbol in the given time period.
format: double
type: number
otc:
description: Whether or not this aggregate is for an OTC ticker. This field will be left off if false.
type: boolean
v:
description: The trading volume of the symbol in the given time period.
format: double
type: number
vw:
description: The volume weighted average price.
format: double
type: number
required:
- o
- h
- l
- c
- v
- vw
type: object
ticker:
description: The exchange symbol that this item is traded under.
type: string
todaysChange:
description: The value of the change from the previous day.
format: double
type: number
todaysChangePerc:
description: The percentage change since the previous day.
format: double
type: number
updated:
description: The last updated timestamp.
type: integer
type: object
type: array
type: object
text/csv:
example: 'day_o,day_h,day_l,day_c,day_v,day_vw,day_dv,quoteResponse_P,quoteResponse_S,quoteResponse_p,quoteResponse_s,quoteResponse_t,lastTrade_c,lastTrade_i,lastTrade_p,lastTrade_s,lastTrade_t,lastTrade_x,lastTrade_ds,min_o,min_h,min_l,min_c,min_v,min_vw,min_av,min_t,min_n,min_dv,min_dav,prevDay_o,prevDay_h,prevDay_l,prevDay_c,prevDay_v,prevDay_vw
20.64,20.64,20.506,20.506,37216,20.616,"37216.0",20.6,22,20.5,13,1605192959994246144,"[14,41]",71675577320245,20.506,2416,1605192894630916608,4,"2416.0",20.506,20.506,20.506,20.506,5000,20.5105,37216,1684428600000,1,"5000.0","37216.0",20.79,21,20.5,20.63,292738,20.6939
'
schema:
type: string
description: Get current state for all tickers
default:
description: Unexpected error
summary: All Tickers
tags:
- stocks:snapshot
x-polygon-entitlement-allowed-timeframes:
- description: Real Time Data
name: realtime
- description: 15 minute delayed data
name: delayed
x-polygon-entitlement-data-type:
description: Aggregate data
name: aggregates
x-polygon-entitlement-market-type:
description: Stocks data
name: stocks
/v2/snapshot/locale/us/markets/stocks/tickers/{stocksTicker}:
get:
description: 'Get the most up-to-date market data for a single traded stock ticker.
<br />
<br />
Note: Snapshot data is cleared at 3:30am EST and gets populated as data is received from the exchanges. This can happen as early as 4am EST.
'
operationId: GetStocksSnapshotTicker
parameters:
- description: Specify a case-sensitive ticker symbol. For example, AAPL represents Apple Inc.
example: AAPL
in: path
name: stocksTicker
required: true
schema:
type: string
responses:
'200':
content:
application/json:
example:
request_id: 657e430f1ae768891f018e08e03598d8
status: OK
ticker:
day:
c: 120.4229
dv: '28727868.0'
h: 120.53
l: 118.81
o: 119.62
v: 28727868
vw: 119.725
lastQuote:
P: 120.47
S: 4
p: 120.46
s: 8
t: 1605195918507251700
lastTrade:
c:
- 14
- 41
ds: '236.0'
i: '4046'
p: 120.47
s: 236
t: 1605195918306274000
x: 10
min:
av: 28724441
c: 120.4201
dav: '28724441.0'
dv: '270796.0'
h: 120.468
l: 120.37
n: 762
o: 120.435
t: 1684428720000
v: 270796
vw: 120.4129
prevDay:
c: 119.49
h: 119.63
l: 116.44
o: 117.19
v: 110597265
vw: 118.4998
ticker: AAPL
todaysChange: 0.98
todaysChangePerc: 0.82
updated: 1605195918306274000
schema:
allOf:
- properties:
status:
description: The status of this request's response.
type: string
required:
- status
type: object
- properties:
request_id:
description: A request id assigned by the server.
type: string
required:
- request_id
type: object
- properties:
ticker:
description: Contains the requested snapshot data for the specified ticker.
properties:
day:
description: The most recent daily bar for this ticker.
properties:
c:
description: The close price for the symbol in the given time period.
format: double
type: number
dv:
description: The volume including fractional shares, respresented as a string.
type: string
h:
description: The highest price for the symbol in the given time period.
format: double
type: number
l:
description: The lowest price for the symbol in the given time period.
format: double
type: number
o:
description: The open price for the symbol in the given time period.
format: double
type: number
otc:
description: Whether or not this aggregate is for an OTC ticker. This field will be left off if false.
type: boolean
v:
description: The trading volume of the symbol in the given time period.
format: double
type: number
vw:
description: The volume weighted average price.
format: double
type: number
required:
- o
- h
- l
- c
- v
- vw
type: object
fmv:
description: Fair market value is only available on Business plans. It is our proprietary algorithm to generate a real-time, accurate, fair market value of a tradable security. For more information, <a rel="nofollow" target="_blank" href="https://massive.com/contact">contact us</a>.
format: double
type: number
lastQuote:
description: The most recent quote for this ticker. This is only returned if your current plan includes quotes.
properties:
P:
description: The ask price.
format: double
type: number
S:
description: The ask size in lots.
type: integer
p:
description: The bid price.
format: double
type: number
s:
description: The bid size in lots.
type: integer
t:
description: The nanosecond accuracy SIP Unix Timestamp. This is the timestamp of when the SIP received this message from the exchange which produced it.
type: integer
required:
- p
- s
- P
- S
- t
type: object
lastTrade:
description: The most recent trade for this ticker. This is only returned if your current plan includes trades.
properties:
c:
description: The trade conditions.
items:
type: integer
type: array
ds:
description: The size of the trade including fractional shares, respresented as a string.
type: string
i:
description: 'The Trade ID which uniquely identifies a trade. These are unique per
combination of ticker, exchange, and TRF. For example: A trade for AAPL
executed on NYSE and a trade for AAPL executed on NASDAQ could potentially
have the same Trade ID.
'
type: string
p:
description: 'The price of the trade. This is the actual dollar value per whole share of
this trade. A trade of 100 shares with a price of $2.00 would be worth a
total dollar value of $200.00.
'
format: double
type: number
s:
description: The size (volume) of the trade.
type: integer
t:
description: The nanosecond accuracy SIP Unix Timestamp. This is the timestamp of when the SIP received this message from the exchange which produced it.
type: integer
x:
description: The exchange ID. See <a href="https://massive.com/docs/rest/stocks/market-operations/exchanges" alt="Exchanges">Exchanges</a> for Massive's mapping of exchange IDs.
type: integer
required:
- c
- i
- p
- s
- t
- x
- ds
type: object
min:
description: The most recent minute bar for this ticker.
properties:
av:
description: The accumulated volume.
type: integer
c:
description: The close price for the symbol in the given time period.
format: double
type: number
dav:
description: The accumulated volume including fractional shares, respresented as a string.
type: string
dv:
description: The volume including fractional shares, respresented as a string.
type: string
h:
description: The highest price for the symbol in the given time period.
format: double
type: number
l:
description: The lowest price for the symbol in the given time period.
format: double
type: number
n:
description: The number of transactions in the aggregate window.
type: integer
o:
description: The open price for the symbol in the given time period.
format: double
type: number
otc:
description: Whether or not this aggregate is for an OTC ticker. This field will be left off if false.
type: boolean
t:
description: The Unix millisecond timestamp for the start of the aggregate window.
type: integer
v:
description: The trading volume of the symbol in the given time period.
format: double
type: number
vw:
description: The volume weighted average price.
format: double
type: number
required:
- av
- dav
- o
- h
- l
- c
- v
- vw
- t
- n
type: object
prevDay:
description: The previous day's bar for this ticker.
properties:
c:
description: The close price for the symbol in the given time period.
format: double
type: number
h:
description: The highest price for the symbol in the given time period.
format: double
type: number
l:
description: The lowest price for the symbol in the given time period.
format: double
type: number
o:
description: The open price for the symbol in the given time period.
format: double
type: number
otc:
description: Whether or not this aggregate is for an OTC ticker. This field will be left off if false.
type: boolean
v:
description: The trading volume of the symbol in the given time period.
format: double
type: number
vw:
description: The volume weighted average price.
format: double
type: number
required:
- o
- h
- l
- c
- v
- vw
type: object
ticker:
description: The exchange symbol that this item is traded under.
type: string
todaysChange:
description: The value of the change from the previous day.
format: double
type: number
todaysChangePerc:
description: The percentage change since the previous day.
format: double
type: number
updated:
description: The last updated timestamp.
type: integer
type: object
type: object
text/csv:
example: 'day_o,day_h,day_l,day_c,day_v,day_vw,day_dv,quoteResponse_P,quoteResponse_S,quoteResponse_p,quoteResponse_s,quoteResponse_t,lastTrade_c,lastTrade_i,lastTrade_p,lastTrade_s,lastTrade_t,lastTrade_x,lastTrade_ds,min_o,min_h,min_l,min_c,min_v,min_vw,min_av,min_t,min_n,min_dv,min_dav,prevDay_o,prevDay_h,prevDay_l,prevDay_c,prevDay_v,prevDay_vw
119.62,120.53,118.81
# --- truncated at 32 KB (56 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/polygon/refs/heads/main/openapi/polygon-stocks-snapshot-api-openapi.yml