Skip to content

    Assignment / Exercise Event

    draft

    Broker-reported assignment, exercise, or expiration event on an option contract.

    Verification note

    Draft — verification pending against Velocity OMS event stream.

    Example payload

    Realistic wire-shaped payload a conforming producer would emit. Validates against the schema above.

    {
      "option_symbol": "AAPL  260918C00235000",
      "kind": "ASSIGNMENT",
      "quantity": 3,
      "settlement": "PHYSICAL",
      "shares_delivered": 300,
      "occurred_at": "2026-09-18T21:00:00Z"
    }

    JSON Schema

    draft/2020-12
    {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "$id": "https://rebeltrade.com/options-schema/v0.1/executions/event.assignment.json",
      "type": "object",
      "required": [
        "option_symbol",
        "kind",
        "quantity",
        "occurred_at"
      ],
      "properties": {
        "option_symbol": {
          "$ref": "https://rebeltrade.com/options-schema/v0.1/types/OptionSymbol.json"
        },
        "kind": {
          "enum": [
            "ASSIGNMENT",
            "EXERCISE",
            "EXPIRATION"
          ]
        },
        "quantity": {
          "type": "integer",
          "minimum": 1
        },
        "settlement": {
          "$ref": "https://rebeltrade.com/options-schema/v0.1/types/Settlement.json"
        },
        "shares_delivered": {
          "type": "integer"
        },
        "cash_settled_amount": {
          "$ref": "https://rebeltrade.com/options-schema/v0.1/types/Money.json"
        },
        "occurred_at": {
          "$ref": "https://rebeltrade.com/options-schema/v0.1/types/Timestamp.json"
        }
      }
    }