Skip to main content
POST
/
v1
/
order
Create Order
curl --request POST \
  --url https://api.example.com/v1/order \
  --header 'Content-Type: application/json' \
  --data '
{
  "action": {
    "action.type": "<string>",
    "action.data": {
      "action.data.marketId": "<string>",
      "action.data.side": "<string>",
      "action.data.orderType": "<string>",
      "action.data.quantity": 123,
      "action.data.price": 123,
      "action.data.quoteAmount": "<string>"
    }
  },
  "chainId": 123
}
'
{
  "success": true,
  "intent": {
    "intent.id": "<string>",
    "intent.action": {},
    "intent.createdAt": "<string>"
  }
}

​
Overview

Create a new market order for trading prediction market shares. The order will be processed asynchronously through multiple stages: balance validation, placement on Kalshi, fill detection, and on-chain execution.
This endpoint requires authentication. Include your JWT token in the Authorization header.

​
Request Body

​
action
object
required
The order action object
​
chainId
number
Optional chain ID for the transaction. If not provided, uses the default configured chain.

​
Response

​
success
boolean
Always true for successful order creation
​
intent
object
required
The created order intent
{
  "success": true,
  "intent": {
    "id": "123",
    "action": {
      "type": "MarketOrder",
      "marketId": "BTC-100K-2024-12",
      "side": "yes",
      "orderType": "buy",
      "quantity": 1,
      "price": 50,
      "quoteAmount": "0.50"
    },
    "createdAt": "2024-01-15T10:00:00.000Z"
  }
}