---
title: "Conditions"
method: GET
path: "/v3/reference/conditions"
tags: ["reference:conditions"]
---

# Conditions

`GET /v3/reference/conditions`

List all conditions that Massive uses.

## Query parameters

- `asset_class` 'stocks' | 'options' | 'crypto' | 'fx' — An identifier for a group of similar financial instruments.
- `data_type` 'trade' | 'bbo' | 'nbbo' — The type of financial data represented by a data model.
- `id` integer — An identifier used by Massive for this condition. Unique per data type.
- `sip` 'CTA' | 'UTP' | 'OPRA' — One of the SIPs.
- `order` 'asc' | 'desc'
- `limit` integer
- `sort` 'asset_class' | 'id' | 'type' | 'name' | 'data_types' | 'legacy'

## Response `200`

OK

- object
  - `count` integer, required — The total number of results for this request.
  - `next_url` string — If present, this value can be used to fetch the next page of data.
  - `request_id` string, required — A request ID assigned by the server.
  - `results` object[], required — An array of conditions that match your query.
    - `abbreviation` string — A commonly-used abbreviation for this condition.
    - `asset_class` 'stocks' | 'options' | 'crypto' | 'fx', required — An identifier for a group of similar financial instruments.
    - `data_types` string[], required — Data types that this condition applies to.
    - `description` string — A short description of the semantics of this condition.
    - `exchange` integer — If present, mapping this condition from a Massive 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, required — An identifier used by Massive for this condition. Unique per data type.
    - `legacy` boolean — 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, required — The name of this condition.
    - `sip_mapping` object, required — A comprehensive mapping that translates condition codes from individual SIPs (CTA, OPRA, UTP) to a unified code used by Massive. 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.
      - `CTA` string — Condition code from the Consolidated Tape Association (CTA).
      - `OPRA` string — Condition code from the Options Price Reporting Authority (OPRA).
      - `UTP` string — Condition code from UTP Plan (UTP).
    - `type` 'sale_condition' | 'quote_condition' | 'sip_generated_flag' | 'financial_status_indicator' | 'short_sale_restriction_indicator' | 'settlement_condition' | 'market_condition' | 'trade_thru_exempt', required — An identifier for a collection of related conditions.
    - `update_rules` object — A list of aggregation rules.
      - `consolidated` object, required — Describes aggregation rules on a consolidated (all exchanges) basis.
        - `updates_high_low` boolean, required — Whether or not trades with this condition update the high/low.
        - `updates_open_close` boolean, required — Whether or not trades with this condition update the open/close.
        - `updates_volume` boolean, required — Whether or not trades with this condition update the volume.
      - `market_center` object, required — Describes aggregation rules on a per-market-center basis.
        - `updates_high_low` boolean, required — Whether or not trades with this condition update the high/low.
        - `updates_open_close` boolean, required — Whether or not trades with this condition update the open/close.
        - `updates_volume` boolean, required — Whether or not trades with this condition update the volume.
  - `status` string, required — The status of this request's response.

## Other responses

- `400` — a query parameter was malformed
- `default` — an unknown error occurred

---

[API](https://skmtc.net/massive/apis/polygon-api.md) · [All operations](https://skmtc.net/massive/apis/polygon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/massive/polygon-api/revisions/ad6f143e43aa/schema)