Condition Codes
GET
/v3/reference/conditions
Retrieve a unified and comprehensive list of trade and quote conditions from various upstream market data providers (e.g., CTA, UTP, OPRA, FINRA). Each condition identifies special circumstances associated with market data, such as trades occurring outside regular sessions or at averaged prices, and outlines how these conditions affect metrics like high, low, open, close, and volume. By examining these mapped conditions, users can accurately interpret the context of trades and quotes, apply appropriate filtering, and ensure that aggregated data correctly reflects eligible trading activity.
Use Cases: Data interpretation, unified condition mapping, filtering and analysis, algorithmic adjustments, compliance and reporting.
Query Parameters
asset_class
enum (string)
Filter for conditions within a given asset class.
data_type
enum (string)
Filter by data type.
id
integer
Filter for conditions with a given ID.
sip
enum (string)
Filter by SIP. If the condition contains a mapping for that SIP, the condition will be returned.
order
enum (string)
Order results based on the `sort` field.
limit
integer
Limit the number of results returned, default is 10 and max is 1000.
sort
enum (string)
Sort field used for ordering.
Response Attributes
count
integer
The total number of results for this request.
next_url
string
optional
If present, this value can be used to fetch the next page of data.
request_id
string
A request ID assigned by the server.
results
array (object)
An array of conditions that match your query.
abbreviation
string
optional
A commonly-used abbreviation for this condition.
asset_class
enum (stocks, options, crypto, fx)
An identifier for a group of similar financial instruments.
data_types
array (string)
Data types that this condition applies to.
description
string
optional
A short description of the semantics of this condition.
exchange
integer
optional
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.
id
integer
An identifier used by Polygon.io for this condition. Unique per data type.
legacy
boolean
optional
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.
name
string
The name of this condition.
sip_mapping
object
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.
type
enum (sale_condition, quote_condition, sip_generated_flag, financial_status_indicator, short_sale_restriction_indicator, settlement_condition, market_condition, trade_thru_exempt)
An identifier for a collection of related conditions.
update_rules
object
optional
A list of aggregation rules.
status
string
The status of this request's response.