Bloomberg EMSX · Schema

Bloomberg EMSX Order

A trading order in the Bloomberg Execution Management System (EMSX) blotter representing an intent to buy or sell a financial instrument. Orders contain instrument details, quantity, pricing instructions, and lifecycle status, and may have one or more routes to brokers for execution.

BloombergExecution ManagementFinancial ServicesOrder ManagementTrading

Properties

Name Type Description
sequenceNumber integer EMSX order sequence number, the unique identifier for the order within the blotter
ticker string Bloomberg security ticker symbol identifying the instrument to trade
side string Order side indicating the direction of the trade
amount number Total order quantity in shares, contracts, or face value
orderType string Order type specifying pricing and execution behavior
limitPrice number Limit price for limit orders (LMT, STP_LMT, LOC)
stopPrice number Stop trigger price for stop orders (STP, STP_LMT)
timeInForce string Time in force instruction governing how long the order remains active
goodTillDate string Expiration date for GTD (Good Till Date) orders
status string Current lifecycle status of the order
filledAmount number Total quantity filled across all routes
averagePrice number Volume-weighted average fill price across all executions
remainingAmount number Remaining unfilled quantity (amount minus filledAmount)
assetClass string Asset class of the instrument being traded
exchange string Primary exchange or marketplace for the instrument
currency string Trading currency in ISO 4217 three-letter code
account string Trading account identifier for allocation
notes string Free-text notes attached to the order by the trader
traderName string Name of the trader who created the order
createdTime string ISO 8601 timestamp when the order was created
lastModifiedTime string ISO 8601 timestamp when the order was last modified
routes array Summary of routes associated with this order
customFields object Custom user-defined fields configured in the EMSX blotter
View JSON Schema on GitHub

JSON Schema

bloomberg-emsx-order-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://www.bloomberg.com/schemas/emsx/order.json",
  "title": "Bloomberg EMSX Order",
  "description": "A trading order in the Bloomberg Execution Management System (EMSX) blotter representing an intent to buy or sell a financial instrument. Orders contain instrument details, quantity, pricing instructions, and lifecycle status, and may have one or more routes to brokers for execution.",
  "type": "object",
  "required": ["ticker", "side", "amount", "orderType", "timeInForce"],
  "properties": {
    "sequenceNumber": {
      "type": "integer",
      "description": "EMSX order sequence number, the unique identifier for the order within the blotter"
    },
    "ticker": {
      "type": "string",
      "description": "Bloomberg security ticker symbol identifying the instrument to trade",
      "minLength": 1
    },
    "side": {
      "type": "string",
      "enum": ["BUY", "SELL", "SHORT", "COVER"],
      "description": "Order side indicating the direction of the trade"
    },
    "amount": {
      "type": "number",
      "minimum": 1,
      "description": "Total order quantity in shares, contracts, or face value"
    },
    "orderType": {
      "type": "string",
      "enum": ["MKT", "LMT", "STP", "STP_LMT", "MOC", "LOC", "VWAP", "TWAP"],
      "description": "Order type specifying pricing and execution behavior"
    },
    "limitPrice": {
      "type": "number",
      "description": "Limit price for limit orders (LMT, STP_LMT, LOC)"
    },
    "stopPrice": {
      "type": "number",
      "description": "Stop trigger price for stop orders (STP, STP_LMT)"
    },
    "timeInForce": {
      "type": "string",
      "enum": ["DAY", "GTC", "IOC", "FOK", "GTD", "OPG", "CLO"],
      "description": "Time in force instruction governing how long the order remains active"
    },
    "goodTillDate": {
      "type": "string",
      "format": "date",
      "description": "Expiration date for GTD (Good Till Date) orders"
    },
    "status": {
      "type": "string",
      "enum": ["NEW", "WORKING", "PARTIALLY_FILLED", "FILLED", "CANCELLED", "REJECTED", "EXPIRED"],
      "description": "Current lifecycle status of the order"
    },
    "filledAmount": {
      "type": "number",
      "minimum": 0,
      "description": "Total quantity filled across all routes"
    },
    "averagePrice": {
      "type": "number",
      "description": "Volume-weighted average fill price across all executions"
    },
    "remainingAmount": {
      "type": "number",
      "minimum": 0,
      "description": "Remaining unfilled quantity (amount minus filledAmount)"
    },
    "assetClass": {
      "type": "string",
      "enum": ["Equity", "Fixed Income", "Futures", "Options", "FX"],
      "description": "Asset class of the instrument being traded"
    },
    "exchange": {
      "type": "string",
      "description": "Primary exchange or marketplace for the instrument"
    },
    "currency": {
      "type": "string",
      "pattern": "^[A-Z]{3}$",
      "description": "Trading currency in ISO 4217 three-letter code"
    },
    "account": {
      "type": "string",
      "description": "Trading account identifier for allocation"
    },
    "notes": {
      "type": "string",
      "description": "Free-text notes attached to the order by the trader"
    },
    "traderName": {
      "type": "string",
      "description": "Name of the trader who created the order"
    },
    "createdTime": {
      "type": "string",
      "format": "date-time",
      "description": "ISO 8601 timestamp when the order was created"
    },
    "lastModifiedTime": {
      "type": "string",
      "format": "date-time",
      "description": "ISO 8601 timestamp when the order was last modified"
    },
    "routes": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/RouteSummary"
      },
      "description": "Summary of routes associated with this order"
    },
    "customFields": {
      "type": "object",
      "additionalProperties": true,
      "description": "Custom user-defined fields configured in the EMSX blotter"
    }
  },
  "$defs": {
    "RouteSummary": {
      "type": "object",
      "description": "Summary of a route associated with an order",
      "properties": {
        "routeId": {
          "type": "integer",
          "description": "Route identifier"
        },
        "broker": {
          "type": "string",
          "description": "Broker code"
        },
        "status": {
          "type": "string",
          "enum": ["NEW", "WORKING", "PARTIALLY_FILLED", "FILLED", "CANCELLED", "REJECTED"],
          "description": "Route status"
        },
        "filledAmount": {
          "type": "number",
          "description": "Quantity filled on this route"
        },
        "averagePrice": {
          "type": "number",
          "description": "Average fill price on this route"
        }
      }
    }
  }
}