Skip to main content
GET
Get Order

Headers

PX-Key-Id
string
required

The key id issued for your signing keypair.

PX-Timestamp
string
required

Unix seconds at signing, valid within 30 seconds of the server clock.

PX-Signature
string
required

Ed25519 signature of the request

PX-Content-Sha256
string
required

Hex SHA-256 of the request body, or the SHA-256 of the empty string when there is no body.

Path Parameters

orderId
string<uuid>
required

Issued order id.

Example:

"3f8b2c9a-2d18-4f7e-9c2a-1b6e1f0c8a4d"

Response

Order found

orderId
string<uuid>
required

Issued order id.

Example:

"3f8b2c9a-2d18-4f7e-9c2a-1b6e1f0c8a4d"

ticker
string
required

Kalshi market ticker the order trades.

Example:

"KXPRES-2028"

side
enum<string>
required

Order direction on the market's YES book.

Selling YES is the same order as buying NO, so ASK covers both.

Available options:
BID,
ASK
Example:

"BID"

type
enum<string>
required

Order type. Kalshi orders are limit orders.

Available options:
LIMIT
Example:

"LIMIT"

count
string
required

Order size in contracts, as a decimal string.

Example:

"10"

yesPrice
string | null
required

Limit price per YES contract in dollars, or null when unavailable.

noPrice
string | null
required

Complementary limit price per NO contract in dollars, or null when unavailable.

outcomeSide
enum<string>
required

Economic direction of an order, YES for BID and NO for ASK.

Available options:
YES,
NO
Example:

"YES"

price
string | null
required
deprecated

Deprecated; use yesPrice for the limit price per YES contract in dollars.

Example:

"0.38"

postOnly
boolean
required

Whether the order was placed as maker-only.

Example:

false

status
enum<string>
required

Order lifecycle status.

Available options:
PENDING,
SUBMITTED,
OPEN,
FILLED,
CANCELLED,
REJECTED
Example:

"OPEN"

venueOrderId
string | null
required

Kalshi order id, or null until the venue acknowledges the order.

Example:

"b4d9e1f2-3a6c-4d8e-9f1a-2b3c4d5e6f70"

createdAt
string
required

Time the order was created, in ISO-8601.

Example:

"2026-07-26T12:00:00.000Z"

updatedAt
string
required

Time the order was last updated, in ISO-8601.

Example:

"2026-07-26T12:05:00.000Z"

filledCount
string | null
required

Contracts filled so far as a decimal string, or null before any fill.

Example:

"4"

averageYesPrice
string | null
required

Fill-weighted average price per YES contract in dollars, or null before any fill.

averageNoPrice
string | null
required

Complementary fill-weighted average price per NO contract in dollars, or null before any fill.

averagePrice
string | null
required
deprecated

Deprecated; use averageYesPrice for the fill-weighted average price per YES contract in dollars.

Example:

"0.3725"

feesCents
integer | null
required

Total fees charged, rounded to the nearest whole cent, or null before any fill.

Example:

6

feesUsd
string | null
required

Total fees charged in dollars, exact to the granularity the venue charges, or null before any fill. Charged on top of the executed notional, so it is additive to cost on a buy and deducted from proceeds on a sell.

Example:

"0.063000"

closedAt
string | null
required

Time the order reached a terminal state, or null while still open.

Example:

"2026-07-26T12:10:00.000Z"

clientOrderId
string
required

Your own identifier for this order as you supplied it, otherwise its orderId.

Example:

"order-1"

queuePosition
string | null

Contracts ahead of this order in price-time priority, or null when unavailable.