GET
/v3/reference/conditions
Reference Condition Codes
List market condition codes.
Endpoint Details
| HTTP Method | GET |
|---|---|
| Path | /v3/reference/conditions |
| Version | v3 |
| Minimum Plan | free |
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
api_key |
string | Required | Your API key for authentication |
asset_class |
string | Optional | Filter by asset class (stocks, options, forex, crypto) |
locale |
string | Optional | Filter by locale/market (default: us) |
limit |
integer | Optional | Maximum number of results |
cursor |
string | Optional | Pagination cursor for next page |
Example Request
curl "https://mail.tradeiqai.com/api/v3/reference/conditions?api_key=YOUR_API_KEY"
Note: Replace YOUR_API_KEY with your actual API key.
Response Attributes
| Attribute | Type | Description |
|---|---|---|
ok | boolean | Indicates if the request was successful (e.g., 1) |
data | object | Response data object |
data.status | string | Response status (typically "OK") (e.g., OK) |
data.results | array | Array of 10 items |
| Array items contain: | ||
data.results[].id | integer | Integer (e.g., 0) |
data.results[].type | string | String value (e.g., regular) |
data.results[].name | string | String value (e.g., Regular Trade) |
data.results[].asset_class | string | String value (e.g., crypto) |
data.results[].data_types | array | Array of objects |
Example Response
{
"ok": true,
"data": {
"status": "OK",
"count": 10,
"results": [
{
"id": 0,
"type": "regular",
"name": "Regular Trade",
"asset_class": "crypto",
"data_types": [
"trade"
]
},
{
"id": 1,
"type": "buy_or_sell_side",
"name": "Sell Side",
"description": "The asset was sold at the prevailing best bid price on an exchange.",
"asset_class": "crypto",
"data_types": [
"trade"
]
},
{
"id": 2,
"type": "buy_or_sell_side",
"name": "Buy Side",
"description": "The asset was bought at the prevailing best ask price on an exchange.",
"asset_class": "crypto",
"data_types": [
"trade"
]
},
{
"id": 201,
"type": "sale_condition",
"abbreviation": "CANC",
"name": "Canceled",
"description": "Transaction previously reported (other than as the last or opening report for the particular option contract) is now to be canceled.",
"asset_class": "options",
"sip_mapping": {
"OPRA": "A"
},
"update_rules": {
"consolidated": {
"updates_high_low": false,
"updates_open_close": false,
"updates_volume": false
},
"market_center": {
"updates_high_low": false,
"updates_open_close": false,
"updates_volume": false
}
},
"data_types": [
"trade"
]
},
{
"id": 202,
"type": "sale_condition",
"abbreviation": "OSEQ",
"name": "Late and Out Of Sequence",
"description": "Transaction is being reported late and is out of sequence; i.e., later transactions have been reported for the particular option contract.",
"asset_class": "options",
"sip_mapping": {
"OPRA": "B"
},
"update_rules": {
"consolidated": {
"updates_high_low": false,
"updates_open_close": false,
"updates_volume": false
},
"market_center": {
"updates_high_low": false,
"updates_open_close": false,
"updates_volume": false
}
},
"data_types": [
"trade"
]
},
{
"id": 203,
"type": "sale_condition",
"abbreviation": "CNCL",
"name": "Last and Canceled",
"description": "Transaction is the last reported for the particular option contract and is now canceled.",
"asset_class": "options",
"sip_mapping": {
"OPRA": "C"
},
"update_rules": {
"consolidated": {
"updates_high_low": false,
"updates_open_close": false,
"updates_volume": false
},
"market_center": {
"updates_high_low": false,
"updates_open_close": false,
"updates_volume": false
}
},
"data_types": [
"trade"
]
},
{
"id": 204,
"type": "sale_condition",
"abbreviation": "LATE",
"name": "Late",
"description": "Transaction is being reported late, but is in the correct sequence; i.e., no later transactions have been reported for the particular option contract.",
"asset_class": "options",
"sip_mapping": {
"OPRA": "D"
},
"update_rules": {
"consolidated": {
"updates_high_low": false,
"updates_open_close": false,
"updates_volume": false
},
"market_center": {
"updates_high_low": false,
"updates_open_close": false,
"updates_volume": false
}
},
"data_types": [
"trade"
]
},
{
"id": 205,
"type": "sale_condition",
"abbreviation": "CNCO",
"name": "Opening Trade and Canceled",
"description": "Transaction was the first one (opening) reported this day for this particular option contract. Although later transactions have been reported, this transaction is now to be canceled.",
"asset_class": "options",
"sip_mapping": {
"OPRA": "E"
},
"update_rules": {
"consolidated": {
"updates_high_low": false,
"updates_open_close": false,
"updates_volume": false
},
"market_center": {
"updates_high_low": false,
"updates_open_close": false,
"updates_volume": false
}
},
"data_types": [
"trade"
]
},
{
"id": 206,
"type": "sale_condition",
"abbreviation": "OPEN",
"name": "Opening Trade, Late, and Out Of Sequence",
"description": "Transaction is a late report of the opening trade and is out of sequence; i.e., other transactions have been reported for the particular option contract.",
"asset_class": "options",
"sip_mapping": {
"OPRA": "F"
},
"update_rules": {
"consolidated": {
"updates_high_low": false,
"updates_open_close": false,
"updates_volume": false
},
"market_center": {
"updates_high_low": false,
"updates_open_close": false,
"updates_volume": false
}
},
"data_types": [
"trade"
]
},
{
"id": 207,
"type": "sale_condition",
"abbreviation": "CNOL",
"name": "Only Trade and Canceled",
"description": "Transaction was the only one reported this day for the particular option contract and is now to be canceled.",
"asset_class": "options",
"sip_mapping": {
"OPRA": "G"
},
"update_rules": {
"consolidated": {
"updates_high_low": false,
"updates_open_close": false,
"updates_volume": false
},
"market_center": {
"updates_high_low": false,
"updates_open_close": false,
"updates_volume": false
}
},
"data_types": [
"trade"
]
}
]
}
}