---
title: "Cancel Order (V2)"
method: DELETE
path: "/portfolio/events/orders/{order_id}"
tags: ["orders"]
---

# Cancel Order (V2)

`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`

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.

## Path parameters

- `order_id` string, required

## Query parameters

- `subaccount` integer
- `exchange_index` integer: Identifier for an exchange shard.
- `market_ticker` string

## Response `200`

Order cancelled successfully

- CancelOrderV2Response
  - `order_id` string, required
  - `client_order_id` string
  - `reduced_by` string, 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_ms` integer, required: Matching engine timestamp at which the cancellation was processed, as Unix epoch milliseconds.

## Other responses

- `401`: Unauthorized - authentication required
- `404`: Resource not found
- `500`: Internal server error

## Changes

- **2026-10-16** `bd0c218a65b7`: 1 warning
  - for the `query` request parameter `subaccount`, the min was set to `0.00`
- **2026-07-31** `a07481be8bf9`: 3 warning
  - removed the optional property `service` from the response with the `401` status
  - removed the optional property `service` from the response with the `404` status
  - removed the optional property `service` from the response with the `500` status
- **2026-07-13** `a671b3e77f35`: 1 info
  - added the new optional `query` request parameter `market_ticker`
- **2026-05-18** `7e31fc4590e0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/kalshi/apis/kalshi-trade-api-manual-endpoints/changes/portfolio/events/orders/:order_id/delete.md)

---

[API](https://skmtc.dev/kalshi/apis/kalshi-trade-api-manual-endpoints.md) - [All operations](https://skmtc.dev/kalshi/apis/kalshi-trade-api-manual-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/kalshi/apis/kalshi-trade-api-manual-endpoints/revisions/e6691cdd1915?raw)