{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "$id": "https://firmtape.com/contracts/public/events/alerts/order.schema.json",
 "title": "order",
 "description": "Sent when a new order in today's SPX ledger matches one of your order rules.",
 "type": "object",
 "required": [
  "version",
  "id",
  "type",
  "symbol",
  "ts",
  "day",
  "rule",
  "order",
  "text"
 ],
 "properties": {
  "version": {
   "type": "integer",
   "const": 1,
   "description": "Payload version, `1`."
  },
  "id": {
   "type": "string",
   "description": "Event id: the order's, the same for every account.",
   "pattern": "^evt_[0-9a-z_]+$"
  },
  "type": {
   "const": "order",
   "description": "`order`."
  },
  "symbol": {
   "type": "string",
   "description": "`SPX`."
  },
  "ts": {
   "type": "string",
   "description": "When it was found, ISO 8601 in New York time."
  },
  "day": {
   "type": "string",
   "description": "The ET trading day."
  },
  "rule": {
   "type": "object",
   "description": "The rule that matched.",
   "properties": {
    "id": {
     "type": "string",
     "description": "The rule's id."
    },
    "name": {
     "type": "string",
     "description": "Its name."
    }
   }
  },
  "order": {
   "type": "object",
   "description": "The order, as the ledger has it.",
   "properties": {
    "id": {
     "type": "string",
     "description": "The order's id in the session."
    },
    "time": {
     "type": [
      "string",
      "null"
     ],
     "description": "When it printed, ET."
    },
    "structure": {
     "type": "string",
     "description": "The structure, in words."
    },
    "legs": {
     "type": "array",
     "items": {
      "type": "object",
      "properties": {
       "strike": {
        "type": "number",
        "description": "Strike."
       },
       "right": {
        "type": "string",
        "description": "`C` or `P`."
       }
      }
     },
     "description": "The legs."
    },
    "expiry": {
     "type": [
      "string",
      "null"
     ],
     "description": "The expiry carrying most of its gamma."
    },
    "expiry_bucket": {
     "type": [
      "string",
      "null"
     ],
     "description": "The expiry bucket the rules read."
    },
    "size": {
     "type": [
      "number",
      "null"
     ],
     "description": "Contracts."
    },
    "premium_usd": {
     "type": [
      "number",
      "null"
     ],
     "description": "Net premium.",
     "x-unit": "USD"
    },
    "flip_points": {
     "type": [
      "number",
      "null"
     ],
     "description": "Points from the flip at that minute.",
     "x-unit": "index points"
    },
    "flip_side": {
     "type": [
      "string",
      "null"
     ],
     "enum": [
      "above",
      "below",
      null
     ],
     "description": "Its side of the flip."
    },
    "wall_points": {
     "type": [
      "number",
      "null"
     ],
     "description": "Points from the nearest wall.",
     "x-unit": "index points"
    },
    "strike_share_pct": {
     "type": [
      "number",
      "null"
     ],
     "description": "Its share of its strike's volume, percent."
    },
    "open_interest": {
     "type": [
      "array",
      "null"
     ],
     "description": "The legs' morning open interest."
    }
   }
  },
  "text": {
   "type": "string",
   "description": "The sentence Telegram and push show."
  }
 },
 "x-when": [
  "Today's ledger is read every five seconds in session; a new order that matches a rule that is on goes out once.",
  "At most thirty order alerts an hour per account."
 ],
 "x-features": [
  "order-rules",
  "webhooks"
 ],
 "examples": [
  {
   "version": 1,
   "id": "evt_5c1d2e3f4a5b6c7d8e9f0a1b",
   "type": "order",
   "symbol": "SPX",
   "ts": "2026-10-09T13:43:10-04:00",
   "day": "2026-10-09",
   "rule": {
    "id": "r1",
    "name": "Large put spreads"
   },
   "order": {
    "id": "p79654",
    "time": "13:43",
    "structure": "put vertical",
    "legs": [
     {
      "strike": 7740,
      "right": "P"
     },
     {
      "strike": 7750,
      "right": "P"
     }
    ],
    "expiry": "Oct 9",
    "expiry_bucket": "0dte",
    "size": 1958,
    "premium_usd": 150000,
    "flip_points": 38,
    "flip_side": "above",
    "wall_points": 12,
    "strike_share_pct": 31,
    "open_interest": null
   },
   "text": "Put vertical 7740/7750, $150k net, Oct 9"
  }
 ],
 "x-source": "alerts",
 "x-product": "live",
 "x-plan": "orders",
 "x-version": 1,
 "x-since": "2026-10-11",
 "x-switch-on": "ORDERS, RULES in the terminal; the alert goes where your level alerts go."
}