Get Admin Messages
GET/v1/native/iex/admin/messages/:symbol
Get Admin Messages
Request
Path Parameters
The symbol identifier
Query Parameters
Optional date in format YYYY-MM-DD (defaults to latest available data)
Responses
- 200
successful operation
- application/json
- Schema
- Example (from schema)
- Example
Schema
Array [
]
trading_status
object
Represents the response DTO for trading status information
The stock symbol
Original timestamp in nanoseconds since epoch
Time when the trading status was recorded as DateTime
Gets whether the security is currently trading on IEX
Gets whether the security is halted across all US equity markets
Gets whether the security is in Order Acceptance Period on IEX
Gets whether the security is paused and in Order Acceptance Period on IEX
Gets whether the halt reason is News Pending
Gets whether the halt reason is IPO Not Yet Trading
Gets whether the halt reason is IPO Deferred
Gets whether the order acceptance period reason is Halt News Dissemination
Gets whether the order acceptance period reason is IPO Order Acceptance Period
Gets whether the order acceptance period reason is IPO Pre-Launch Period
Gets whether the order acceptance period reason is Market-Wide Circuit Breaker Level 1 – Breached
Gets whether the order acceptance period reason is Market-Wide Circuit Breaker Level 2 – Breached
Gets whether the halt reason is Market-Wide Circuit Breaker Level 3 – Breached
Gets whether the reason is Not Applicable
Gets whether the halt reason is Not Available
official_price
object
Represents the response DTO for official price information
The stock symbol
Original timestamp in nanoseconds since epoch
Time when the official price was recorded as DateTime
Type of price as byte value
Type of price as character string
Human-readable description of the price type
Indicates if the price type is 'IEX Official Opening Price' ('Q'/0x51).
Indicates if the price type is 'IEX Official Closing Price' ('M'/0x4d).
Official price as decimal
security_event
object
Represents the response DTO for security event information
The stock symbol
Original timestamp in nanoseconds since epoch
Time when the security event was recorded as DateTime
Security event as byte value
Security event as character string ('O' or 'C')
Human-readable description of the security event
Indicates if the security event is 'Opening Process Complete' ('O'/0x4f).
Indicates if the security event is 'Closing Process Complete' ('C'/0x43).
auction_information
object
Represents the response DTO for auction information
The stock symbol
Original timestamp in nanoseconds since epoch
Time when the auction data was recorded as DateTime
Type of auction as byte value
Type of auction as character string
Human-readable description of the auction type
Indicates if the auction type is 'Opening Auction' ('O'/0x4f).
Indicates if the auction type is 'Closing Auction' ('C'/0x43).
Indicates if the auction type is 'IPO Auction' ('I'/0x49).
Indicates if the auction type is 'Halt Auction' ('H'/0x48).
Indicates if the auction type is 'Volatility Auction' ('V'/0x56).
Number of shares paired at the Reference Price
Reference price as decimal
Indicative clearing price as decimal
Number of unpaired shares at the Reference Price
Side of the imbalance as byte value
Side of the imbalance as character string
Human-readable description of the imbalance side
Indicates if there is a buy-side imbalance ('B'/0x42).
Indicates if there is a sell-side imbalance ('S'/0x53).
Indicates if there is no imbalance ('N'/0x4e).
Number of extensions to the auction
Scheduled auction time in seconds since epoch
Scheduled time for the auction as DateTime
Auction book clearing price as decimal
Collar reference price as decimal
Lower auction collar as decimal
Upper auction collar as decimal
short_sale_price_test
object
Represents the response DTO for short sale price test status information
The stock symbol
Original timestamp in nanoseconds since epoch
Time when the short sale price test status was recorded as DateTime
Short sale price test status as byte value
Short sale price test status as hex string
Human-readable description of the short sale price test status
Indicates if the short sale price test is not in effect
Indicates if the short sale price test is in effect
Detail of the short sale price test as byte value
Detail of the short sale price test as character string
Human-readable description of the short sale price test detail
Indicates if there is no price test in place
Indicates if the short sale price test restriction is in effect due to an intraday price drop
Indicates if the short sale price test restriction remains in effect from prior day
Indicates if the short sale price test restriction is deactivated
Indicates if the detail is not available
operational_halt_status
object
Represents the response DTO for operational halt status information
The stock symbol
Original timestamp in nanoseconds since epoch
Time when the operational halt status was recorded as DateTime
Operational halt status as byte value
Operational halt status as character string
Human-readable description of the operational halt status
Indicates if the status is 'IEX specific operational trading halt' ('O'/0x4f).
Indicates if the status is 'Not operationally halted on IEX' ('N'/0x4e).
retail_liquidity_indicator
object
Represents the response DTO for retail liquidity indicator information
The stock symbol
Original timestamp in nanoseconds since epoch
Time when the retail liquidity indicator was recorded as DateTime
Retail liquidity indicator as byte value
Retail liquidity indicator as character string
Human-readable description of the retail liquidity indicator
Indicates if the indicator is 'Not Applicable' (' '/0x20).
Indicates if there is 'Buy interest for Retail' ('A'/0x41).
Indicates if there is 'Sell interest for Retail' ('B'/0x42).
Indicates if there is 'Buy and sell interest for Retail' ('C'/0x43).
system_event
object
Represents the response DTO for system event information
Original timestamp in nanoseconds since epoch
Time when the system event was recorded as DateTime
System event as byte value
System event as string
Human-readable description of the system event
Indicates if the system event is 'Start of Messages' (O). Outside of heartbeat messages on the lower level protocol, the start of day message is the first message sent in any trading session.
Indicates if the system event is 'Start of System Hours' (S). This message indicates that IEX is open and ready to start accepting orders.
Indicates if the system event is 'Start of Regular Market Hours' (R). This message indicates that DAY and GTX orders, as well as market orders and pegged orders, are available for execution on IEX.
Indicates if the system event is 'End of Regular Market Hours' (M). This message indicates that DAY orders, market orders, and pegged orders are no longer accepted by IEX.
Indicates if the system event is 'End of System Hours' (E). This message indicates that IEX is now closed and will not accept any new orders during this trading session. It is still possible to receive messages after the end of day.
Indicates if the system event is 'End of Messages' (C). This is always the last message sent in any trading session.
security_directory
object
Represents the response DTO for security directory information
The stock symbol
Original timestamp in nanoseconds since epoch
Time when the security directory information was recorded as DateTime
Flags for the security
Number of shares that represent a round lot
Adjusted previous official closing price as decimal
LULD tier as byte value
LULD tier as numeric string
Human-readable description of the LULD tier
Indicates if LULD Tier is 'Not applicable' (0x0).
Indicates if LULD Tier is 'Tier 1 NMS Stock' (0x1).
Indicates if LULD Tier is 'Tier 2 NMS Stock' (0x2).
[
{
"trading_status": {
"symbol": "string",
"timestamp_nanos": 0,
"timestamp": "2025-04-29T06:11:29.386Z",
"is_trading_live": true,
"is_trading_halted": true,
"is_trading_in_order_acceptance_period": true,
"is_trading_paused": true,
"is_reason_halt_news_pending": true,
"is_reason_ipo_not_yet_trading": true,
"is_reason_ipo_deferred": true,
"is_reason_halt_news_dissemination": true,
"is_reason_ipo_order_acceptance_period": true,
"is_reason_ipo_pre_launch_period": true,
"is_reason_market_wide_circuit_breaker_level1": true,
"is_reason_market_wide_circuit_breaker_level2": true,
"is_reason_market_wide_circuit_breaker_level3": true,
"is_reason_not_applicable": true,
"is_reason_not_available": true
},
"official_price": {
"symbol": "string",
"timestamp_nanos": 0,
"timestamp": "2025-04-29T06:11:29.386Z",
"price_type": 0,
"price_type_code": "string",
"price_type_text": "string",
"is_price_type_opening": true,
"is_price_type_closing": true,
"official_price": 0
},
"security_event": {
"symbol": "string",
"timestamp_nanos": 0,
"timestamp": "2025-04-29T06:11:29.386Z",
"security_event": 0,
"security_event_code": "string",
"security_event_text": "string",
"is_opening_process_complete": true,
"is_closing_process_complete": true
},
"auction_information": {
"symbol": "string",
"timestamp_nanos": 0,
"timestamp": "2025-04-29T06:11:29.386Z",
"auction_type": 0,
"auction_type_code": "string",
"auction_type_text": "string",
"is_auction_type_opening": true,
"is_auction_type_closing": true,
"is_auction_type_ipo": true,
"is_auction_type_halt": true,
"is_auction_type_volatility": true,
"paired_shares": 0,
"reference_price": 0,
"indicative_clearing_price": 0,
"imbalance_shares": 0,
"imbalance_side": 0,
"imbalance_side_code": "string",
"imbalance_side_text": "string",
"is_imbalance_side_buy": true,
"is_imbalance_side_sell": true,
"is_imbalance_side_none": true,
"extension_number": 0,
"scheduled_auction_time_seconds": 0,
"scheduled_auction_time": "2025-04-29T06:11:29.386Z",
"auction_book_clearing_price": 0,
"collar_reference_price": 0,
"lower_auction_collar": 0,
"upper_auction_collar": 0
},
"short_sale_price_test": {
"symbol": "string",
"timestamp_nanos": 0,
"timestamp": "2025-04-29T06:11:29.386Z",
"short_sale_price_test_status": 0,
"short_sale_price_test_status_code": "string",
"short_sale_price_test_status_text": "string",
"is_short_sale_price_test_not_in_effect": true,
"is_short_sale_price_test_in_effect": true,
"detail": 0,
"detail_code": "string",
"detail_text": "string",
"is_detail_no_price_test": true,
"is_detail_activated": true,
"is_detail_continued": true,
"is_detail_deactivated": true,
"is_detail_not_available": true
},
"operational_halt_status": {
"symbol": "string",
"timestamp_nanos": 0,
"timestamp": "2025-04-29T06:11:29.386Z",
"operational_halt_status": 0,
"operational_halt_status_code": "string",
"operational_halt_status_text": "string",
"is_operationally_halted": true,
"is_not_operationally_halted": true
},
"retail_liquidity_indicator": {
"symbol": "string",
"timestamp_nanos": 0,
"timestamp": "2025-04-29T06:11:29.386Z",
"retail_liquidity_indicator": 0,
"retail_liquidity_indicator_code": "string",
"retail_liquidity_indicator_text": "string",
"is_retail_indicator_not_applicable": true,
"is_retail_indicator_buy_interest": true,
"is_retail_indicator_sell_interest": true,
"is_retail_indicator_buy_and_sell_interest": true
},
"system_event": {
"timestamp_nanos": 0,
"timestamp": "2025-04-29T06:11:29.387Z",
"system_event": 0,
"system_event_code": "string",
"system_event_text": "string",
"is_system_event_start_of_messages": true,
"is_system_event_start_of_system_hours": true,
"is_system_event_start_of_regular_market_hours": true,
"is_system_event_end_of_regular_market_hours": true,
"is_system_event_end_of_system_hours": true,
"is_system_event_end_of_messages": true
},
"security_directory": {
"symbol": "string",
"timestamp_nanos": 0,
"timestamp": "2025-04-29T06:11:29.387Z",
"flags": 0,
"round_lot_size": 0,
"adjusted_poc_price": 0,
"luld_tier": 0,
"luld_tier_code": "string",
"luld_tier_text": "string",
"is_luld_tier_not_applicable": true,
"is_luld_tier1": true,
"is_luld_tier2": true
}
}
]
[
{
"trading_status": {
"symbol": "PYPL",
"timestamp_nanos": 1745907074617000000,
"timestamp": "2025-04-29T06:11:14.6170000Z",
"is_trading_live": true,
"is_trading_halted": false,
"is_trading_in_order_acceptance_period": false,
"is_trading_paused": false,
"is_reason_halt_news_pending": false,
"is_reason_ipo_not_yet_trading": false,
"is_reason_ipo_deferred": false,
"is_reason_halt_news_dissemination": false,
"is_reason_ipo_order_acceptance_period": false,
"is_reason_ipo_pre_launch_period": false,
"is_reason_market_wide_circuit_breaker_level1": false,
"is_reason_market_wide_circuit_breaker_level2": false,
"is_reason_market_wide_circuit_breaker_level3": false,
"is_reason_not_applicable": true,
"is_reason_not_available": false
}
},
{
"official_price": {
"symbol": "AAPL",
"timestamp_nanos": 1745907074617000000,
"timestamp": "2025-04-29T06:11:14.6170000Z",
"price_type": 81,
"price_type_code": "Q",
"price_type_text": "IEX Official Opening Price",
"is_price_type_opening": true,
"is_price_type_closing": false,
"official_price": 12.3456
}
},
{
"security_event": {
"symbol": "CRM",
"timestamp_nanos": 1745907074617000000,
"timestamp": "2025-04-29T06:11:14.6170000Z",
"security_event": 79,
"security_event_code": "O",
"security_event_text": "Opening Process Complete",
"is_opening_process_complete": true,
"is_closing_process_complete": false
}
},
{
"auction_information": {
"symbol": "AAPL",
"timestamp_nanos": 1745907074617000000,
"timestamp": "2025-04-29T06:11:14.6170000Z",
"auction_type": 79,
"auction_type_code": "O",
"auction_type_text": "Opening Auction",
"is_auction_type_opening": true,
"is_auction_type_closing": false,
"is_auction_type_ipo": false,
"is_auction_type_halt": false,
"is_auction_type_volatility": false,
"paired_shares": 12500,
"reference_price": 156.42,
"indicative_clearing_price": 156.5,
"imbalance_shares": 2300,
"imbalance_side": 66,
"imbalance_side_code": "B",
"imbalance_side_text": "Buy-side imbalance",
"is_imbalance_side_buy": true,
"is_imbalance_side_sell": false,
"is_imbalance_side_none": false,
"extension_number": 0,
"scheduled_auction_time_seconds": 1745907374,
"scheduled_auction_time": "2025-04-29T06:16:14.0000000Z",
"auction_book_clearing_price": 156.45,
"collar_reference_price": 157,
"lower_auction_collar": 152.5,
"upper_auction_collar": 161.5
}
},
{
"short_sale_price_test": {
"symbol": "MSFT",
"timestamp_nanos": 1745907074617000000,
"timestamp": "2025-04-29T06:11:14.6170000Z",
"short_sale_price_test_status": 1,
"short_sale_price_test_status_code": "1",
"short_sale_price_test_status_text": "Short Sale Price Test in Effect",
"is_short_sale_price_test_not_in_effect": false,
"is_short_sale_price_test_in_effect": true,
"detail": 65,
"detail_code": "A",
"detail_text": "Short sale price test restriction in effect due to an intraday price drop (Activated)",
"is_detail_no_price_test": false,
"is_detail_activated": true,
"is_detail_continued": false,
"is_detail_deactivated": false,
"is_detail_not_available": false
}
},
{
"operational_halt_status": {
"symbol": "AAPL",
"timestamp_nanos": 1745907074617000000,
"timestamp": "2025-04-29T06:11:14.6170000Z",
"operational_halt_status": 79,
"operational_halt_status_code": "O",
"operational_halt_status_text": "IEX specific operational trading halt",
"is_operationally_halted": true,
"is_not_operationally_halted": false
}
},
{
"retail_liquidity_indicator": {
"symbol": "GOOG",
"timestamp_nanos": 1745907074617000000,
"timestamp": "2025-04-29T06:11:14.6170000Z",
"retail_liquidity_indicator": 65,
"retail_liquidity_indicator_code": "A",
"retail_liquidity_indicator_text": "Buy interest for Retail",
"is_retail_indicator_not_applicable": false,
"is_retail_indicator_buy_interest": true,
"is_retail_indicator_sell_interest": false,
"is_retail_indicator_buy_and_sell_interest": false
}
},
{
"system_event": {
"timestamp_nanos": 1745907074617000000,
"timestamp": "2025-04-29T06:11:14.6170000Z",
"system_event": 79,
"system_event_code": "O",
"system_event_text": "Start of Messages – Outside of heartbeat messages on the lower level protocol, the start of day message is the first message sent in any trading session.",
"is_system_event_start_of_messages": true,
"is_system_event_start_of_system_hours": false,
"is_system_event_start_of_regular_market_hours": false,
"is_system_event_end_of_regular_market_hours": false,
"is_system_event_end_of_system_hours": false,
"is_system_event_end_of_messages": false
}
},
{
"security_directory": {
"symbol": "INTC",
"timestamp_nanos": 1745907074617000000,
"timestamp": "2025-04-29T06:11:14.6170000Z",
"flags": 0,
"round_lot_size": 100,
"adjusted_poc_price": 35.36,
"luld_tier": 1,
"luld_tier_code": "1",
"luld_tier_text": "Tier 1 NMS Stock",
"is_luld_tier_not_applicable": false,
"is_luld_tier1": true,
"is_luld_tier2": false
}
}
]