Skip to main content
GET
/
v1
/
order
/
:id
Get Order Status
curl --request GET \
  --url https://api.example.com/v1/order/:id
{
  "id": "<string>",
  "action": {},
  "status": "<string>",
  "createdAt": "<string>",
  "balanceValidatedAt": {},
  "orderPlacedAt": {},
  "orderFilledAt": {},
  "txnFilledAt": {},
  "isComplete": true,
  "terminationReason": {},
  "metadata": {}
}

​
Overview

Retrieve the current status and details of an order. This endpoint returns comprehensive information about the order’s progress through the execution pipeline, including timestamps for each stage and any metadata from Kalshi or on-chain transactions.
This endpoint requires authentication. Include your JWT token in the Authorization header.

​
Path Parameters

​
id
string
required
The order ID (intent ID) returned from the Create Order endpoint

​
Response

​
id
string
required
The order ID
​
action
object
required
The order action details (market, side, quantity, price, etc.)
​
status
string
required
Current order status. Possible values:
  • "pending" - Order created, waiting for balance validation
  • "validated" - Balance validated and locked
  • "placed" - Order placed on Kalshi exchange
  • "filled" - Order filled on Kalshi
  • "txn_filled" - On-chain transaction executed
  • "completed" - Order fully completed
  • "failed" - Order failed (check terminationReason)
​
createdAt
string
required
ISO timestamp when the order was created
​
balanceValidatedAt
string | null
ISO timestamp when balance was validated and locked. null if not yet validated.
​
orderPlacedAt
string | null
ISO timestamp when order was placed on Kalshi. null if not yet placed.
​
orderFilledAt
string | null
ISO timestamp when order was filled on Kalshi. null if not yet filled.
​
txnFilledAt
string | null
ISO timestamp when on-chain transaction was executed. null if not yet executed.
​
isComplete
boolean
required
Whether the order has completed (successfully or with failure)
​
terminationReason
string | null
If the order failed, this contains the reason for failure. null if order succeeded or is still in progress.
​
metadata
object | null
Additional metadata about the order. May include:
  • kalshiOrderId - The Kalshi order ID
  • kalshiOrderStatus - Status from Kalshi
  • kalshiFillCount - Number of contracts filled
  • txHash - On-chain transaction hash (if completed)
  • chainId - Chain ID where transaction was executed
{
  "id": "123",
  "action": {
    "type": "MarketOrder",
    "marketId": "BTC-100K-2024-12",
    "side": "yes",
    "orderType": "buy",
    "quantity": 1,
    "price": 50,
    "quoteAmount": "0.50"
  },
  "status": "filled",
  "createdAt": "2024-01-15T10:00:00.000Z",
  "balanceValidatedAt": "2024-01-15T10:00:05.000Z",
  "orderPlacedAt": "2024-01-15T10:00:10.000Z",
  "orderFilledAt": "2024-01-15T10:00:30.000Z",
  "txnFilledAt": null,
  "isComplete": false,
  "terminationReason": null,
  "metadata": {
    "kalshiOrderId": "ORD-12345",
    "kalshiOrderStatus": "filled",
    "kalshiFillCount": 1
  }
}