kalshi_create_order_v2
Submit event-market orders via the V2 endpoint, using single-book bid/ask side and fixed-point dollar prices. Migrate from the legacy /portfolio/orders endpoint to this path.
Instructions
Create Order (V2) Endpoint for submitting event-market orders using the V2 request/response shape (single-book bid/ask side and fixed-point dollar prices). The legacy /portfolio/orders endpoint will be deprecated no earlier than May 6, 2026 — clients should migrate to this path. Calls POST /portfolio/events/orders.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| side | Yes | ||
| count | Yes | String representation of the order quantity in contracts. | |
| price | Yes | Price for the order in fixed-point dollars. | |
| ticker | Yes | ||
| post_only | No | ||
| subaccount | No | The subaccount number to use for this order. 0 is the primary subaccount. Subaccount-restricted API keys must omit this field or pass their locked subaccount. | |
| reduce_only | No | Specifies whether the order place count should be capped by the member's current position. | |
| time_in_force | Yes | Specifies how long the order remains active. Use `good_till_canceled` with `expiration_time` for an order that should rest until a specific expiration time; without `expiration_time`, `good_till_canceled` is a true good-till-canceled order. `GTT` is not a valid API value. | |
| exchange_index | No | Exchange shard index. Defaults to 0. Use -1 to auto-route by market ticker. | |
| order_group_id | No | The order group this order is part of | |
| client_order_id | No | ||
| expiration_time | No | Optional Unix timestamp in seconds for when the order expires. To place an expiring order, set `time_in_force` to `good_till_canceled` and provide this `expiration_time`. `GTT` is an internal execution type and is not a valid API value for `time_in_force`. The `immediate_or_cancel` time-in-force value cannot be combined with `expiration_time`. | |
| cancel_order_on_pause | No | If this flag is set to true, the order will be canceled if the order is open and trading on the exchange is paused for any reason. | |
| self_trade_prevention_type | Yes |