PlaceOptionOrder
Submit an order to buy or sell option contracts.
POST
PlaceOptionOrder🔐 AuthCreates a new option order. Orders are signed with your Dilithium-3 private key and executed deterministically on-chain.
Request
| Parameter | Type | Description |
|---|---|---|
contract_idrequired | uint32 | Option contract ID |
siderequired | OrderSide | BUY (0) or SELL (1) |
pricerequired | int64 | Limit price per contract (8 decimals) |
sizerequired | int64 | Number of contracts (8 decimals) |
time_in_forceoptional | TimeInForce | GTC (0), IOC (1), FOK (2)Default: GTC |
reduce_onlyoptional | bool | If true, can only reduce positionDefault: false |
Response
| Field | Type | Description |
|---|---|---|
success | bool | Whether order was accepted |
order_id | uint64 | Unique order identifier |
status | OrderStatus | OPEN, FILLED, PARTIALLY_FILLED, CANCELED |
filled_size | int64 | Contracts filled immediately (8 decimals) |
filled_price | int64 | Average fill price (8 decimals) |
premium_paid | int64 | Total premium paid/received (8 decimals) |
error | string | Error message if failed |