Get Level-3 Order Book
GET/v1/native/iex/level3-order-book/:symbol
Get Level-3 Order Book
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 [
]
add_order
object
Represents the response DTO for add order information
The stock symbol
Original timestamp in nanoseconds since epoch
Time when the order was added as DateTime (UTC)
Indicates if this is a Buy order ('8'/0x38).
Quoted size in number of shares
Price as decimal
Order identifier
delete_order
object
Represents the response DTO for order delete information
The stock symbol
Original timestamp in nanoseconds since epoch
Time when the order was deleted as DateTime
Order identifier reference
modify_order
object
Represents the response DTO for order modify information
The stock symbol
Original timestamp in nanoseconds since epoch
Time when the order was modified as DateTime (UTC)
Order identifier reference
Indicates if priority is reseted
New total quoted size in number of shares
Price as decimal
executed_order
object
Represents the response DTO for order executed information
The stock symbol
Original timestamp in nanoseconds since epoch
Time when the order was executed as DateTime
Order identifier reference
Sale condition flags for the execution as byte value
Bit 7 (Mask 0x80): Intermarket Sweep Flag True: Intermarket Sweep Order ("ISO") False: Non-Intermarket Sweep Order
Bit 6 (Mask 0x40): Extended Hours Flag True: Extended Hours Trade (i.e., Form T sale condition) False: Regular Market Session Trade
Bit 5 (Mask 0x20): Odd Lot Flag True: Odd Lot Trade False: Round or Mixed Lot Trade
Bit 4 (Mask 0x10): Trade Through Exempt Flag True: Trade is not subject to Rule 611 (Trade Through) of SEC Reg. NMS False: Trade is subject to Rule 611 (Trade Through) of SEC Reg. NMS
Bit 3 (Mask 0x08): Single-price Cross Trade Flag True: Trade resulting from a single-price cross False: Execution during continuous trading
Trade volume in number of shares
Execution price as decimal
IEX trade identifier
clear_book
object
Represents the response DTO for clear book information
The stock symbol
Original timestamp in nanoseconds since epoch
Time when the book was cleared as DateTime
[
{
"add_order": {
"symbol": "string",
"timestamp_nanos": 0,
"timestamp": "2025-04-29T06:11:29.397Z",
"is_side_buy": true,
"size": 0,
"price": 0,
"order_id": 0
},
"delete_order": {
"symbol": "string",
"timestamp_nanos": 0,
"timestamp": "2025-04-29T06:11:29.397Z",
"order_id_reference": 0
},
"modify_order": {
"symbol": "string",
"timestamp_nanos": 0,
"timestamp": "2025-04-29T06:11:29.397Z",
"order_id_reference": 0,
"is_priority_reset": true,
"size": 0,
"price": 0
},
"executed_order": {
"symbol": "string",
"timestamp_nanos": 0,
"timestamp": "2025-04-29T06:11:29.397Z",
"order_id_reference": 0,
"sale_condition_flags": 0,
"is_intermarket_sweep": true,
"is_extended_hours_trade": true,
"is_odd_lot_trade": true,
"is_trade_through_exempt": true,
"is_single_price_cross_trade": true,
"size": 0,
"price": 0,
"trade_id": 0
},
"clear_book": {
"symbol": "string",
"timestamp_nanos": 0,
"timestamp": "2025-04-29T06:11:29.397Z"
}
}
]
[
{
"add_order": {
"symbol": "AAPL",
"timestamp_nanos": 1745907074626000000,
"timestamp": "2025-04-29T06:11:14.6260000Z",
"is_side_buy": true,
"size": 100,
"price": 176.42,
"order_id": 123456789
}
},
{
"delete_order": {
"symbol": "TSLA",
"timestamp_nanos": 1745907074626000000,
"timestamp": "2025-04-29T06:11:14.6260000Z",
"order_id_reference": 987654321
}
},
{
"modify_order": {
"symbol": "NFLX",
"timestamp_nanos": 1745907074626000000,
"timestamp": "2025-04-29T06:11:14.6260000Z",
"order_id_reference": 789456123,
"is_priority_reset": false,
"size": 150,
"price": 625.85
}
},
{
"executed_order": {
"symbol": "META",
"timestamp_nanos": 1745907074626000000,
"timestamp": "2025-04-29T06:11:14.6260000Z",
"order_id_reference": 555123456,
"sale_condition_flags": 0,
"is_intermarket_sweep": false,
"is_extended_hours_trade": false,
"is_odd_lot_trade": false,
"is_trade_through_exempt": false,
"is_single_price_cross_trade": false,
"size": 200,
"price": 421,
"trade_id": 123987456
}
},
{
"clear_book": {
"symbol": "MSFT",
"timestamp_nanos": 1745907074626000000,
"timestamp": "2025-04-29T06:11:14.6260000Z"
}
}
]