Stocks API Documentation
The Polygon.io Stocks API provides REST endpoints that let you query the latest market data from all US stock exchanges. You can also find data on company financials, stock market holidays, corporate actions, and more.
Authentication
Pass your API key in the query string like follows:
Alternatively, you can add an Authorization header to the request with your API Key as the token in the following form:
Usage
Many of Polygon.io's REST endpoints allow you to extend query parameters with inequalities like date.lt=2023-01-01 (less than) and date.gte=2023-01-01 (greater than or equal to) to search ranges of values. You can also use the field name without any extension to query for exact equality. Fields that support extensions will have an "Additional filter parameters" dropdown beneath them in the docs that detail the supported extensions for that parameter.
Response Types
By default, all endpoints return a JSON response. Users with Stocks Starter plan and above can request a CSV response by including 'Accept': 'text/csv' as a request parameter.
Aggregates (Bars)
Get aggregate bars for a stock over a given date range in custom time window sizes.
For example, if timespan = ‘minute’ and multiplier = ‘5’ then 5-minute bars will be returned.
Specify a case-sensitive ticker symbol. For example, AAPL represents Apple Inc.
The size of the timespan multiplier.
The size of the time window.
The start of the aggregate time window. Either a date with the format YYYY-MM-DD or a millisecond timestamp.
The end of the aggregate time window. Either a date with the format YYYY-MM-DD or a millisecond timestamp.
Whether or not the results are adjusted for splits. By default, results are adjusted. Set this to false to get results that are NOT adjusted for splits.
Sort the results by timestamp.
asc will return results in ascending order (oldest at the top),
desc will return results in descending order (newest at the top).
Limits the number of base aggregates queried to create the aggregate results. Max 50000 and Default 5000. Read more about how limit is used to calculate aggregate results in our article on Aggregate Data API Improvements.
The exchange symbol that this item is traded under.
Whether or not this response was adjusted for splits.
The number of aggregates (minute or day) used to generate the response.
A request id assigned by the server.
The total number of results for this request.
The status of this request's response.
An array of results containing the requested data.
The close price for the symbol in the given time period.
The highest price for the symbol in the given time period.
The lowest price for the symbol in the given time period.
The number of transactions in the aggregate window.
The open price for the symbol in the given time period.
Whether or not this aggregate is for an OTC ticker. This field will be left off if false.
The Unix millisecond timestamp for the start of the aggregate window.
The trading volume of the symbol in the given time period.
The volume weighted average price.
If present, this value can be used to fetch the next page of data.
{
"adjusted": true,
"next_url": "https://api.polygon.io/v2/aggs/ticker/AAPL/range/1/day/1578114000000/2020-01-10?cursor=bGltaXQ9MiZzb3J0PWFzYw",
"queryCount": 2,
"request_id": "6a7e466379af0a71039d60cc78e72282",
"results": [
{
"c": 75.0875,
"h": 75.15,
"l": 73.7975,
"n": 1,
"o": 74.06,
"t": 1577941200000,
"v": 135647456,
"vw": 74.6099
},
{
"c": 74.3575,
"h": 75.145,
"l": 74.125,
"n": 1,
"o": 74.2875,
"t": 1578027600000,
"v": 146535512,
"vw": 74.7026
}
],
"resultsCount": 2,
"status": "OK",
"ticker": "AAPL"
}Grouped Daily (Bars)
Get the daily open, high, low, and close (OHLC) for the entire stocks/equities markets.
The beginning date for the aggregate window.
Whether or not the results are adjusted for splits. By default, results are adjusted. Set this to false to get results that are NOT adjusted for splits.
Include OTC securities in the response. Default is false (don't include OTC securities).
Whether or not this response was adjusted for splits.
The number of aggregates (minute or day) used to generate the response.
A request id assigned by the server.
The total number of results for this request.
The status of this request's response.
An array of results containing the requested data.
The exchange symbol that this item is traded under.
The close price for the symbol in the given time period.
The highest price for the symbol in the given time period.
The lowest price for the symbol in the given time period.
The number of transactions in the aggregate window.
The open price for the symbol in the given time period.
Whether or not this aggregate is for an OTC ticker. This field will be left off if false.
The Unix millisecond timestamp for the end of the aggregate window.
The trading volume of the symbol in the given time period.
The volume weighted average price.
{
"adjusted": true,
"queryCount": 3,
"request_id": {
"description": "A request id assigned by the server.",
"type": "string"
},
"results": [
{
"T": "KIMpL",
"c": 25.9102,
"h": 26.25,
"l": 25.91,
"n": 74,
"o": 26.07,
"t": 1602705600000,
"v": 4369,
"vw": 26.0407
},
{
"T": "TANH",
"c": 23.4,
"h": 24.763,
"l": 22.65,
"n": 1096,
"o": 24.5,
"t": 1602705600000,
"v": 25933.6,
"vw": 23.493
},
{
"T": "VSAT",
"c": 34.24,
"h": 35.47,
"l": 34.21,
"n": 4966,
"o": 34.9,
"t": 1602705600000,
"v": 312583,
"vw": 34.4736
}
],
"resultsCount": 3,
"status": "OK"
}Daily Open/Close
Get the open, close and afterhours prices of a stock symbol on a certain date.
Specify a case-sensitive ticker symbol. For example, AAPL represents Apple Inc.
The date of the requested open/close in the format YYYY-MM-DD.
Whether or not the results are adjusted for splits. By default, results are adjusted. Set this to false to get results that are NOT adjusted for splits.
The close price of the ticker symbol in after hours trading.
The close price for the symbol in the given time period.
The requested date.
The highest price for the symbol in the given time period.
The lowest price for the symbol in the given time period.
The open price for the symbol in the given time period.
Whether or not this aggregate is for an OTC ticker. This field will be left off if false.
The open price of the ticker symbol in pre-market trading.
The status of this request's response.
The exchange symbol that this item is traded under.
The trading volume of the symbol in the given time period.
{
"afterHours": 322.1,
"close": 325.12,
"from": "2023-01-09",
"high": 326.2,
"low": 322.3,
"open": 324.66,
"preMarket": 324.5,
"status": "OK",
"symbol": "AAPL",
"volume": 26122646
}Previous Close
Get the previous day's open, high, low, and close (OHLC) for the specified stock ticker.
Specify a case-sensitive ticker symbol. For example, AAPL represents Apple Inc.
Whether or not the results are adjusted for splits. By default, results are adjusted. Set this to false to get results that are NOT adjusted for splits.
The exchange symbol that this item is traded under.
Whether or not this response was adjusted for splits.
The number of aggregates (minute or day) used to generate the response.
A request id assigned by the server.
The total number of results for this request.
The status of this request's response.
An array of results containing the requested data.
The close price for the symbol in the given time period.
The highest price for the symbol in the given time period.
The lowest price for the symbol in the given time period.
The number of transactions in the aggregate window.
The open price for the symbol in the given time period.
The Unix millisecond timestamp for the start of the aggregate window.
The trading volume of the symbol in the given time period.
The volume weighted average price.
{
"adjusted": true,
"queryCount": 1,
"request_id": "6a7e466379af0a71039d60cc78e72282",
"results": [
{
"T": "AAPL",
"c": 115.97,
"h": 117.59,
"l": 114.13,
"o": 115.55,
"t": 1605042000000,
"v": 131704427,
"vw": 116.3058
}
],
"resultsCount": 1,
"status": "OK",
"ticker": "AAPL"
}The ticker symbol to get trades for.
Query by trade timestamp. Either a date with the format YYYY-MM-DD or a nanosecond timestamp.
Order results based on the sort field.
Limit the number of results returned, default is 1000 and max is 50000.
Sort field used for ordering.
If present, this value can be used to fetch the next page of data.
A request id assigned by the server.
An array of results containing the requested data.
A list of condition codes.
The trade correction indicator.
The exchange ID. See Exchanges for Polygon.io's mapping of exchange IDs.
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.
The nanosecond accuracy Participant/Exchange Unix Timestamp. This is the timestamp of when the trade was actually generated at the exchange.
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.
The sequence number represents the sequence in which trade events happened. These are increasing and unique per ticker symbol, but will not always be sequential (e.g., 1, 2, 6, 9, 10, 11). Values reset after each trading session/day.
The nanosecond accuracy SIP Unix Timestamp. This is the timestamp of when the SIP received this trade from the exchange which produced it.
The size of a trade (also known as volume).
There are 3 tapes which define which exchange the ticker is listed on. These are integers in our objects which represent the letter of the alphabet. Eg: 1 = A, 2 = B, 3 = C.
- Tape A is NYSE listed securities
- Tape B is NYSE ARCA / NYSE American
- Tape C is NASDAQ
The ID for the Trade Reporting Facility where the trade took place.
The nanosecond accuracy TRF (Trade Reporting Facility) Unix Timestamp. This is the timestamp of when the trade reporting facility received this trade.
The status of this request's response.
{
"next_url": "https://api.polygon.io/v3/trades/AAPL?cursor=YWN0aXZlPXRydWUmZGF0ZT0yMDIxLTA0LTI1JmxpbWl0PTEmb3JkZXI9YXNjJnBhZ2VfbWFya2VyPUElN0M5YWRjMjY0ZTgyM2E1ZjBiOGUyNDc5YmZiOGE1YmYwNDVkYzU0YjgwMDcyMWE2YmI1ZjBjMjQwMjU4MjFmNGZiJnNvcnQ9dGlja2Vy",
"request_id": "a47d1beb8c11b6ae897ab76cdbbf35a3",
"results": [
{
"conditions": [
12,
41
],
"exchange": 11,
"id": "1",
"participant_timestamp": 1517562000015577000,
"price": 171.55,
"sequence_number": 1063,
"sip_timestamp": 1517562000016036600,
"size": 100,
"tape": 3
},
{
"conditions": [
12,
41
],
"exchange": 11,
"id": "2",
"participant_timestamp": 1517562000015577600,
"price": 171.55,
"sequence_number": 1064,
"sip_timestamp": 1517562000016038100,
"size": 100,
"tape": 3
}
],
"status": "OK"
}The ticker symbol of the stock/equity.
A request id assigned by the server.
The exchange symbol that this item is traded under.
A list of condition codes.
The trade correction indicator.
The nanosecond accuracy TRF(Trade Reporting Facility) Unix Timestamp. This is the timestamp of when the trade reporting facility received this message.
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.
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.
The sequence number represents the sequence in which message events happened. These are increasing and unique per ticker symbol, but will not always be sequential (e.g., 1, 2, 6, 9, 10, 11).
The ID for the Trade Reporting Facility where the trade took place.
The size of a trade (also known as volume).
The nanosecond accuracy SIP Unix Timestamp. This is the timestamp of when the SIP received this message from the exchange which produced it.
The exchange ID. See Exchanges for Polygon.io's mapping of exchange IDs.
The nanosecond accuracy Participant/Exchange Unix Timestamp. This is the timestamp of when the quote was actually generated at the exchange.
There are 3 tapes which define which exchange the ticker is listed on. These are integers in our objects which represent the letter of the alphabet. Eg: 1 = A, 2 = B, 3 = C.
- Tape A is NYSE listed securities
- Tape B is NYSE ARCA / NYSE American
- Tape C is NASDAQ
The status of this request's response.
{
"request_id": "f05562305bd26ced64b98ed68b3c5d96",
"results": {
"T": "AAPL",
"c": [
37
],
"f": 1617901342969796400,
"i": "118749",
"p": 129.8473,
"q": 3135876,
"r": 202,
"s": 25,
"t": 1617901342969834000,
"x": 4,
"y": 1617901342968000000,
"z": 3
},
"status": "OK"
}The ticker symbol to get quotes for.
Query by timestamp. Either a date with the format YYYY-MM-DD or a nanosecond timestamp.
Order results based on the sort field.
Limit the number of results returned, default is 1000 and max is 50000.
Sort field used for ordering.
If present, this value can be used to fetch the next page of data.
A request id assigned by the server.
An array of results containing the requested data.
The ask exchange ID
The ask price.
The ask size. This represents the number of round lot orders at the given ask price. The normal round lot size is 100 shares. An ask size of 2 means there are 200 shares available to purchase at the given ask price.
The bid exchange ID
The bid price.
The bid size. This represents the number of round lot orders at the given bid price. The normal round lot size is 100 shares. A bid size of 2 means there are 200 shares for purchase at the given bid price.
A list of condition codes.
A list of indicator codes.
The nanosecond accuracy Participant/Exchange Unix Timestamp. This is the timestamp of when the quote was actually generated at the exchange.
The sequence number represents the sequence in which quote events happened. These are increasing and unique per ticker symbol, but will not always be sequential (e.g., 1, 2, 6, 9, 10, 11). Values reset after each trading session/day.
The nanosecond accuracy SIP Unix Timestamp. This is the timestamp of when the SIP received this quote from the exchange which produced it.
There are 3 tapes which define which exchange the ticker is listed on. These are integers in our objects which represent the letter of the alphabet. Eg: 1 = A, 2 = B, 3 = C.
- Tape A is NYSE listed securities
- Tape B is NYSE ARCA / NYSE American
- Tape C is NASDAQ
The nanosecond accuracy TRF (Trade Reporting Facility) Unix Timestamp. This is the timestamp of when the trade reporting facility received this quote.
The status of this request's response.
{
"next_url": "https://api.polygon.io/v3/quotes/AAPL?cursor=YWN0aXZlPXRydWUmZGF0ZT0yMDIxLTA0LTI1JmxpbWl0PTEmb3JkZXI9YXNjJnBhZ2VfbWFya2VyPUElN0M5YWRjMjY0ZTgyM2E1ZjBiOGUyNDc5YmZiOGE1YmYwNDVkYzU0YjgwMDcyMWE2YmI1ZjBjMjQwMjU4MjFmNGZiJnNvcnQ9dGlja2Vy",
"request_id": "a47d1beb8c11b6ae897ab76cdbbf35a3",
"results": [
{
"ask_exchange": 0,
"ask_price": 0,
"ask_size": 0,
"bid_exchange": 11,
"bid_price": 102.7,
"bid_size": 60,
"conditions": [
1
],
"participant_timestamp": 1517562000065321200,
"sequence_number": 2060,
"sip_timestamp": 1517562000065700400,
"tape": 3
},
{
"ask_exchange": 0,
"ask_price": 0,
"ask_size": 0,
"bid_exchange": 11,
"bid_price": 170,
"bid_size": 2,
"conditions": [
1
],
"participant_timestamp": 1517562000065408300,
"sequence_number": 2061,
"sip_timestamp": 1517562000065791500,
"tape": 3
}
],
"status": "OK"
}The ticker symbol of the stock/equity.
A request id assigned by the server.
The ask price.
The ask size. This represents the number of round lot orders at the given ask price. The normal round lot size is 100 shares. An ask size of 2 means there are 200 shares available to purchase at the given ask price.
The exchange symbol that this item is traded under.
The exchange ID. See Exchanges for Polygon.io's mapping of exchange IDs.
A list of condition codes.
The nanosecond accuracy TRF(Trade Reporting Facility) Unix Timestamp. This is the timestamp of when the trade reporting facility received this message.
A list of indicator codes.
The bid price.
The sequence number represents the sequence in which message events happened. These are increasing and unique per ticker symbol, but will not always be sequential (e.g., 1, 2, 6, 9, 10, 11).
The bid size. This represents the number of round lot orders at the given bid price. The normal round lot size is 100 shares. A bid size of 2 means there are 200 shares for purchase at the given bid price.
The nanosecond accuracy SIP Unix Timestamp. This is the timestamp of when the SIP received this message from the exchange which produced it.
The exchange ID. See Exchanges for Polygon.io's mapping of exchange IDs.
The nanosecond accuracy Participant/Exchange Unix Timestamp. This is the timestamp of when the quote was actually generated at the exchange.
There are 3 tapes which define which exchange the ticker is listed on. These are integers in our objects which represent the letter of the alphabet. Eg: 1 = A, 2 = B, 3 = C.
- Tape A is NYSE listed securities
- Tape B is NYSE ARCA / NYSE American
- Tape C is NASDAQ
The status of this request's response.
{
"request_id": "b84e24636301f19f88e0dfbf9a45ed5c",
"results": {
"P": 127.98,
"S": 7,
"T": "AAPL",
"X": 19,
"p": 127.96,
"q": 83480742,
"s": 1,
"t": 1617827221349730300,
"x": 11,
"y": 1617827221349366000,
"z": 3
},
"status": "OK"
}All Tickers
Get the most up-to-date market data for all traded stock symbols.
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.
A case-sensitive comma separated list of tickers to get snapshots for. For example, AAPL,TSLA,GOOG. Empty string defaults to querying all tickers.
Include OTC securities in the response. Default is false (don't include OTC securities).
The total number of results for this request.
The status of this request's response.
An array of snapshot data for the specified tickers.
The most recent daily bar for this ticker.
The close price for the symbol in the given time period.
The highest price for the symbol in the given time period.
The lowest price for the symbol in the given time period.
The open price for the symbol in the given time period.
Whether or not this aggregate is for an OTC ticker. This field will be left off if false.
The trading volume of the symbol in the given time period.
The volume weighted average price.
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, contact us.
The most recent quote for this ticker. This is only returned if your current plan includes quotes.
The ask price.
The ask size in lots.
The bid price.
The bid size in lots.
The nanosecond accuracy SIP Unix Timestamp. This is the timestamp of when the SIP received this message from the exchange which produced it.
The most recent trade for this ticker. This is only returned if your current plan includes trades.
The trade conditions.
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.
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.
The size (volume) of the trade.
The nanosecond accuracy SIP Unix Timestamp. This is the timestamp of when the SIP received this message from the exchange which produced it.
The exchange ID. See Exchanges for Polygon.io's mapping of exchange IDs.
The most recent minute bar for this ticker.
The accumulated volume.
The close price for the symbol in the given time period.
The highest price for the symbol in the given time period.
The lowest price for the symbol in the given time period.
The number of transactions in the aggregate window.
The open price for the symbol in the given time period.
Whether or not this aggregate is for an OTC ticker. This field will be left off if false.
The Unix millisecond timestamp for the start of the aggregate window.
The trading volume of the symbol in the given time period.
The volume weighted average price.
The previous day's bar for this ticker.
The close price for the symbol in the given time period.
The highest price for the symbol in the given time period.
The lowest price for the symbol in the given time period.
The open price for the symbol in the given time period.
Whether or not this aggregate is for an OTC ticker. This field will be left off if false.
The trading volume of the symbol in the given time period.
The volume weighted average price.
The exchange symbol that this item is traded under.
The value of the change from the previous day.
The percentage change since the previous day.
The last updated timestamp.
{
"count": 1,
"status": "OK",
"tickers": [
{
"day": {
"c": 20.506,
"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
],
"i": "71675577320245",
"p": 20.506,
"s": 2416,
"t": 1605192894630916600,
"x": 4
},
"min": {
"av": 37216,
"c": 20.506,
"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
}
]
}Gainers/Losers
Get the most up-to-date market data for the current top 20 gainers or losers of the day in the stocks/equities markets.
Top gainers are those tickers whose price has increased by the highest percentage since the previous day's close.
Top losers are those tickers whose price has decreased by the highest percentage since the previous day's close.
This output will only include tickers with a trading volume of 10,000 or more.
Note: Snapshot data is cleared at 3:30am EST and gets populated as data is received from the exchanges.
The direction of the snapshot results to return.
Include OTC securities in the response. Default is false (don't include OTC securities).
The status of this request's response.
An array of snapshot data for the specified tickers.
The most recent daily bar for this ticker.
The close price for the symbol in the given time period.
The highest price for the symbol in the given time period.
The lowest price for the symbol in the given time period.
The open price for the symbol in the given time period.
Whether or not this aggregate is for an OTC ticker. This field will be left off if false.
The trading volume of the symbol in the given time period.
The volume weighted average price.
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, contact us.
The most recent quote for this ticker. This is only returned if your current plan includes quotes.
The ask price.
The ask size in lots.
The bid price.
The bid size in lots.
The nanosecond accuracy SIP Unix Timestamp. This is the timestamp of when the SIP received this message from the exchange which produced it.
The most recent trade for this ticker. This is only returned if your current plan includes trades.
The trade conditions.
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.
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.
The size (volume) of the trade.
The nanosecond accuracy SIP Unix Timestamp. This is the timestamp of when the SIP received this message from the exchange which produced it.
The exchange ID. See Exchanges for Polygon.io's mapping of exchange IDs.
The most recent minute bar for this ticker.
The accumulated volume.
The close price for the symbol in the given time period.
The highest price for the symbol in the given time period.
The lowest price for the symbol in the given time period.
The number of transactions in the aggregate window.
The open price for the symbol in the given time period.
Whether or not this aggregate is for an OTC ticker. This field will be left off if false.
The Unix millisecond timestamp for the start of the aggregate window.
The trading volume of the symbol in the given time period.
The volume weighted average price.
The previous day's bar for this ticker.
The close price for the symbol in the given time period.
The highest price for the symbol in the given time period.
The lowest price for the symbol in the given time period.
The open price for the symbol in the given time period.
Whether or not this aggregate is for an OTC ticker. This field will be left off if false.
The trading volume of the symbol in the given time period.
The volume weighted average price.
The exchange symbol that this item is traded under.
The value of the change from the previous day.
The percentage change since the previous day.
The last updated timestamp.
{
"status": "OK",
"tickers": [
{
"day": {
"c": 14.2284,
"h": 15.09,
"l": 14.2,
"o": 14.33,
"v": 133963,
"vw": 14.5311
},
"lastQuote": {
"P": 14.44,
"S": 11,
"p": 14.2,
"s": 25,
"t": 1605195929997325600
},
"lastTrade": {
"c": [
63
],
"i": "79372124707124",
"p": 14.2284,
"s": 536,
"t": 1605195848258266000,
"x": 4
},
"min": {
"av": 133963,
"c": 14.2284,
"h": 14.325,
"l": 14.2,
"n": 5,
"o": 14.28,
"t": 1684428600000,
"v": 6108,
"vw": 14.2426
},
"prevDay": {
"c": 0.73,
"h": 0.799,
"l": 0.73,
"o": 0.75,
"v": 1568097,
"vw": 0.7721
},
"ticker": "PDS",
"todaysChange": 13.498,
"todaysChangePerc": 1849.096,
"updated": 1605195848258266000
}
]
}Ticker
Get the most up-to-date market data for a single traded stock ticker.
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.
Specify a case-sensitive ticker symbol. For example, AAPL represents Apple Inc.
The status of this request's response.
A request id assigned by the server.
Contains the requested snapshot data for the specified ticker.
The most recent daily bar for this ticker.
The close price for the symbol in the given time period.
The highest price for the symbol in the given time period.
The lowest price for the symbol in the given time period.
The open price for the symbol in the given time period.
Whether or not this aggregate is for an OTC ticker. This field will be left off if false.
The trading volume of the symbol in the given time period.
The volume weighted average price.
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, contact us.
The most recent quote for this ticker. This is only returned if your current plan includes quotes.
The ask price.
The ask size in lots.
The bid price.
The bid size in lots.
The nanosecond accuracy SIP Unix Timestamp. This is the timestamp of when the SIP received this message from the exchange which produced it.
The most recent trade for this ticker. This is only returned if your current plan includes trades.
The trade conditions.
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.
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.
The size (volume) of the trade.
The nanosecond accuracy SIP Unix Timestamp. This is the timestamp of when the SIP received this message from the exchange which produced it.
The exchange ID. See Exchanges for Polygon.io's mapping of exchange IDs.
The most recent minute bar for this ticker.
The accumulated volume.
The close price for the symbol in the given time period.
The highest price for the symbol in the given time period.
The lowest price for the symbol in the given time period.
The number of transactions in the aggregate window.
The open price for the symbol in the given time period.
Whether or not this aggregate is for an OTC ticker. This field will be left off if false.
The Unix millisecond timestamp for the start of the aggregate window.
The trading volume of the symbol in the given time period.
The volume weighted average price.
The previous day's bar for this ticker.
The close price for the symbol in the given time period.
The highest price for the symbol in the given time period.
The lowest price for the symbol in the given time period.
The open price for the symbol in the given time period.
Whether or not this aggregate is for an OTC ticker. This field will be left off if false.
The trading volume of the symbol in the given time period.
The volume weighted average price.
The exchange symbol that this item is traded under.
The value of the change from the previous day.
The percentage change since the previous day.
The last updated timestamp.
{
"request_id": "657e430f1ae768891f018e08e03598d8",
"status": "OK",
"ticker": {
"day": {
"c": 120.4229,
"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
],
"i": "4046",
"p": 120.47,
"s": 236,
"t": 1605195918306274000,
"x": 10
},
"min": {
"av": 28724441,
"c": 120.4201,
"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
}
}Comma separated list of tickers, up to a maximum of 250. If no tickers are passed then all results will be returned in a paginated manner.
Warning: The maximum number of characters allowed in a URL are subject to your technology stack.
Query by the type of asset.
Order results based on the sort field.
Limit the number of results returned, default is 10 and max is 250.
Sort field used for ordering.
If present, this value can be used to fetch the next page of data.
A request id assigned by the server.
An array of results containing the requested data.
The price of the underlying asset for the contract to break even. For a call, this value is (strike price + premium paid). For a put, this value is (strike price - premium paid).
The details for this contract.
The type of contract. Can be "put", "call", or in some rare cases, "other".
The exercise style of this contract. See this link for more details on exercise styles.
The contract's expiration date in YYYY-MM-DD format.
The number of shares per contract for this contract.
The strike price of the option contract.
The error while looking for this ticker.
Fair market value is only available on Business plans. It's it our proprietary algorithm to generate a real-time, accurate, fair market value of a tradable security. For more information, contact us.
The greeks for this contract. There are certain circumstances where greeks will not be returned, such as options contracts that are deep in the money. See this article for more information.
The change in the option's price per $0.01 increment in the price of the underlying asset.
The change in delta per $0.01 change in the price of the underlying asset.
The change in the option's price per day.
The change in the option's price per 1% increment in volatility.
The market's forecast for the volatility of the underlying asset, based on this option's current price.
The most recent quote for this contract. This is only returned if your current plan includes quotes.
The ask price.
The ask side exchange ID. See Exchanges for Polygon.io's mapping of exchange IDs.
The ask size. This represents the number of round lot orders at the given ask price. The normal round lot size is 100 shares. An ask size of 2 means there are 200 shares available to purchase at the given ask price.
The bid price.
The bid side exchange ID. See Exchanges for Polygon.io's mapping of exchange IDs.
The bid size. This represents the number of round lot orders at the given bid price. The normal round lot size is 100 shares. A bid size of 2 means there are 200 shares for purchase at the given bid price.
The nanosecond timestamp of when this information was updated.
The average of the bid and ask price.
The time relevance of the data.
The most recent quote for this contract. This is only returned if your current plan includes trades.
A list of condition codes.
The exchange ID. See Exchanges for Polygon.io's mapping of exchange IDs.
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.
The nanosecond timestamp of when this information was updated.
The nanosecond Exchange Unix Timestamp. This is the timestamp of when the trade was generated at the exchange.
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.
The nanosecond accuracy SIP Unix Timestamp. This is the timestamp of when the SIP received this trade from the exchange which produced it.
The size of a trade (also known as volume).
The time relevance of the data.
The market status for the market that trades this ticker. Possible values for stocks, options, crypto, and forex snapshots are open, closed, early_trading, or late_trading. Possible values for indices snapshots are regular_trading, closed, early_trading, and late_trading.
The error message while looking for this ticker.
The name of this contract.
The quantity of this contract held at the end of the last trading day.
Comprehensive trading session metrics, detailing price changes, trading volume, and key price points (open, close, high, low) for the asset within the current trading day. Includes specific changes during early, regular, and late trading periods to enable detailed performance analysis and trend tracking.
The value of the price change for the asset from the previous trading day.
The percent of the price change for the asset from the previous trading day.
The closing price of the asset for the day.
Today's early trading change amount, difference between price and previous close if in early trading hours, otherwise difference between last price during early trading and previous close.
Today's early trading change as a percentage.
The highest price of the asset for the day.
Today's late trading change amount, difference between price and today's close if in late trading hours, otherwise difference between last price during late trading and today's close.
Today's late trading change as a percentage.
The lowest price of the asset for the day.
The open price of the asset for the day.
The closing price of the asset for the previous trading day.
The price of the most recent trade or bid price for this asset.
Today's change in regular trading hours, difference between current price and previous trading day's close, otherwise difference between today's close and previous day's close.
Today's regular trading change as a percentage.
The trading volume for the asset for the day.
The ticker symbol for the asset.
The asset class for this ticker.
Information on the underlying stock for this options contract. The market data returned depends on your current stocks plan.
The change in price for the contract to break even.
The nanosecond timestamp of when this information was updated.
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.
The ticker symbol for the contract's underlying asset.
The time relevance of the data.
The value of the underlying index.
Value of Index.
The status of this request's response.
{
"request_id": "abc123",
"results": [
{
"break_even_price": 171.075,
"details": {
"contract_type": "call",
"exercise_style": "american",
"expiration_date": "2022-10-14",
"shares_per_contract": 100,
"strike_price": 5,
"underlying_ticker": "NCLH"
},
"fmv": 0.05,
"greeks": {
"delta": 0.5520187372272933,
"gamma": 0.00706756515659829,
"theta": -0.018532772783847958,
"vega": 0.7274811132998142
},
"implied_volatility": 0.3048997097864957,
"last_quote": {
"ask": 21.25,
"ask_exchange": 12,
"ask_size": 110,
"bid": 20.9,
"bid_exchange": 10,
"bid_size": 172,
"last_updated": 1636573458756383500,
"midpoint": 21.075,
"timeframe": "REAL-TIME"
},
"last_trade": {
"conditions": [
209
],
"exchange": 316,
"price": 0.05,
"sip_timestamp": 1675280958783136800,
"size": 2,
"timeframe": "REAL-TIME"
},
"market_status": "closed",
"name": "NCLH $5 Call",
"open_interest": 8921,
"session": {
"change": -0.05,
"change_percent": -1.07,
"close": 6.65,
"early_trading_change": -0.01,
"early_trading_change_percent": -0.03,
"high": 7.01,
"late_trading_change": -0.4,
"late_trading_change_percent": -0.02,
"low": 5.42,
"open": 6.7,
"previous_close": 6.71,
"regular_trading_change": -0.6,
"regular_trading_change_percent": -0.5,
"volume": 67
},
"ticker": "O:NCLH221014C00005000",
"type": "options",
"underlying_asset": {
"change_to_break_even": 23.123999999999995,
"last_updated": 1636573459862384600,
"price": 147.951,
"ticker": "AAPL",
"timeframe": "REAL-TIME"
}
},
{
"fmv": 0.05,
"last_minute": {
"close": 412.05,
"high": 412.1,
"low": 412.05,
"open": 412.1,
"transactions": 26,
"volume": 610,
"vwap": 412.0881
},
"last_quote": {
"ask": 21.25,
"ask_exchange": 300,
"ask_size": 110,
"bid": 20.9,
"bid_exchange": 323,
"bid_size": 172,
"last_updated": 1636573458756383500,
"timeframe": "REAL-TIME"
},
"last_trade": {
"conditions": [
209
],
"exchange": 316,
"id": "4064",
"last_updated": 1675280958783136800,
"price": 0.05,
"size": 2,
"timeframe": "REAL-TIME"
},
"market_status": "closed",
"name": "Apple Inc.",
"session": {
"change": -1.05,
"change_percent": -4.67,
"close": 21.4,
"early_trading_change": -0.39,
"early_trading_change_percent": -0.07,
"high": 22.49,
"late_trading_change": 1.2,
"late_trading_change_percent": 3.92,
"low": 21.35,
"open": 22.49,
"previous_close": 22.45,
"volume": 37
},
"ticker": "AAPL",
"type": "stocks"
},
{
"error": "NOT_FOUND",
"message": "Ticker not found.",
"ticker": "TSLAAPL"
}
],
"status": "OK"
}Simple Moving Average (SMA)
Get the simple moving average (SMA) for a ticker symbol over a given time range.
Specify a case-sensitive ticker symbol for which to get simple moving average (SMA) data. For example, AAPL represents Apple Inc.
Query by timestamp. Either a date with the format YYYY-MM-DD or a millisecond timestamp.
The size of the aggregate time window.
Whether or not the aggregates used to calculate the simple moving average are adjusted for splits. By default, aggregates are adjusted. Set this to false to get results that are NOT adjusted for splits.
The window size used to calculate the simple moving average (SMA). i.e. a window size of 10 with daily aggregates would result in a 10 day moving average.
The price in the aggregate which will be used to calculate the simple moving average. i.e. 'close' will result in using close prices to calculate the simple moving average (SMA).
Whether or not to include the aggregates used to calculate this indicator in the response.
The order in which to return the results, ordered by timestamp.
Limit the number of results returned, default is 10 and max is 5000
If present, this value can be used to fetch the next page of data.
A request id assigned by the server.
The results of the SMA indicator calculation.
The underlying aggregates used.
The array of aggregates used in the calculation of this indicator.
The close price for the symbol in the given time period.
The highest price for the symbol in the given time period.
The lowest price for the symbol in the given time period.
The number of transactions in the aggregate window.
The open price for the symbol in the given time period.
Whether or not this aggregate is for an OTC ticker. This field will be left off if false.
The Unix Msec timestamp for the start of the aggregate window.
The trading volume of the symbol in the given time period.
The volume weighted average price.
The URL which can be used to request the underlying aggregates used in this request.
Timestamp or indicator value.
The Unix Msec timestamp from the last aggregate used in this calculation.
The MACD line value, calculated as the difference between the short-term and long-term exponential moving averages (EMAs) based on the periods specified in the request parameters.
The status of this request's response.
{
"next_url": "https://api.polygon.io/v1/indicators/sma/AAPL?cursor=YWN0aXZlPXRydWUmZGF0ZT0yMDIxLTA0LTI1JmxpbWl0PTEmb3JkZXI9YXNjJnBhZ2VfbWFya2VyPUElN0M5YWRjMjY0ZTgyM2E1ZjBiOGUyNDc5YmZiOGE1YmYwNDVkYzU0YjgwMDcyMWE2YmI1ZjBjMjQwMjU4MjFmNGZiJnNvcnQ9dGlja2Vy",
"request_id": "a47d1beb8c11b6ae897ab76cdbbf35a3",
"results": {
"underlying": {
"aggregates": [
{
"c": 75.0875,
"h": 75.15,
"l": 73.7975,
"n": 1,
"o": 74.06,
"t": 1577941200000,
"v": 135647456,
"vw": 74.6099
},
{
"c": 74.3575,
"h": 75.145,
"l": 74.125,
"n": 1,
"o": 74.2875,
"t": 1578027600000,
"v": 146535512,
"vw": 74.7026
}
],
"url": "https://api.polygon.io/v2/aggs/ticker/AAPL/range/1/day/2003-01-01/2022-07-25"
},
"values": [
{
"timestamp": 1517562000016,
"value": 140.139
}
]
},
"status": "OK"
}Exponential Moving Average (EMA)
Get the exponential moving average (EMA) for a ticker symbol over a given time range.
Specify a case-sensitive ticker symbol for which to get exponential moving average (EMA) data. For example, AAPL represents Apple Inc.
Query by timestamp. Either a date with the format YYYY-MM-DD or a millisecond timestamp.
The size of the aggregate time window.
Whether or not the aggregates used to calculate the exponential moving average are adjusted for splits. By default, aggregates are adjusted. Set this to false to get results that are NOT adjusted for splits.
The window size used to calculate the exponential moving average (EMA). i.e. a window size of 10 with daily aggregates would result in a 10 day moving average.
The price in the aggregate which will be used to calculate the exponential moving average. i.e. 'close' will result in using close prices to calculate the exponential moving average (EMA).
Whether or not to include the aggregates used to calculate this indicator in the response.
The order in which to return the results, ordered by timestamp.
Limit the number of results returned, default is 10 and max is 5000
If present, this value can be used to fetch the next page of data.
A request id assigned by the server.
The results of the EMA indicator calculation.
The underlying aggregates used.
The array of aggregates used in the calculation of this indicator.
The close price for the symbol in the given time period.
The highest price for the symbol in the given time period.
The lowest price for the symbol in the given time period.
The number of transactions in the aggregate window.
The open price for the symbol in the given time period.
Whether or not this aggregate is for an OTC ticker. This field will be left off if false.
The Unix Msec timestamp for the start of the aggregate window.
The trading volume of the symbol in the given time period.
The volume weighted average price.
The URL which can be used to request the underlying aggregates used in this request.
Timestamp or indicator value.
The Unix Msec timestamp from the last aggregate used in this calculation.
The MACD line value, calculated as the difference between the short-term and long-term exponential moving averages (EMAs) based on the periods specified in the request parameters.
The status of this request's response.
{
"next_url": "https://api.polygon.io/v1/indicators/ema/AAPL?cursor=YWN0aXZlPXRydWUmZGF0ZT0yMDIxLTA0LTI1JmxpbWl0PTEmb3JkZXI9YXNjJnBhZ2VfbWFya2VyPUElN0M5YWRjMjY0ZTgyM2E1ZjBiOGUyNDc5YmZiOGE1YmYwNDVkYzU0YjgwMDcyMWE2YmI1ZjBjMjQwMjU4MjFmNGZiJnNvcnQ9dGlja2Vy",
"request_id": "a47d1beb8c11b6ae897ab76cdbbf35a3",
"results": {
"underlying": {
"url": "https://api.polygon.io/v2/aggs/ticker/AAPL/range/1/day/2003-01-01/2022-07-25"
},
"values": [
{
"timestamp": 1517562000016,
"value": 140.139
}
]
},
"status": "OK"
}Moving Average Convergence/Divergence (MACD)
Get moving average convergence/divergence (MACD) data for a ticker symbol over a given time range.
Specify a case-sensitive ticker symbol for which to get moving average convergence/divergence (MACD) data. For example, AAPL represents Apple Inc.
Query by timestamp. Either a date with the format YYYY-MM-DD or a millisecond timestamp.
The size of the aggregate time window.
Whether or not the aggregates used to calculate the MACD are adjusted for splits. By default, aggregates are adjusted. Set this to false to get results that are NOT adjusted for splits.
The short window size used to calculate MACD data.
The long window size used to calculate MACD data.
The window size used to calculate the MACD signal line.
The price in the aggregate which will be used to calculate the MACD. i.e. 'close' will result in using close prices to calculate the MACD.
Whether or not to include the aggregates used to calculate this indicator in the response.
The order in which to return the results, ordered by timestamp.
Limit the number of results returned, default is 10 and max is 5000
If present, this value can be used to fetch the next page of data.
A request id assigned by the server.
The results of the MACD indicator calculation.
The underlying aggregates used.
The array of aggregates used in the calculation of this indicator.
The close price for the symbol in the given time period.
The highest price for the symbol in the given time period.
The lowest price for the symbol in the given time period.
The number of transactions in the aggregate window.
The open price for the symbol in the given time period.
Whether or not this aggregate is for an OTC ticker. This field will be left off if false.
The Unix Msec timestamp for the start of the aggregate window.
The trading volume of the symbol in the given time period.
The volume weighted average price.
The URL which can be used to request the underlying aggregates used in this request.
Each entry in the values array represents MACD indicator data for a specific timestamp and includes:
The difference between the MACD line (value) and the signal line (signal). Positive histogram values indicate upward (bullish) momentum, while negative histogram values indicate downward (bearish) momentum.
The signal line value, calculated as the exponential moving average (EMA) of the MACD line (value) over the signal period defined in the request parameters. Traders typically use crossovers between the MACD and signal lines as trading signals.
The Unix Msec timestamp from the last aggregate used in this calculation.
The MACD line value, calculated as the difference between the short-term and long-term exponential moving averages (EMAs) based on the periods specified in the request parameters.
The status of this request's response.
{
"next_url": "https://api.polygon.io/v1/indicators/macd/AAPL?cursor=YWN0aXZlPXRydWUmZGF0ZT0yMDIxLTA0LTI1JmxpbWl0PTEmb3JkZXI9YXNjJnBhZ2VfbWFya2VyPUElN0M5YWRjMjY0ZTgyM2E1ZjBiOGUyNDc5YmZiOGE1YmYwNDVkYzU0YjgwMDcyMWE2YmI1ZjBjMjQwMjU4MjFmNGZiJnNvcnQ9dGlja2Vy",
"request_id": "a47d1beb8c11b6ae897ab76cdbbf35a3",
"results": {
"underlying": {
"url": "https://api.polygon.io/v2/aggs/ticker/AAPL/range/1/day/2003-01-01/2022-07-25"
},
"values": [
{
"histogram": 38.3801666667,
"signal": 106.9811666667,
"timestamp": 1517562000016,
"value": 145.3613333333
},
{
"histogram": 41.098859136,
"signal": 102.7386283473,
"timestamp": 1517562001016,
"value": 143.8374874833
}
]
},
"status": "OK"
}Relative Strength Index (RSI)
Get the relative strength index (RSI) for a ticker symbol over a given time range.
Specify a case-sensitive ticker symbol for which to get relative strength index (RSI) data. For example, AAPL represents Apple Inc.
Query by timestamp. Either a date with the format YYYY-MM-DD or a millisecond timestamp.
The size of the aggregate time window.
Whether or not the aggregates used to calculate the relative strength index are adjusted for splits. By default, aggregates are adjusted. Set this to false to get results that are NOT adjusted for splits.
The window size used to calculate the relative strength index (RSI).
The price in the aggregate which will be used to calculate the relative strength index. i.e. 'close' will result in using close prices to calculate the relative strength index (RSI).
Whether or not to include the aggregates used to calculate this indicator in the response.
The order in which to return the results, ordered by timestamp.
Limit the number of results returned, default is 10 and max is 5000
If present, this value can be used to fetch the next page of data.
A request id assigned by the server.
The results of the RSI indicator calculation.
The underlying aggregates used.
The array of aggregates used in the calculation of this indicator.
The close price for the symbol in the given time period.
The highest price for the symbol in the given time period.
The lowest price for the symbol in the given time period.
The number of transactions in the aggregate window.
The open price for the symbol in the given time period.
Whether or not this aggregate is for an OTC ticker. This field will be left off if false.
The Unix Msec timestamp for the start of the aggregate window.
The trading volume of the symbol in the given time period.
The volume weighted average price.
The URL which can be used to request the underlying aggregates used in this request.
Timestamp or indicator value.
The Unix Msec timestamp from the last aggregate used in this calculation.
The MACD line value, calculated as the difference between the short-term and long-term exponential moving averages (EMAs) based on the periods specified in the request parameters.
The status of this request's response.
{
"next_url": "https://api.polygon.io/v1/indicators/rsi/AAPL?cursor=YWN0aXZlPXRydWUmZGF0ZT0yMDIxLTA0LTI1JmxpbWl0PTEmb3JkZXI9YXNjJnBhZ2VfbWFya2VyPUElN0M5YWRjMjY0ZTgyM2E1ZjBiOGUyNDc5YmZiOGE1YmYwNDVkYzU0YjgwMDcyMWE2YmI1ZjBjMjQwMjU4MjFmNGZiJnNvcnQ9dGlja2Vy",
"request_id": "a47d1beb8c11b6ae897ab76cdbbf35a3",
"results": {
"underlying": {
"url": "https://api.polygon.io/v2/aggs/ticker/AAPL/range/1/day/2003-01-01/2022-07-25"
},
"values": [
{
"timestamp": 1517562000016,
"value": 82.19
}
]
},
"status": "OK"
}The futures contract identifier, including the base symbol and contract expiration (e.g., ESZ4 for the December 2024 S&P 500 E-mini contract).
Query by trade timestamp. Either a date with the format YYYY-MM-DD or a nanosecond timestamp.
Query by session end date
Order results based on the sort field.
Limit the number of results returned, default is 1000 and max is 50000.
Sort field used for ordering.
If present, this value can be used to fetch the next page of data.
The ask price is expressed per unit of the underlying asset, and you apply the contract multiplier to get the full contract value.
The quote size represents the number of futures contracts available at the given ask price.
The Unix millisecond timestamp.
The bid price is expressed per unit of the underlying asset, and you apply the contract multiplier to get the full contract value.
The quote size represents the number of futures contracts available at the given bid price.
The Unix millisecond timestamp.
Session end date
ticker of the quote
The Unix millisecond timestamp.
The status of this request's response.
{
"request_id": "a47d1beb8c11b6ae897ab76cdbbf35a3",
"results": [
{
"ask_price": 604075,
"ask_size": 6,
"ask_timestamp": 1734467086235923000,
"bid_price": 604075,
"bid_size": 6,
"bid_timestamp": 1734415473057885400,
"session_end_date": "2024-12-17",
"ticker": "ESZ4",
"timestamp": 1734476400002853000
},
{
"ask_price": 604100,
"ask_size": 2,
"ask_timestamp": 1734466901129138400,
"bid_price": 604100,
"bid_size": 2,
"bid_timestamp": 1734415473057885400,
"session_end_date": "2024-12-17",
"ticker": "ESZ4",
"timestamp": 1734466901128680000
}
],
"status": "OK"
}The futures contract identifier, including the base symbol and contract expiration (e.g., ESZ4 for the December 2024 S&P 500 E-mini contract).
Query by trade timestamp. Either a date with the format YYYY-MM-DD or a nanosecond timestamp.
Query by session end date
Order results based on the sort field.
Limit the number of results returned, default is 1000 and max is 50000.
Sort field used for ordering.
If present, this value can be used to fetch the next page of data.
The trade price is quoted per unit of the underlying asset, with the total contract value determined by multiplying by the contract’s specific multiplier.
the session end date
The trade size shows the number of futures contracts actually exchanged.
ticker of the trade
The Unix millisecond timestamp.
The status of this request's response.
{
"request_id": "a47d1beb8c11b6ae897ab76cdbbf35a3",
"results": [
{
"price": 605400,
"session_end_date": "2024-12-17",
"size": 12,
"ticker": "ESZ4",
"timestamp": 1734484219379895800
},
{
"price": 605412,
"session_end_date": "2024-12-17",
"size": 55,
"ticker": "ESZ4",
"timestamp": 1734484212100118500
},
{
"price": 605544,
"session_end_date": "2024-12-17",
"size": 36,
"ticker": "ESZ4",
"timestamp": 1734484212099944200
}
],
"status": "OK"
}Tickers
Query all ticker symbols which are supported by Polygon.io. This API currently includes Stocks/Equities, Indices, Forex, and Crypto.
Specify a ticker symbol. Defaults to empty string which queries all tickers.
Specify the type of the tickers. Find the types that we support via our Ticker Types API. Defaults to empty string which queries all types.
Filter by market type. By default all markets are included.
Specify the primary exchange of the asset in the ISO code format. Find more information about the ISO codes at the ISO org website. Defaults to empty string which queries all exchanges.
Specify the CUSIP code of the asset you want to search for. Find more information about CUSIP codes at their website. Defaults to empty string which queries all CUSIPs.
Note: Although you can query by CUSIP, due to legal reasons we do not return the CUSIP in the response.
Specify the CIK of the asset you want to search for. Find more information about CIK codes at their website. Defaults to empty string which queries all CIKs.
Specify a point in time to retrieve tickers available on that date. Defaults to the most recent available date.
Search for terms within the ticker and/or company name.
Specify if the tickers returned should be actively traded on the queried date. Default is true.
Order results based on the sort field.
Limit the number of results returned, default is 100 and max is 1000.
Sort field used for ordering.
The total number of results for this request.
If present, this value can be used to fetch the next page of data.
A request id assigned by the server.
An array of tickers that match your query.
Note: Although you can query by CUSIP, due to legal reasons we do not return the CUSIP in the response.
Whether or not the asset is actively traded. False means the asset has been delisted.
The CIK number for this ticker. Find more information here.
The composite OpenFIGI number for this ticker. Find more information here
The name of the currency that this asset is traded with.
The last date that the asset was traded.
The information is accurate up to this time.
The locale of the asset.
The market type of the asset.
The name of the asset. For stocks/equities this will be the companies registered name. For crypto/fx this will be the name of the currency or coin pair.
The ISO code of the primary listing exchange for this asset.
The share Class OpenFIGI number for this ticker. Find more information here
The exchange symbol that this item is traded under.
The type of the asset. Find the types that we support via our Ticker Types API.
The status of this request's response.
{
"count": 1,
"next_url": "https://api.polygon.io/v3/reference/tickers?cursor=YWN0aXZlPXRydWUmZGF0ZT0yMDIxLTA0LTI1JmxpbWl0PTEmb3JkZXI9YXNjJnBhZ2VfbWFya2VyPUElN0M5YWRjMjY0ZTgyM2E1ZjBiOGUyNDc5YmZiOGE1YmYwNDVkYzU0YjgwMDcyMWE2YmI1ZjBjMjQwMjU4MjFmNGZiJnNvcnQ9dGlja2Vy",
"request_id": "e70013d92930de90e089dc8fa098888e",
"results": [
{
"active": true,
"cik": "0001090872",
"composite_figi": "BBG000BWQYZ5",
"currency_name": "usd",
"last_updated_utc": "2021-04-25T00:00:00Z",
"locale": "us",
"market": "stocks",
"name": "Agilent Technologies Inc.",
"primary_exchange": "XNYS",
"share_class_figi": "BBG001SCTQY4",
"ticker": "A",
"type": "CS"
}
],
"status": "OK"
}Ticker Details v3
Get a single ticker supported by Polygon.io. This response will have detailed information about the ticker and the company behind it.
The ticker symbol of the asset.
Specify a point in time to get information about the ticker available on that date. When retrieving information from SEC filings, we compare this date with the period of report date on the SEC filing.
For example, consider an SEC filing submitted by AAPL on 2019-07-31, with a period of report date ending on 2019-06-29. That means that the filing was submitted on 2019-07-31, but the filing was created based on information from 2019-06-29. If you were to query for AAPL details on 2019-06-29, the ticker details would include information from the SEC filing.
Defaults to the most recent available date.
The total number of results for this request.
A request id assigned by the server.
Ticker with details.
Whether or not the asset is actively traded. False means the asset has been delisted.
Company headquarters address details.
The first line of the company's headquarters address.
The second line of the company's headquarters address, if applicable.
The city of the company's headquarters address.
The postal code of the company's headquarters address.
The state of the company's headquarters address.
Provides URLs aiding in visual identification.
A link to this ticker's company's icon. Icon's are generally smaller, square images that represent the company at a glance. Note that you must provide an API key when accessing this URL. See the "Authentication" section at the top of this page for more details.
A link to this ticker's company's logo. Note that you must provide an API key when accessing this URL. See the "Authentication" section at the top of this page for more details.
The CIK number for this ticker. Find more information here.
The composite OpenFIGI number for this ticker. Find more information here
The name of the currency that this asset is traded with.
The last date that the asset was traded.
A description of the company and what they do/offer.
The URL of the company's website homepage.
The date that the symbol was first publicly listed in the format YYYY-MM-DD.
The locale of the asset.
The market type of the asset.
The most recent close price of the ticker multiplied by weighted outstanding shares.
The name of the asset. For stocks/equities this will be the companies registered name. For crypto/fx this will be the name of the currency or coin pair.
The phone number for the company behind this ticker.
The ISO code of the primary listing exchange for this asset.
Round lot size of this security.
The share Class OpenFIGI number for this ticker. Find more information here
The recorded number of outstanding shares for this particular share class.
The standard industrial classification code for this ticker. For a list of SIC Codes, see the SEC's SIC Code List.
A description of this ticker's SIC code.
The exchange symbol that this item is traded under.
The root of a specified ticker. For example, the root of BRK.A is BRK.
The suffix of a specified ticker. For example, the suffix of BRK.A is A.
The approximate number of employees for the company.
The type of the asset. Find the types that we support via our Ticker Types API.
The shares outstanding calculated assuming all shares of other share classes are converted to this share class.
The status of this request's response.
{
"request_id": "31d59dda-80e5-4721-8496-d0d32a654afe",
"results": {
"active": true,
"address": {
"address1": "One Apple Park Way",
"city": "Cupertino",
"postal_code": "95014",
"state": "CA"
},
"branding": {
"icon_url": "https://api.polygon.io/v1/reference/company-branding/d3d3LmFwcGxlLmNvbQ/images/2022-01-10_icon.png",
"logo_url": "https://api.polygon.io/v1/reference/company-branding/d3d3LmFwcGxlLmNvbQ/images/2022-01-10_logo.svg"
},
"cik": "0000320193",
"composite_figi": "BBG000B9XRY4",
"currency_name": "usd",
"description": "Apple designs a wide variety of consumer electronic devices, including smartphones (iPhone), tablets (iPad), PCs (Mac), smartwatches (Apple Watch), AirPods, and TV boxes (Apple TV), among others. The iPhone makes up the majority of Apple's total revenue. In addition, Apple offers its customers a variety of services such as Apple Music, iCloud, Apple Care, Apple TV+, Apple Arcade, Apple Card, and Apple Pay, among others. Apple's products run internally developed software and semiconductors, and the firm is well known for its integration of hardware, software and services. Apple's products are distributed online as well as through company-owned stores and third-party retailers. The company generates roughly 40% of its revenue from the Americas, with the remainder earned internationally.",
"homepage_url": "https://www.apple.com",
"list_date": "1980-12-12",
"locale": "us",
"market": "stocks",
"market_cap": 2771126040150,
"name": "Apple Inc.",
"phone_number": "(408) 996-1010",
"primary_exchange": "XNAS",
"round_lot": 100,
"share_class_figi": "BBG001S5N8V8",
"share_class_shares_outstanding": 16406400000,
"sic_code": "3571",
"sic_description": "ELECTRONIC COMPUTERS",
"ticker": "AAPL",
"ticker_root": "AAPL",
"total_employees": 154000,
"type": "CS",
"weighted_shares_outstanding": 16334371000
},
"status": "OK"
}Ticker Events
Get a timeline of events for the entity associated with the given ticker, CUSIP, or Composite FIGI.
Identifier of an asset. This can currently be a Ticker, CUSIP, or Composite FIGI. When given a ticker, we return events for the entity currently represented by that ticker. To find events for entities previously associated with a ticker, find the relevant identifier using the Ticker Details Endpoint
A comma-separated list of the types of event to include. Currently ticker_change is the only supported event_type. Leave blank to return all supported event_types.
A request id assigned by the server.
Contains the requested event data for the specified ticker.
An array of event containing the requested data.
The name of the asset.
The status of this request's response.
{
"request_id": "31d59dda-80e5-4721-8496-d0d32a654afe",
"results": {
"events": [
{
"date": "2022-06-09",
"ticker_change": {
"ticker": "META"
},
"type": "ticker_change"
},
{
"date": "2012-05-18",
"ticker_change": {
"ticker": "FB"
},
"type": "ticker_change"
}
],
"name": "Meta Platforms, Inc. Class A Common Stock"
},
"status": "OK"
}Ticker News
Get the most recent news articles relating to a stock ticker symbol, including a summary of the article and a link to the original source.
Specify a case-sensitive ticker symbol. For example, AAPL represents Apple Inc.
Return results published on, before, or after this date.
Order results based on the sort field.
Limit the number of results returned, default is 10 and max is 1000.
Sort field used for ordering.
The total number of results for this request.
If present, this value can be used to fetch the next page of data.
A request id assigned by the server.
An array of results containing the requested data.
The mobile friendly Accelerated Mobile Page (AMP) URL.
A link to the news article.
The article's author.
A description of the article.
Unique identifier for the article.
The article's image URL.
The insights related to the article.
The sentiment of the insight.
The reasoning behind the sentiment.
The ticker symbol associated with the insight.
The keywords associated with the article (which will vary depending on the publishing source).
The UTC date and time when the article was published, formatted in RFC3339 standard (e.g. YYYY-MM-DDTHH:MM:SSZ).
Details the source of the news article, including the publisher's name, logo, and homepage URLs. This information helps users identify and access the original source of news content.
The publisher's homepage favicon URL.
The publisher's homepage URL.
The publisher's logo URL.
The publisher's name.
The ticker symbols associated with the article.
The title of the news article.
The status of this request's response.
{
"count": 1,
"next_url": "https://api.polygon.io:443/v2/reference/news?cursor=eyJsaW1pdCI6MSwic29ydCI6InB1Ymxpc2hlZF91dGMiLCJvcmRlciI6ImFzY2VuZGluZyIsInRpY2tlciI6e30sInB1Ymxpc2hlZF91dGMiOnsiZ3RlIjoiMjAyMS0wNC0yNiJ9LCJzZWFyY2hfYWZ0ZXIiOlsxNjE5NDA0Mzk3MDAwLG51bGxdfQ",
"request_id": "831afdb0b8078549fed053476984947a",
"results": [
{
"amp_url": "https://m.uk.investing.com/news/stock-market-news/markets-are-underestimating-fed-cuts-ubs-3559968?ampMode=1",
"article_url": "https://uk.investing.com/news/stock-market-news/markets-are-underestimating-fed-cuts-ubs-3559968",
"author": "Sam Boughedda",
"description": "UBS analysts warn that markets are underestimating the extent of future interest rate cuts by the Federal Reserve, as the weakening economy is likely to justify more cuts than currently anticipated.",
"id": "8ec638777ca03b553ae516761c2a22ba2fdd2f37befae3ab6fdab74e9e5193eb",
"image_url": "https://i-invdn-com.investing.com/news/LYNXNPEC4I0AL_L.jpg",
"insights": [
{
"sentiment": "positive",
"sentiment_reasoning": "UBS analysts are providing a bullish outlook on the extent of future Federal Reserve rate cuts, suggesting that markets are underestimating the number of cuts that will occur.",
"ticker": "UBS"
}
],
"keywords": [
"Federal Reserve",
"interest rates",
"economic data"
],
"published_utc": "2024-06-24T18:33:53Z",
"publisher": {
"favicon_url": "https://s3.polygon.io/public/assets/news/favicons/investing.ico",
"homepage_url": "https://www.investing.com/",
"logo_url": "https://s3.polygon.io/public/assets/news/logos/investing.png",
"name": "Investing.com"
},
"tickers": [
"UBS"
],
"title": "Markets are underestimating Fed cuts: UBS By Investing.com - Investing.com UK"
}
],
"status": "OK"
}Filter by asset class.
Filter by locale.
The total number of results for this request.
A request ID assigned by the server.
An array of results containing the requested data.
An identifier for a group of similar financial instruments.
A code used by Polygon.io to refer to this ticker type.
A short description of this ticker type.
An identifier for a geographical location.
The status of this request's response.
{
"count": 1,
"request_id": "31d59dda-80e5-4721-8496-d0d32a654afe",
"results": [
{
"asset_class": "stocks",
"code": "CS",
"description": "Common Stock",
"locale": "us"
}
],
"status": "OK"
}Ticker Taxonomies
Many investors place a high value on sector data. It is used to measure economic activity, identify peers and competitors, build ETF products, quantify market share, and compare company performance. However, there are some limitations to industry standard sectors:
- They have difficulty identifying the primary area of activity for large, complex businesses.
- Studies confirm significant disagreement between classification schemes when attempting to categorize the same companies.
- The systems' hierarchical nature is inflexible and struggles to convey business nuances.
As a result, we've developed a new taxonomy to supplement existing sector classifications. The taxonomy is created by reviewing related 10K filings to create a set of structured categories and tags.
The categories are based on company operating models and are industry agnostic. Our current version only supports one category, Revenue Streams, with future plans to support more.
The tags define a specific type within the category. Within the Revenue Streams category, for example, tags for "product sales" and "advertising" may be found. A company may have many tags in a given category. The complete Revenue Streams taxonomy is shown below.
Our taxonomy is powered by AI and is currently in early beta testing. You should expect some inaccuracies in the responses.
Revenue Streams
Latest Revision (7/7/2023)
- Physical Product Sales:
Revenue generated from the sale of tangible goods or physical products to customers, either in-store or online.
- Consumer Goods
- Industrial Goods
- Electronics
- Vehicles
- Healthcare Products
- Digital Product Sales:
Revenue earned from the sale of digital goods or products, such as software licenses, e-books, music downloads, or digital media content. It also includes revenue obtained by selling aggregated, anonymized, or processed data to third parties for market research, analytics, or other purposes.
- Software
- E-books and Digital Media
- Mobile Applications
- Games
- Online Courses
- Market Research Data
- Customer Behavior Data
- Professional Services:
Revenue obtained by providing specialized services, expertise, or consulting to clients in exchange for fees. This includes services offered by professionals such as lawyers, accountants, or consultants.
- Consulting
- Legal Services
- Financial Services
- Marketing Services
- Construction Services
- Education & Tutoring
- Consumer Services:
Revenue earned from providing services directly to consumers, including services like healthcare, personal grooming, fitness, or hospitality.
- Dining & Hospitality
- Personal Care
- Entertainment & Recreation
- Fitness & Wellness
- Travel & Tourism
- Transportation
- Home Services
- Child & Family Care
- Automotive
- Subscription-based Revenue:
Revenue obtained from recurring fees charged to customers for accessing a product or service over a defined period. This includes revenue from subscription-based models, membership programs, or software-as-a-service (SaaS) offerings.
- Software as a Service (SaaS)
- Streaming Services
- Physical Media
- Memberships
- Licensing and Royalties:
Revenue generated from the licensing of intellectual property rights to third parties, including franchise rights, patent licensing, brand licensing, and the receipt of royalties for authorized use of intellectual property like music royalties, book royalties, or patent royalties.
- Franchise Fees
- Patent Licensing
- Brand Licensing
- Media Royalties
- Advertising:
Revenue generated by displaying ads or promotional content to customers, whether through traditional or digital advertising channels, including revenue from display ads, sponsored content, or affiliate marketing.
- Print Advertising
- Online Display Advertising
- Social Media Advertising
- Influencer Marketing
- Commission-Based Revenue:
Revenue earned by acting as an intermediary and receiving a percentage or commission on sales made on behalf of another party. This includes revenue from affiliate programs, referral fees, or any other commission-based revenue models.
- Real Estate Commissions
- Affiliate Marketing Commissions
- Online Marketplace Commissions
- Rentals or Leasing:
Revenue earned by leasing or renting out assets, properties, or equipment to customers, including rental income from real estate properties, equipment leasing, or vehicle rentals.
- Property Rentals
- Equipment Leasing
- Vehicle Rentals
Comma separated list of tickers, up to a maximum of 250.
Warning: The maximum number of characters allowed in a URL are subject to your own technology stack.
Filter by taxonomy category. The current version of this API supports the following category: revenue_streams
Filter by taxonomy tag. Each category has a set of associated tags.
Order results ascending or descending based on the ticker.
Limit the number of results returned. The default is 10 and the max is 250.
If present, this value can be used to fetch the next page of data.
A dimension of a company’s operating model that is agnostic to industry. Category contains a comprehensive list of tags which reflect defined types within that category. The current version of this API supports the following category: revenue_streams
The reason why the classification was given. The reason is provided by our AI to help you determine whether or not you agree with its applicability for your uses.
A specific type within a category. For example “product_sales” is a type of revenue stream. A company may have multiple tags within a given category. A taxonomy of tags are determined based on 10k filings.
The identifying ticker symbol for the asset.
{
"request_id": "a4f9947955398c28905337f003bfee7c",
"results": [
{
"category": "revenue_streams",
"reason": "The text mentions revenue earned from the sale of digital goods or products, such as software licenses, e-books, music downloads, or digital media content.",
"tag": "digital_product_sales",
"ticker": "AAPL"
},
{
"category": "revenue_streams",
"reason": "The text mentions revenue generated from the licensing of intellectual property rights to third parties, including franchise rights, patent licensing, brand licensing, and the receipt of royalties for authorized use of intellectual property like music royalties, book royalties, or patent royalties.",
"tag": "licensing_and_royalties",
"ticker": "AAPL"
}
],
"status": "OK"
}The market close time on the holiday (if it's not closed).
The date of the holiday.
Which market the record is for.
The name of the holiday.
The market open time on the holiday (if it's not closed).
The status of the market on the holiday.
[
{
"date": "2020-11-26",
"exchange": "NYSE",
"name": "Thanksgiving",
"status": "closed"
},
{
"date": "2020-11-26",
"exchange": "NASDAQ",
"name": "Thanksgiving",
"status": "closed"
},
{
"date": "2020-11-26",
"exchange": "OTC",
"name": "Thanksgiving",
"status": "closed"
},
{
"close": "2020-11-27T18:00:00.000Z",
"date": "2020-11-27",
"exchange": "NASDAQ",
"name": "Thanksgiving",
"open": "2020-11-27T14:30:00.000Z",
"status": "early-close"
},
{
"close": "2020-11-27T18:00:00.000Z",
"date": "2020-11-27",
"exchange": "NYSE",
"name": "Thanksgiving",
"open": "2020-11-27T14:30:00.000Z",
"status": "early-close"
}
]Market Status
Get the current trading status of the exchanges and overall financial markets.
Whether or not the market is in post-market hours.
Contains the status of various currency markets.
The status of the crypto market.
The status of the forex market.
Whether or not the market is in pre-market hours.
Contains the status of different US stock exchanges (e.g., Nasdaq, NYSE).
The status of the Nasdaq market.
The status of the NYSE market.
The status of the OTC market.
Contains the status of various index groups (e.g., MSCI, FTSE Russell).
The status of Cboe Streaming Market Indices Cryptocurrency ("CCCY") indices trading hours.
The status of Cboe Global Indices ("CGI") trading hours.
The status of Dow Jones indices trading hours
The status of Financial Times Stock Exchange Group ("FTSE") Russell indices trading hours.
The status of Morgan Stanley Capital International ("MSCI") indices trading hours.
The status of Morningstar ("MSTAR") indices trading hours.
The status of Morningstar Customer ("MSTARC") indices trading hours.
The status of National Association of Securities Dealers Automated Quotations ("Nasdaq") indices trading hours.
The status of Standard & Poors's ("S&P") indices trading hours.
The status of Societe Generale indices trading hours.
The status of the market as a whole.
The current time of the server, returned as a date-time in RFC3339 format.
{
"afterHours": true,
"currencies": {
"crypto": "open",
"fx": "open"
},
"earlyHours": false,
"exchanges": {
"nasdaq": "extended-hours",
"nyse": "extended-hours",
"otc": "closed"
},
"market": "extended-hours",
"serverTime": "2020-11-10T17:37:37-05:00"
}Query by filing type.
Query by filing date.
Query by period of report.
If true, query only for filings with an XBRL instance file. If false, query for filings without an XBRL instance file. If this parameter is not provided, query for filings with or without XBRL instance files.
Query by entity company name.
Order results based on the sort field.
Limit the number of results returned, default is 10 and max is 1000.
Sort field used for ordering.
The datetime when the filing was accepted by EDGAR in EST (format: YYYYMMDDHHMMSS)
Filing Accession Number
Entities related to the filing (e.g. the document filers).
Central Index Key (CIK) Number
Standard Industrial Classification (SIC)
Ticker
Relationship of this entity to the filing.
The number of files associated with the filing.
The date when the filing was filed in YYYYMMDD format.
Unique identifier for the filing.
The period of report for the filing in YYYYMMDD format.
The source URL is a link back to the upstream source for this filing document.
Filing Type
{}Select by filing id.
The datetime when the filing was accepted by EDGAR in EST (format: YYYYMMDDHHMMSS)
Filing Accession Number
Entities related to the filing (e.g. the document filers).
Central Index Key (CIK) Number
Standard Industrial Classification (SIC)
Ticker
Relationship of this entity to the filing.
The number of files associated with the filing.
The date when the filing was filed in YYYYMMDD format.
Unique identifier for the filing.
The period of report for the filing in YYYYMMDD format.
The source URL is a link back to the upstream source for this filing document.
Filing Type
{}Select by filing id.
Query by file sequence number.
Query by file name.
Order results based on the sort field.
Limit the number of results returned, default is 10 and max is 1000.
Sort field used for ordering.
A description for the contents of the file.
The name for the file.
An identifier unique to the filing for this data entry.
File Sequence Number
The size of the file in bytes.
The source URL is a link back to the upstream source for this file.
The type of document contained in the file.
{}Select by filing id.
Select by file id.
A description for the contents of the file.
The name for the file.
An identifier unique to the filing for this data entry.
File Sequence Number
The size of the file in bytes.
The source URL is a link back to the upstream source for this file.
The type of document contained in the file.
{
"description": "string",
"filename": "string",
"id": "1",
"sequence": 0,
"size_bytes": 0,
"source_url": "http://example.com",
"type": "string"
}Stock Splits v3
Get a list of historical stock splits, including the ticker symbol, the execution date, and the factors of the split ratio.
Specify a case-sensitive ticker symbol. For example, AAPL represents Apple Inc.
Query by execution date with the format YYYY-MM-DD.
Query for reverse stock splits. A split ratio where split_from is greater than split_to represents a reverse split. By default this filter is not used.
Order results based on the sort field.
Limit the number of results returned, default is 10 and max is 1000.
Sort field used for ordering.
If present, this value can be used to fetch the next page of data.
A request id assigned by the server.
An array of results containing the requested data.
The execution date of the stock split. On this date the stock split was applied.
The unique identifier for this stock split.
The second number in the split ratio.
For example: In a 2-for-1 split, split_from would be 1.
The first number in the split ratio.
For example: In a 2-for-1 split, split_to would be 2.
The ticker symbol of the stock split.
The status of this request's response.
{
"next_url": "https://api.polygon.io/v3/splits/AAPL?cursor=YWN0aXZlPXRydWUmZGF0ZT0yMDIxLTA0LTI1JmxpbWl0PTEmb3JkZXI9YXNjJnBhZ2VfbWFya2VyPUElN0M5YWRjMjY0ZTgyM2E1ZjBiOGUyNDc5YmZiOGE1YmYwNDVkYzU0YjgwMDcyMWE2YmI1ZjBjMjQwMjU4MjFmNGZiJnNvcnQ9dGlja2Vy",
"request_id": "6a7e466379af0a71039d60cc78e72282",
"results": [
{
"execution_date": "2020-08-31",
"id": "E36416cce743c3964c5da63e1ef1626c0aece30fb47302eea5a49c0055c04e8d0",
"split_from": 1,
"split_to": 4,
"ticker": "AAPL"
},
{
"execution_date": "2005-02-28",
"id": "E90a77bdf742661741ed7c8fc086415f0457c2816c45899d73aaa88bdc8ff6025",
"split_from": 1,
"split_to": 2,
"ticker": "AAPL"
}
],
"status": "OK"
}Dividends v3
Get a list of historical cash dividends, including the ticker symbol, declaration date, ex-dividend date, record date, pay date, frequency, and amount.
Specify a case-sensitive ticker symbol. For example, AAPL represents Apple Inc.
Query by ex-dividend date with the format YYYY-MM-DD.
Query by record date with the format YYYY-MM-DD.
Query by declaration date with the format YYYY-MM-DD.
Query by pay date with the format YYYY-MM-DD.
Query by the number of times per year the dividend is paid out. Possible values are 0 (one-time), 1 (annually), 2 (bi-annually), 4 (quarterly), 12 (monthly), 24 (bi-monthly), and 52 (weekly).
Query by the cash amount of the dividend.
Query by the type of dividend. Dividends that have been paid and/or are expected to be paid on consistent schedules are denoted as CD. Special Cash dividends that have been paid that are infrequent or unusual, and/or can not be expected to occur in the future are denoted as SC.
Order results based on the sort field.
Limit the number of results returned, default is 10 and max is 1000.
Sort field used for ordering.
If present, this value can be used to fetch the next page of data.
A request id assigned by the server.
An array of results containing the requested data.
The cash amount of the dividend per share owned.
The currency in which the dividend is paid.
The date that the dividend was announced.
The type of dividend. Dividends that have been paid and/or are expected to be paid on consistent schedules are denoted as CD. Special Cash dividends that have been paid that are infrequent or unusual, and/or can not be expected to occur in the future are denoted as SC. Long-Term and Short-Term capital gain distributions are denoted as LT and ST, respectively.
The date that the stock first trades without the dividend, determined by the exchange.
The number of times per year the dividend is paid out. Possible values are 0 (one-time), 1 (annually), 2 (bi-annually), 4 (quarterly), 12 (monthly), 24 (bi-monthly), and 52 (weekly).
The unique identifier of the dividend.
The date that the dividend is paid out.
The date that the stock must be held to receive the dividend, set by the company.
The ticker symbol of the dividend.
The status of this request's response.
{
"next_url": "https://api.polygon.io/v3/reference/dividends/AAPL?cursor=YWN0aXZlPXRydWUmZGF0ZT0yMDIxLTA0LTI1JmxpbWl0PTEmb3JkZXI9YXNjJnBhZ2VfbWFya2VyPUElN0M5YWRjMjY0ZTgyM2E1ZjBiOGUyNDc5YmZiOGE1YmYwNDVkYzU0YjgwMDcyMWE2YmI1ZjBjMjQwMjU4MjFmNGZiJnNvcnQ9dGlja2Vy",
"request_id": "6a7e466379af0a71039d60cc78e72282",
"results": [
{
"cash_amount": 0.22,
"declaration_date": "2021-10-28",
"dividend_type": "CD",
"ex_dividend_date": "2021-11-05",
"frequency": 4,
"id": "E8e3c4f794613e9205e2f178a36c53fcc57cdabb55e1988c87b33f9e52e221444",
"pay_date": "2021-11-11",
"record_date": "2021-11-08",
"ticker": "AAPL"
},
{
"cash_amount": 0.22,
"declaration_date": "2021-07-27",
"dividend_type": "CD",
"ex_dividend_date": "2021-08-06",
"frequency": 4,
"id": "E6436c5475706773f03490acf0b63fdb90b2c72bfeed329a6eb4afc080acd80ae",
"pay_date": "2021-08-12",
"record_date": "2021-08-09",
"ticker": "AAPL"
}
],
"status": "OK"
}Stock Financials vX
Get historical financial data for a stock ticker. The financials data is extracted from XBRL from company SEC filings using the methodology outlined here.
Query by company ticker.
Query by central index key (CIK) Number
Query by standard industrial classification (SIC)
Query by the date when the filing with financials data was filed in YYYY-MM-DD format.
Best used when querying over date ranges to find financials based on filings that happen in a time period.
Examples:
To get financials based on filings that have happened after January 1, 2009 use the query param filing_date.gte=2009-01-01
To get financials based on filings that happened in the year 2009 use the query params filing_date.gte=2009-01-01&filing_date.lt=2010-01-01
The period of report for the filing with financials data in YYYY-MM-DD format.
Query by timeframe. Annual financials originate from 10-K filings, and quarterly financials originate from 10-Q filings. Note: Most companies do not file quarterly reports for Q4 and instead include those financials in their annual report, so some companies my not return quarterly financials for Q4
Whether or not to include the xpath and formula attributes for each financial data point.
See the xpath and formula response attributes for more info. False by default.
Order results based on the sort field.
Limit the number of results returned, default is 10 and max is 100.
Sort field used for ordering.
The total number of results for this request.
If present, this value can be used to fetch the next page of data.
A request id assigned by the server.
An array of results containing the requested data.
The datetime (EST timezone) the filing was accepted by EDGAR in YYYYMMDDHHMMSS format.
The CIK number for the company.
The company name.
The end date of the period that these financials cover in YYYYMMDD format.
The date that the SEC filing which these financials were derived from was made available. Note that this is not necessarily the date when this information became public, as some companies may publish a press release before filing with the SEC.
Structured financial statements with detailed data points and metadata.
Balance sheet. The keys in this object can be any of the fields listed in the Balance Sheet section of the financials API glossary of terms.
An individual financial data point.
The list of report IDs (or errata) which were used to derive this data point.
This value is only returned for data points taken directly from XBRL when the include_sources query parameter is true and if source is SourceInterReportDerived.
The name of the formula used to derive this data point from other financial data points.
Information about the formulas can be found here.
This value is only returned for data points that are not explicitly expressed within the XBRL source file when the include_sources query parameter is true and if source is SourceIntraReportImpute.
A human readable label for the financial data point.
An indicator of what order within the statement that you would find this data point.
The source where this data point came from. This will be one of: SourceDirectReport, SourceIntraReportImpute or SourceInterReportDerived.
The unit of the financial data point.
The value of the financial data point.
The XPath 1.0 query that identifies the fact from within the XBRL source file.
This value is only returned for data points taken directly from XBRL when the include_sources query parameter is true and if source is SourceDirectReport.
Cash flow statement.
The keys in this object can be any of the fields listed in the Cash Flow Statement section of the financials API glossary of terms.
See the attributes of the objects within balance_sheet for more details.
Comprehensive income.
The keys in this object can be any of the fields listed in the Comprehensive Income section of the financials API glossary of terms.
See the attributes of the objects within balance_sheet for more details.
Income statement.
The keys in this object can be any of the fields listed in the Income Statement section of the financials API glossary of terms.
See the attributes of the objects within balance_sheet for more details.
Fiscal period of the report according to the company (Q1, Q2, Q3, Q4, or FY).
Fiscal year of the report according to the company.
The Standard Industrial Classification (SIC) code for the company.
The URL of the specific XBRL instance document within the SEC filing that these financials were derived from.
The URL of the SEC filing that these financials were derived from.
The start date of the period that these financials cover in YYYYMMDD format.
The list of ticker symbols for the company.
The timeframe of the report (quarterly, annual or ttm).
The status of this request's response.
{
"count": 1,
"next_url": "https://api.polygon.io/vX/reference/financials?",
"request_id": "55eb92ed43b25568ab0cce159830ea34",
"results": [
{
"cik": "0001650729",
"company_name": "SiteOne Landscape Supply, Inc.",
"end_date": "2022-04-03",
"filing_date": "2022-05-04",
"financials": {
"balance_sheet": {
"assets": {
"label": "Assets",
"order": 100,
"unit": "USD",
"value": 2407400000
},
"current_assets": {
"label": "Current Assets",
"order": 200,
"unit": "USD",
"value": 1385900000
},
"current_liabilities": {
"label": "Current Liabilities",
"order": 700,
"unit": "USD",
"value": 597500000
},
"equity": {
"label": "Equity",
"order": 1400,
"unit": "USD",
"value": 1099200000
},
"equity_attributable_to_noncontrolling_interest": {
"label": "Equity Attributable To Noncontrolling Interest",
"order": 1500,
"unit": "USD",
"value": 0
},
"equity_attributable_to_parent": {
"label": "Equity Attributable To Parent",
"order": 1600,
"unit": "USD",
"value": 1099200000
},
"liabilities": {
"label": "Liabilities",
"order": 600,
"unit": "USD",
"value": 1308200000
},
"liabilities_and_equity": {
"label": "Liabilities And Equity",
"order": 1900,
"unit": "USD",
"value": 2407400000
},
"noncurrent_assets": {
"label": "Noncurrent Assets",
"order": 300,
"unit": "USD",
"value": 1021500000
},
"noncurrent_liabilities": {
"label": "Noncurrent Liabilities",
"order": 800,
"unit": "USD",
"value": 710700000
}
},
"cash_flow_statement": {
"exchange_gains_losses": {
"label": "Exchange Gains/Losses",
"order": 1000,
"unit": "USD",
"value": 100000
},
"net_cash_flow": {
"label": "Net Cash Flow",
"order": 1100,
"unit": "USD",
"value": -8600000
},
"net_cash_flow_continuing": {
"label": "Net Cash Flow, Continuing",
"order": 1200,
"unit": "USD",
"value": -8700000
},
"net_cash_flow_from_financing_activities": {
"label": "Net Cash Flow From Financing Activities",
"order": 700,
"unit": "USD",
"value": 150600000
},
"net_cash_flow_from_financing_activities_continuing": {
"label": "Net Cash Flow From Financing Activities, Continuing",
"order": 800,
"unit": "USD",
"value": 150600000
},
"net_cash_flow_from_investing_activities": {
"label": "Net Cash Flow From Investing Activities",
"order": 400,
"unit": "USD",
"value": -41000000
},
"net_cash_flow_from_investing_activities_continuing": {
"label": "Net Cash Flow From Investing Activities, Continuing",
"order": 500,
"unit": "USD",
"value": -41000000
},
"net_cash_flow_from_operating_activities": {
"label": "Net Cash Flow From Operating Activities",
"order": 100,
"unit": "USD",
"value": -118300000
},
"net_cash_flow_from_operating_activities_continuing": {
"label": "Net Cash Flow From Operating Activities, Continuing",
"order": 200,
"unit": "USD",
"value": -118300000
}
},
"comprehensive_income": {
"comprehensive_income_loss": {
"label": "Comprehensive Income/Loss",
"order": 100,
"unit": "USD",
"value": 40500000
},
"comprehensive_income_loss_attributable_to_noncontrolling_interest": {
"label": "Comprehensive Income/Loss Attributable To Noncontrolling Interest",
"order": 200,
"unit": "USD",
"value": 0
},
"comprehensive_income_loss_attributable_to_parent": {
"label": "Comprehensive Income/Loss Attributable To Parent",
"order": 300,
"unit": "USD",
"value": 40500000
},
"other_comprehensive_income_loss": {
"label": "Other Comprehensive Income/Loss",
"order": 400,
"unit": "USD",
"value": 40500000
},
"other_comprehensive_income_loss_attributable_to_parent": {
"label": "Other Comprehensive Income/Loss Attributable To Parent",
"order": 600,
"unit": "USD",
"value": 8200000
}
},
"income_statement": {
"basic_earnings_per_share": {
"label": "Basic Earnings Per Share",
"order": 4200,
"unit": "USD / shares",
"value": 0.72
},
"benefits_costs_expenses": {
"label": "Benefits Costs and Expenses",
"order": 200,
"unit": "USD",
"value": 768400000
},
"cost_of_revenue": {
"label": "Cost Of Revenue",
"order": 300,
"unit": "USD",
"value": 536100000
},
"costs_and_expenses": {
"label": "Costs And Expenses",
"order": 600,
"unit": "USD",
"value": 768400000
},
"diluted_earnings_per_share": {
"label": "Diluted Earnings Per Share",
"order": 4300,
"unit": "USD / shares",
"value": 0.7
},
"gross_profit": {
"label": "Gross Profit",
"order": 800,
"unit": "USD",
"value": 269200000
},
"income_loss_from_continuing_operations_after_tax": {
"label": "Income/Loss From Continuing Operations After Tax",
"order": 1400,
"unit": "USD",
"value": 32300000
},
"income_loss_from_continuing_operations_before_tax": {
"label": "Income/Loss From Continuing Operations Before Tax",
"order": 1500,
"unit": "USD",
"value": 36900000
},
"income_tax_expense_benefit": {
"label": "Income Tax Expense/Benefit",
"order": 2200,
"unit": "USD",
"value": 4600000
},
"interest_expense_operating": {
"label": "Interest Expense, Operating",
"order": 2700,
"unit": "USD",
"value": 4300000
},
"net_income_loss": {
"label": "Net Income/Loss",
"order": 3200,
"unit": "USD",
"value": 32300000
},
"net_income_loss_attributable_to_noncontrolling_interest": {
"label": "Net Income/Loss Attributable To Noncontrolling Interest",
"order": 3300,
"unit": "USD",
"value": 0
},
"net_income_loss_attributable_to_parent": {
"label": "Net Income/Loss Attributable To Parent",
"order": 3500,
"unit": "USD",
"value": 32300000
},
"net_income_loss_available_to_common_stockholders_basic": {
"label": "Net Income/Loss Available To Common Stockholders, Basic",
"order": 3700,
"unit": "USD",
"value": 32300000
},
"operating_expenses": {
"label": "Operating Expenses",
"order": 1000,
"unit": "USD",
"value": 228000000
},
"operating_income_loss": {
"label": "Operating Income/Loss",
"order": 1100,
"unit": "USD",
"value": 41200000
},
"participating_securities_distributed_and_undistributed_earnings_loss_basic": {
"label": "Participating Securities, Distributed And Undistributed Earnings/Loss, Basic",
"order": 3800,
"unit": "USD",
"value": 0
},
"preferred_stock_dividends_and_other_adjustments": {
"label": "Preferred Stock Dividends And Other Adjustments",
"order": 3900,
"unit": "USD",
"value": 0
},
"revenues": {
"label": "Revenues",
"order": 100,
"unit": "USD",
"value": 805300000
}
}
},
"fiscal_period": "Q1",
"fiscal_year": "2022",
"source_filing_file_url": "https://api.polygon.io/v1/reference/sec/filings/0001650729-22-000010/files/site-20220403_htm.xml",
"source_filing_url": "https://api.polygon.io/v1/reference/sec/filings/0001650729-22-000010",
"start_date": "2022-01-03"
}
],
"status": "OK"
}Filter for conditions within a given asset class.
Filter by data type.
Filter for conditions with a given ID.
Filter by SIP. If the condition contains a mapping for that SIP, the condition will be returned.
Order results based on the sort field.
Limit the number of results returned, default is 10 and max is 1000.
Sort field used for ordering.
The total number of results for this request.
If present, this value can be used to fetch the next page of data.
A request ID assigned by the server.
An array of conditions that match your query.
A commonly-used abbreviation for this condition.
An identifier for a group of similar financial instruments.
Data types that this condition applies to.
A short description of the semantics of this condition.
If present, mapping this condition from a Polygon.io code to a SIP symbol depends on this attribute. In other words, data with this condition attached comes exclusively from the given exchange.
An identifier used by Polygon.io for this condition. Unique per data type.
If true, this condition is from an old version of the SIPs' specs and no longer is used. Other conditions may or may not reuse the same symbol as this one.
The name of this condition.
A comprehensive mapping that translates condition codes from individual SIPs (CTA, OPRA, UTP) to a unified code used by Polygon.io. This facilitates consistent interpretation and application of market data conditions across different data streams, ensuring that users can accurately apply these conditions to their data analysis and reporting.
Condition code from the Consolidated Tape Association (CTA).
Condition code from the Options Price Reporting Authority (OPRA).
Condition code from UTP Plan (UTP).
An identifier for a collection of related conditions.
A list of aggregation rules.
Describes aggregation rules on a consolidated (all exchanges) basis.
Whether or not trades with this condition update the high/low.
Whether or not trades with this condition update the open/close.
Whether or not trades with this condition update the volume.
Describes aggregation rules on a per-market-center basis.
Whether or not trades with this condition update the high/low.
Whether or not trades with this condition update the open/close.
Whether or not trades with this condition update the volume.
The status of this request's response.
{
"count": 1,
"request_id": "31d59dda-80e5-4721-8496-d0d32a654afe",
"results": [
{
"asset_class": "stocks",
"data_types": [
"trade"
],
"id": 2,
"name": "Average Price Trade",
"sip_mapping": {
"CTA": "B",
"UTP": "W"
},
"type": "condition",
"update_rules": {
"consolidated": {
"updates_high_low": false,
"updates_open_close": false,
"updates_volume": true
},
"market_center": {
"updates_high_low": false,
"updates_open_close": false,
"updates_volume": true
}
}
}
],
"status": "OK"
}Filter by asset class.
Filter by locale.
The total number of results for this request.
A request ID assigned by the server.
An array of results containing the requested data.
A commonly used abbreviation for this exchange.
An identifier for a group of similar financial instruments.
A unique identifier used by Polygon.io for this exchange.
An identifier for a geographical location.
The Market Identifier Code of this exchange (see ISO 10383).
Name of this exchange.
The MIC of the entity that operates this exchange.
The ID used by SIP's to represent this exchange.
Represents the type of exchange.
A link to this exchange's website, if one exists.
The status of this request's response.
{
"count": 1,
"request_id": "31d59dda-80e5-4721-8496-d0d32a654afe",
"results": [
{
"acronym": "AMEX",
"asset_class": "stocks",
"id": 1,
"locale": "us",
"mic": "XASE",
"name": "NYSE American, LLC",
"operating_mic": "XNYS",
"participant_id": "A",
"type": "exchange",
"url": "https://www.nyse.com/markets/nyse-american"
}
],
"status": "OK"
}Related Companies
Get a list of tickers related to the queried ticker based on News and Returns data.
The ticker symbol to search.
A request id assigned by the server.
An array of results containing the requested data.
A ticker related to the requested ticker.
The status of this request's response.
The ticker being queried.
{
"request_id": "31d59dda-80e5-4721-8496-d0d32a654afe",
"results": [
{
"ticker": "MSFT"
},
{
"ticker": "GOOGL"
},
{
"ticker": "AMZN"
},
{
"ticker": "FB"
},
{
"ticker": "TSLA"
},
{
"ticker": "NVDA"
},
{
"ticker": "INTC"
},
{
"ticker": "ADBE"
},
{
"ticker": "NFLX"
},
{
"ticker": "PYPL"
}
],
"status": "OK",
"stock_symbol": "AAPL"
}IPOs
The IPOs API provides access to detailed information about Initial Public Offerings (IPOs), including both upcoming and historical events. With this API, you can query for a comprehensive list of IPOs, along with key details such as the issuer name, ticker symbol, ISIN, IPO date, number of shares offered, expected price range, and final offering price. You can filter the results by status to focus on new, rumors, pending, historical, and more.
Specify a case-sensitive ticker symbol. For example, AAPL represents Apple Inc.
Specify a us_code. This is a unique nine-character alphanumeric code that identifies a North American financial security for the purposes of facilitating clearing and settlement of trades.
Specify an International Securities Identification Number (ISIN). This is a unique twelve-digit code that is assigned to every security issuance in the world.
Specify a listing date. This is the first trading date for the newly listed entity.
Specify an IPO status.
Order results based on the sort field.
Limit the number of results returned, default is 10 and max is 1000.
Sort field used for ordering.
If present, this value can be used to fetch the next page of data.
A request id assigned by the server.
An array of results containing the requested data.
The date when the IPO event was announced.
Underlying currency of the security.
The price set by the company and its underwriters before the IPO goes live.
The highest price within the IPO price range that the company might use to price the shares.
The status of the IPO event. IPO events start out as status "rumor" or "pending". On listing day, the status changes to "new". After the listing day, the status changes to "history".
The status "direct_listing_process" corresponds to a type of offering where, instead of going through all the IPO processes, the company decides to list its shares directly on an exchange, without using an investment bank or other intermediaries. This is called a direct listing, direct placement, or direct public offering (DPO).
International Securities Identification Number. This is a unique twelve-digit code that is assigned to every security issuance in the world.
Name of issuer.
The date when the IPO event was last modified.
First trading date for the newly listed entity.
The minimum number of shares that can be bought or sold in a single transaction.
The lowest price within the IPO price range that the company is willing to offer its shares to investors.
The upper limit of the shares that the company is offering to investors.
The lower limit of shares that the company is willing to sell in the IPO.
Market Identifier Code (MIC) of the primary exchange where the security is listed. The Market Identifier Code (MIC) (ISO 10383) is a unique identification code used to identify securities trading exchanges, regulated and non-regulated trading markets.
Description of the security.
The classification of the stock. For example, "CS" stands for Common Stock.
The total number of shares that the company has issued and are held by investors.
The ticker symbol of the IPO event.
The total amount raised by the company for IPO.
This is a unique nine-character alphanumeric code that identifies a North American financial security for the purposes of facilitating clearing and settlement of trades.
The status of this request's response.
{
"next_url": "https://api.polygon.io/vX/reference/ipos?cursor=YWN0aXZlPXRydWUmZGF0ZT0yMDIxLTA0LTI1JmxpbWl0PTEmb3JkZXI9YXNjJnBhZ2VfbWFya2VyPUElN0M5YWRjMjY0ZTgyM2E1ZjBiOGUyNDc5YmZiOGE1YmYwNDVkYzU0YjgwMDcyMWE2YmI1ZjBjMjQwMjU4MjFmNGZiJnNvcnQ9dGlja2Vy",
"request_id": "6a7e466379af0a71039d60cc78e72282",
"results": [
{
"announced_date": "2024-06-01",
"currency_code": "USD",
"final_issue_price": 17,
"highest_offer_price": 17,
"ipo_status": "history",
"isin": "US75383L1026",
"issue_end_date": "2024-06-06",
"issue_start_date": "2024-06-01",
"issuer_name": "Rapport Therapeutics Inc.",
"last_updated": "2024-06-27",
"listing_date": "2024-06-07",
"lot_size": 100,
"lowest_offer_price": 17,
"max_shares_offered": 8000000,
"min_shares_offered": 1000000,
"primary_exchange": "XNAS",
"security_description": "Ordinary Shares",
"security_type": "CS",
"shares_outstanding": 35376457,
"ticker": "RAPP",
"total_offer_size": 136000000,
"us_code": "75383L102"
}
],
"status": "OK"
}Short Interest
Query for short interest data by Identifier and Date.
Specify a type of identifier.
Specify a case-sensitive identifier.
Either a date with the format YYYY-MM-DD or a nanosecond timestamp.
Order results based on the sort field.
Limit the number of results returned, default is 100 and max is 1000.
Sort field used for ordering.
If present, this value can be used to fetch the next page of data.
The status of this request's response.
{
"next_url": "string",
"request_id": "string",
"results": [
{
"currency_code": "USD",
"date": "2023-12-31",
"isin": "US0378331005",
"markets": [
{
"market": "NYSE",
"short_volume": 1006566,
"short_volume_exempt": 1100
}
],
"name": "Apple Inc.",
"security_description": "Common Stock",
"short_volume": 2006566,
"short_volume_exempt": 3000,
"ticker": "AAPL",
"us_code": "378331005"
}
],
"status": "string"
}Contracts
The Contracts endpoint returns a list of futures contracts. This endpoint can be used to query for contracts based on a variety of parameters, including the contract's ticker, product code, first trade date, last trade date, and whether or not the contract was active on a given date.
A unique identifier for the Product a Contract belongs to. Note that multiple contracts can belong to the same product.
The first day that a contract was tradeable. A date with the format YYYY-MM-DD.
The last day that the contract was tradeable. A date with the format YYYY-MM-DD.
Specify the point-in-time for which you want to retrieve information. Note that the contract data returned for a given date is the state of that contract as of that day. A date in the format YYYY-MM-DD (default=today).
Filter for contracts based on whether or not they were tradeable at the given point in time. For example, if the date queried is greater-than or equal-to a contract's 'first_trade_date' and less-than-or-equal-to its 'last_trade_date', then the contract was active. If the date queried is greater-than-or-equal-to the contract's 'last_trade_date' or less-than-or-equal-to its 'first_trade_date', then the contract was inactive.
The type of contract, one of "all", "single", or "combo" (default=all).
Order results based on the sort field.
Limit the number of results returned, default is 100 and max is 1000.
Sort field used for ordering.
If present, this value can be used to fetch the next page of data.
A unique identifier for this request.
Whether or not this contract was tradeable at the given point-in-time specified in the 'as_of' attribute (a contract was active if the given day was after the 'first_trade_date' and before the 'last_trade_date').
The point-in-time date for the given contract - e.g. if 'as_of' is set to 2021-04-25, then the data retrieved describes the contract(s) as of 2021-04-25.
The number of days until this contract matures (since the point-in-time date). Note that the absence of this field means there are 0 days until maturity.
The date on which this contract first became tradeable.
The date on which this contract last became tradeable.
The market identifier code (MIC) for the exchange on which this contract trades.
The maximum order quantity for this contract.
The minimum order quantity for this contract.
The name of the contract.
The unique identifier for the product to which this contract belongs.
The final settlement date for the contract.
The settlement tick size for this contract.
The spread tick size for this contract.
The unique identifier for the contract, typically consisting of the product code and expiration date.
The tick size for this contract.
The type of contract, one of "single" or "combo".
The status of this request's response.
{
"request_id": "example-request-id",
"results": [
{
"active": true,
"as_of": "2025-02-26",
"days_to_maturity": 138,
"first_trade_date": "2025-01-15",
"last_trade_date": "2025-07-14",
"market_identifier_code": "XCBT",
"max_order_quantity": 1999,
"min_order_quantity": 1,
"name": "00CN5 Future",
"product_code": "00C",
"settlement_date": "2025-07-14",
"settlement_tick_size": 0.0025,
"spread_tick_size": 0.0025,
"ticker": "00CN5",
"trade_tick_size": 0.0025,
"type": "single"
},
{
"active": false,
"as_of": "2025-02-26",
"days_to_maturity": -12,
"first_trade_date": "2024-09-16",
"last_trade_date": "2025-02-14",
"market_identifier_code": "XCBT",
"max_order_quantity": 1999,
"min_order_quantity": 1,
"name": "00CG5 Future",
"product_code": "00C",
"settlement_date": "2025-02-14",
"ticker": "00CG5XXX",
"type": "single"
}
],
"status": "OK"
}Contract Details
The Contract Details endpoint returns the details for a single contract at a specific point in time.
The ticker symbol of the contract to retrieve.
The point-in-time of the data to be retrieved. Note that the contract data returned for a given date represents the state of that contract on that day. A date in the format YYYY-MM-DD (default=today).
A unique identifier for this request.
Whether or not this contract was tradeable at the given point-in-time specified in the 'as_of' attribute (a contract was active if the given day was after the 'first_trade_date' and before the 'last_trade_date').
The point-in-time date for the given contract - e.g. if 'as_of' is set to 2021-04-25, then the data retrieved describes the contract(s) as of 2021-04-25.
The number of days until this contract matures (since the point-in-time date). Note that the absence of this field means there are 0 days until maturity.
The date on which this contract first became tradeable.
The date on which this contract last became tradeable.
The market identifier code (MIC) for the exchange on which this contract trades.
The maximum order quantity for this contract.
The minimum order quantity for this contract.
The name of the contract.
The unique identifier for the product to which this contract belongs.
The final settlement date for the contract.
The settlement tick size for this contract.
The spread tick size for this contract.
The unique identifier for the contract, typically consisting of the product code and expiration date.
The tick size for this contract.
The type of contract, one of "single" or "combo".
The status of this request's response.
{
"request_id": "ac0a1b0b-0b0b-4b0b-8b0b-0b0b0b0b0b0b",
"results": {
"active": true,
"as_of": "2021-04-25",
"days_to_maturity": 460,
"first_trade_date": "2021-04-25",
"last_trade_date": "2026-01-16",
"market_identifier_code": "XNYM",
"max_order_quantity": 3000,
"min_order_quantity": 1,
"name": "ESZ4 Future",
"product_code": "ES",
"settlement_date": "2026-01-21",
"settlement_tick_size": 0.25,
"spread_tick_size": 0.01,
"ticker": "ESZ4",
"trade_tick_size": 0.25,
"type": "single"
},
"status": "OK"
}Product Schedules
The Product-Specific Futures Schedules API provides detailed trading schedules for a specific futures product. This API allows you to query schedules for a single product across a range of dates. Users can access comprehensive information about trading sessions, including market events such as preopen, open, and closed, along with their precise timestamps.
The product code for the futures product.
The date on which the schedule's trading day ended (sometimes referred to as trading date). Defaults to today. Formatted as YYYY-MM-DD. Note that although there is no time component the day is assumed to be that day in Central Time.
Order results based on the sort field.
Limit the number of results returned, default is 100 and max is 1000.
An optional error message for failed requests when available.
If present, this value can be used to fetch the next page of data.
The unique identifier for the request.
The list of schedules for the specified product.
The MIC for the exchange on which this schedule's product trades.
The product code for the futures product to which this schedule applies.
The name of the futures product to which this schedule applies.
The market event for this schedule.
The timestamp for this market event in Central Time.
The date on which the schedule's trading day ended (sometimes referred to as trading date) formatted as YYYY-MM-DD. Note that although there is no time component on this attribute, the day refers to Central Time.
The status of the response.
{
"request_id": "c5f83341-12d7-4a80-a3a6-6a9fdaeb43b2",
"results": [
{
"example": "E-Mini S&P 500 Futures",
"market_identifier_code": "XNYM",
"product_code": "ES",
"product_name": "E-Mini S&P 500 Futures",
"schedule": [
{
"event": "pre_open",
"timestamp": "2025-11-24T18:45:00:00-06:00"
},
{
"event": "open",
"timestamp": "2025-11-24T19:00:00-06:00"
},
{
"event": "close",
"timestamp": "2025-11-25T18:00:00-06:00"
}
],
"session_end_date": "2025-11-24"
},
{
"market_identifier_code": "XNYM",
"product_code": "ES",
"product_name": "E-Mini S&P 500 Futures",
"schedule": [
{
"event": "pre_open",
"timestamp": "2025-11-24T18:45:00:00-06:00"
},
{
"event": "open",
"timestamp": "2025-11-24T19:00:00-06:00"
},
{
"event": "close",
"timestamp": "2025-11-25T18:00:00-06:00"
}
],
"session_end_date": "2025-11-21"
}
],
"status": "OK"
}Products
The Products endpoint returns a list of futures products. This endpoint can be used to query for products based on a variety of parameters, including by the product's name, exchange, sector, sub-sector, asset class, asset sub-class, and type.
Search for products by Product Name. This parameter supports an exact match, while a name-contains search can be performed using the name.search parameter. Note that the search is case-sensitive.
A date string in the format YYYY-MM-DD. This parameter will return point-in-time information about products for the specified day (default=today).
The market identifier code (MIC) for the exchange on which the products trades.
The sector to which the products belong.
The sub-sector to which the products belong.
The asset class to which the products belong.
The asset sub-class to which the products belong.
The type of products to return. One of "all", "single", or "combo" (default=all).
Order results based on the sort field.
Limit the number of results returned, default is 100 and max is 1000.
Sort field used for ordering.
If present, this value can be used to fetch the next page of data.
A unique identifier for this request.
The point-in-time date for the given product - e.g. if 'as_of' is set to 2024-11-05, then these were the details for this product on that day.
The asset class to which the product belongs.
The asset sub-class to which the product belongs.
The date and time at which this product was last updated.
The Market Identifier Code (MIC) for the exchange on which this contract trades.
The full name of the product.
Whether or not this product is eligible for over-the-counter trading.
The quoted price for this product.
The unique identifier for the product.
The sector to which the product belongs.
The currency in which this product settles.
The method of settlement for this product (Financially Settled or Deliverable).
The type of settlement for this product.
The sub-sector to which the product belongs.
The currency in which this product trades.
The type of product, one of "single" or "combo".
The unit of measure for this product.
The quantity of the unit of measure for this product.
The status of this request's response.
{
"next_url": "https://api.polygon.io/futures/vX/products?cursor=YWN0aXZlPXRydWUmZGF0ZT0yMDIxLTA0LTI1JmxpbWl0PTEmb3JkZXI9YXNjJnBhZ2VfbWFya2VyPUElN0M5YWRjMjY0ZTgyM2E1ZjBiOGUyNDc5YmZiOGE1YmYwNDVkYzU0YjgwMDcyMWE2YmI1ZjBjMjQwMjU4MjFmNGZiJnNvcnQ9dGlja2Vy",
"request_id": "ac0a1b0b-0b0b-4b0b-8b0b-0b0b0b0b0b0b",
"results": [
{
"as_of": "2024-12-05",
"asset_class": "financials",
"asset_sub_class": "equity",
"last_updated": "2021-04-25T06:00:00Z",
"market_identifier_code": "XNYM",
"name": "E-Mini S&P 500 Futures",
"otc_eligible": true,
"price_quotation": "U.S. dollars and center per index point",
"product_code": "ES",
"sector": "us_index",
"settlement_currency_code": "USD",
"settlement_method": "Financially Settled",
"settlement_type": "CASH",
"sub_sector": "small_cap_index",
"trade_currency_code": "USD",
"type": "single",
"unit_of_measure": "IPNT",
"unit_of_measure_quantity": 50
}
],
"status": "OK"
}Product Details
The Product Details endpoint returns the details for a single product as of a specific day.
The unique identifier for a product.
The type of product to return. One of "single" or "combo" (default=single).
A date string in the format YYYY-MM-DD. Note that the data returned is the state of this product's data at that point-in-time.
A unique identifier for this request.
The point-in-time date for the given product - e.g. if 'as_of' is set to 2024-11-05, then these were the details for this product on that day.
The asset class to which the product belongs.
The asset sub-class to which the product belongs.
The date and time at which this product was last updated.
The Market Identifier Code (MIC) for the exchange on which this contract trades.
The full name of the product.
Whether or not this product is eligible for over-the-counter trading.
The quoted price for this product.
The unique identifier for the product.
The sector to which the product belongs.
The currency in which this product settles.
The method of settlement for this product (Financially Settled or Deliverable).
The type of settlement for this product.
The sub-sector to which the product belongs.
The currency in which this product trades.
The type of product, one of "single" or "combo".
The unit of measure for this product.
The quantity of the unit of measure for this product.
The status of this request's response.
{
"request_id": "ac0a1b0b-0b0b-4b0b-8b0b-0b0b0b0b0b0b",
"results": {
"as_of": "2024-12-05",
"asset_class": "financials",
"asset_sub_class": "equity",
"last_updated": "2021-04-25T06:00:00Z",
"market_identifier_code": "XNYM",
"name": "E-Mini S&P 500 Futures",
"otc_eligible": true,
"price_quotation": "U.S. dollars and center per index point",
"product_code": "ES",
"sector": "us_index",
"settlement_currency_code": "USD",
"settlement_method": "Financially Settled",
"settlement_type": "CASH",
"sub_sector": "small_cap_index",
"trade_currency_code": "USD",
"type": "single",
"unit_of_measure": "IPNT",
"unit_of_measure_quantity": 50
},
"status": "OK"
}Market Status
The market status endpoint returns the current status of the futures market for the given product code(s).
The product code(s) to return market statuses for.
Multiple product codes can be specified by separating them with a comma. Currently, the limit is 250 product codes.
Order results based on the sort field.
Limit the number of results returned, default is 100 and max is 1000.
Sort field used for ordering.
If present, this value can be used to fetch the next page of data.
A unique identifier for this request.
The market identifier code (MIC) for the exchange on which the corresponding product trades.
The current status of the market.
The product code for the product.
The status of this request's response.
An RFC3339 timestamp representing the moment at which the market statuses were evaluated.
{
"next_url": "https://api.polygon.io/futures/vX/products?cursor=YWN0aXZlPXRydWUmZGF0ZT0yMDIxLTA0LTI1JmxpbWl0PTEmb3JkZXI9YXNjJnBhZ2VfbWFya2VyPUElN0M5YWRjMjY0ZTgyM2E1ZjBiOGUyNDc5YmZiOGE1YmYwNDVkYzU0YjgwMDcyMWE2YmI1ZjBjMjQwMjU4MjFmNGZiJnNvcnQ9dGlja2Vy",
"request_id": "ac0a1b0b-0b0b-4b0b-8b0b-0b0b0b0b0b0b",
"results": [
{
"market_identifier_code": "XNYM",
"market_status": "open",
"product_code": "ES"
}
],
"status": "OK",
"timestamp": "2025-02-27T13:26:35.905149Z"
}Stocks WebSocket Documentation
The Polygon.io Stocks WebSocket API provides streaming access to the latest stock market data from all US stock exchanges. You can specify which channels you want to consume by sending instructions in the form of actions. Our WebSockets emit events to notify you when an event has occurred in a channel you've subscribed to.
Our WebSocket APIs are based on entitlements that control which WebSocket Clusters you can connect to and which kinds of data you can access. You can login to see examples that include your API key and are personalized to your entitlements.
Step 1: Connect
With a premium Stocks plan, you will be able to use a single connection to the Stocks Cluster. If another connection attempts to connect to the Stocks Cluster simultaneously, the current connection will be disconnected. If you need more simultaneous connections to this cluster, you can contact support.
Connecting to a cluster:
On connection you will receive the following message:
[{
"ev":"status",
"status":"connected",
"message": "Connected Successfully"
}]Step 2: Authenticate
You must authenticate before you can make any other requests.
On successful authentication you will receive the following message:
[{
"ev":"status",
"status":"auth_success",
"message": "authenticated"
}]Step 3: Subscribe
Once authenticated, you can request a stream. You can request multiple streams in the same request.
You can also request multiple streams from the same cluster.
Usage
Things happen very quickly in the world of finance, which means a Polygon.io WebSocket client must be able to handle many incoming messages per second. Due to the nature of the WebSocket protocol, if a client is slow to consume messages from the server, Polygon.io's server must buffer messages and send them only as fast as the client can consume them. To help prevent the message buffer from getting too long, Polygon.io may send more than one JSON object in a single WebSocket message. We accomplish this by wrapping all messages in a JSON array, and adding more objects to the array if the message buffer is getting longer. For example, consider a WebSocket message with a single trade event in it:
[
{"ev":"T","sym":"MSFT","i":"50578","x":4,"p":215.9721,"s":100,"t":1611082428813,"z":3}
]If your client is consuming a bit slow, or 2+ events happened in very short succession, you may receive a single WebSocket message with more than one event inside it, like this:
[
{"ev":"T","sym":"MSFT","i":"50578","x":4,"p":215.9721,"s":100,"t":1611082428813,"z":3},
{"ev":"T","sym":"MSFT","i":"12856","x":4,"p":215.989,"s":1,"c":[37],"t":1611082428814,"z":3}
]Note that if a client is consuming messages too slowly for too long, Polygon.io's server-side buffer may get too large. If that happens, Polygon.io will terminate the WebSocket connection. You can check your account dashboard to see if a connection was terminated as a slow consumer. If this happens to you consistently, consider subscribing to fewer symbols or channels.
Aggregates (Per Minute)
Stream real-time minute aggregates for a given stock ticker symbol.
Specify a stock ticker or use * to subscribe to all stock tickers. You can also use a comma separated list to subscribe to multiple stock tickers. You can retrieve available stock tickers from our Stock Tickers API.
The event type.
The ticker symbol for the given stock.
The tick volume.
Today's accumulated volume.
Today's official opening price.
The tick's volume weighted average price.
The opening tick price for this aggregate window.
The closing tick price for this aggregate window.
The highest tick price for this aggregate window.
The lowest tick price for this aggregate window.
Today's volume weighted average price.
The average trade size for this aggregate window.
The start timestamp of this aggregate window in Unix Milliseconds.
The end timestamp of this aggregate window in Unix Milliseconds.
Whether or not this aggregate is for an OTC ticker. This field will be left off if false.
{
"ev": "AM",
"sym": "GTE",
"v": 4110,
"av": 9470157,
"op": 0.4372,
"vw": 0.4488,
"o": 0.4488,
"c": 0.4486,
"h": 0.4489,
"l": 0.4486,
"a": 0.4352,
"z": 685,
"s": 1610144640000,
"e": 1610144700000
}Aggregates (Per Second)
Stream real-time second aggregates for a given stock ticker symbol.
Specify a stock ticker or use * to subscribe to all stock tickers. You can also use a comma separated list to subscribe to multiple stock tickers. You can retrieve available stock tickers from our Stock Tickers API.
The event type.
The ticker symbol for the given stock.
The tick volume.
Today's accumulated volume.
Today's official opening price.
The tick's volume weighted average price.
The opening tick price for this aggregate window.
The closing tick price for this aggregate window.
The highest tick price for this aggregate window.
The lowest tick price for this aggregate window.
Today's volume weighted average price.
The average trade size for this aggregate window.
The start timestamp of this aggregate window in Unix Milliseconds.
The end timestamp of this aggregate window in Unix Milliseconds.
Whether or not this aggregate is for an OTC ticker. This field will be left off if false.
{
"ev": "A",
"sym": "SPCE",
"v": 200,
"av": 8642007,
"op": 25.66,
"vw": 25.3981,
"o": 25.39,
"c": 25.39,
"h": 25.39,
"l": 25.39,
"a": 25.3714,
"z": 50,
"s": 1610144868000,
"e": 1610144869000
}Trades
Stream real-time trades for a given stock ticker symbol.
Specify a stock ticker or use * to subscribe to all stock tickers. You can also use a comma separated list to subscribe to multiple stock tickers. You can retrieve available stock tickers from our Stock Tickers API.
The event type.
The ticker symbol for the given stock.
The exchange ID. See Exchanges for Polygon.io's mapping of exchange IDs.
The trade ID.
The tape. (1 = NYSE, 2 = AMEX, 3 = Nasdaq).
The price.
The trade size.
The trade conditions. See Conditions and Indicators for Polygon.io's trade conditions glossary.
The SIP timestamp in Unix MS.
The sequence number represents the sequence in which message events happened. These are increasing and unique per ticker symbol, but will not always be sequential (e.g., 1, 2, 6, 9, 10, 11).
The ID for the Trade Reporting Facility where the trade took place.
The TRF (Trade Reporting Facility) Timestamp in Unix MS. This is the timestamp of when the trade reporting facility received this trade.
{
"ev": "T",
"sym": "MSFT",
"x": 4,
"i": "12345",
"z": 3,
"p": 114.125,
"s": 100,
"c": [
0,
12
],
"t": 1536036818784,
"q": 3681328
}Quotes
Stream real-time quotes for a given stock ticker symbol.
Specify a stock ticker or use * to subscribe to all stock tickers. You can also use a comma separated list to subscribe to multiple stock tickers. You can retrieve available stock tickers from our Stock Tickers API.
The event type.
The ticker symbol for the given stock.
The bid exchange ID.
The bid price.
The bid size. This represents the number of round lot orders at the given bid price. The normal round lot size is 100 shares. A bid size of 2 means there are 200 shares for purchase at the given bid price.
The ask exchange ID.
The ask price.
The ask size. This represents the number of round lot orders at the given ask price. The normal round lot size is 100 shares. An ask size of 2 means there are 200 shares available to purchase at the given ask price.
The condition.
The indicators. For more information, see our glossary of Conditions and Indicators.
The SIP timestamp in Unix MS.
The sequence number represents the sequence in which quote events happened. These are increasing and unique per ticker symbol, but will not always be sequential (e.g., 1, 2, 6, 9, 10, 11). Values reset after each trading session/day.
The tape. (1 = NYSE, 2 = AMEX, 3 = Nasdaq).
{
"ev": "Q",
"sym": "MSFT",
"bx": 4,
"bp": 114.125,
"bs": 100,
"ax": 7,
"ap": 114.128,
"as": 160,
"c": 0,
"i": [
604
],
"t": 1536036818784,
"q": 50385480,
"z": 3
}Fair Market Value
Real-time fair market value for a given stock ticker symbol.
Specify a stock ticker or use * to subscribe to all stock tickers. You can also use a comma separated list to subscribe to multiple stock tickers. You can retrieve available stock tickers from our Stock Tickers API.
The event type.
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, contact us.
The ticker symbol for the given security.
The nanosecond timestamp.
{
"ev": "FMV",
"fmv": 189.22,
"sym": "AAPL",
"t": 1678220098130
}