Skip to main content
POST
/
portfolio
/
events
/
orders
/
{order_id}
/
decrease
Decrease Order (V2)
curl --request POST \
  --url https://external-api.kalshi.com/trade-api/v2/portfolio/events/orders/{order_id}/decrease \
  --header 'Content-Type: application/json' \
  --header 'KALSHI-ACCESS-KEY: <api-key>' \
  --header 'KALSHI-ACCESS-SIGNATURE: <api-key>' \
  --header 'KALSHI-ACCESS-TIMESTAMP: <api-key>' \
  --data '
{
  "reduce_by": "10.00",
  "reduce_to": "10.00",
  "exchange_index": 0
}
'
{
  "order_id": "<string>",
  "remaining_count": "10.00",
  "ts_ms": 123,
  "client_order_id": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.kalshi.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
KALSHI-ACCESS-KEY
string
header
required

Your API key ID

​
KALSHI-ACCESS-SIGNATURE
string
header
required

RSA-PSS signature of the request

​
KALSHI-ACCESS-TIMESTAMP
string
header
required

Request timestamp in milliseconds

Path Parameters

​
order_id
string
required

Order ID

Query Parameters

​
subaccount
integer

Subaccount number (0 for primary, 1-32 for subaccounts). Defaults to 0.

Body

application/json
​
reduce_by
string | null

String representation of the number of contracts to reduce by. Exactly one of reduce_by or reduce_to must be provided.

Example:

"10.00"

​
reduce_to
string | null

String representation of the number of contracts to reduce to. Exactly one of reduce_by or reduce_to must be provided.

Example:

"10.00"

​
exchange_index
integer
default:0

Identifier for an exchange shard. Defaults to 0 if unspecified. Note: currently only 0 supported.

Example:

0

Response

Order decreased successfully

​
order_id
string
required
​
remaining_count
string
required

Number of contracts remaining after the decrease.

Example:

"10.00"

​
ts_ms
integer<int64>
required

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

​
client_order_id
string