KAkalshi
orders

Cancel Order (V2)

Changed on

Endpoint for cancelling event-market orders using the V2 response shape. To auto-route the cancellation, provide market_ticker and omit exchange_index or set it to -1. Returns {order_id, client_order_id, reduced_by} rather than a full order object.

delete/portfolio/events/orders/{order_id}

Request

  • Base URL
    https://external-api.kalshi.com/trade-api/v2
  • URL
    https://external-api.kalshi.com/trade-api/v2/portfolio/events/orders/{order_id}
  • Auth
    API key in header KALSHI-ACCESS-KEY and API key in header KALSHI-ACCESS-SIGNATURE and API key in header KALSHI-ACCESS-TIMESTAMP

Path parameters

order_idstring required

Order ID

Query parameters

subaccountinteger

Subaccount number (0 for primary, 1-63 for subaccounts). Defaults to 0. Subaccount-restricted API keys default to their locked subaccount and must omit this parameter or pass their locked subaccount.

exchange_indexinteger

Identifier for an exchange shard.

Exchange shard index. If omitted, auto-routes when market_ticker is provided; otherwise defaults to 0. Use -1 to require auto-routing. The market_ticker parameter is required for auto-routing.

market_tickerstring

Market ticker. Required for auto-routing when exchange_index is omitted or -1.

Response

Order cancelled successfully

order_idstring required
client_order_idstring
reduced_bystring required

Fixed-point contract count string (2 decimals, e.g., "10.00"; referred to as "fp" in field names). Requests accept 0-2 decimal places (e.g., "10", "10.0", "10.00"); responses always emit 2 decimals. Fractional contract values (e.g., "2.50") are supported; the minimum granularity is 0.01 contracts.

ts_msinteger required

Matching engine timestamp at which the cancellation was processed, as Unix epoch milliseconds.

Example response

{
  "order_id": "3b23c1c7-f4ef-4f0d-8b9a-9e53c61f1a0d",
  "client_order_id": "8c35ecb3-328f-4f52-8c7c-0f4b9862f8d1",
  "reduced_by": "10.00",
  "ts_ms": 1715793660456
}

Changes

  • bd0c218a65b7Revision changes
    • warning

      for the query request parameter subaccount, the min was set to 0.00

  • a07481be8bf9Revision changes
    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status