Skip to main content
POST
/
kalshi
/
order
/
limit
cURL
curl --request POST \
  --url https://api.example.com/kalshi/order/limit \
  --header 'Content-Type: application/json' \
  --data '
{
  "chain": "base",
  "marketId": "PRES-2024",
  "ccontracts": "1050",
  "priceUusdc": "750000",
  "action": "buy",
  "side": "yes",
  "userAddress": "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266",
  "signature": "0x...",
  "expiry": 1234567890,
  "devAccountId": "bison"
}
'
{
  "success": true,
  "orderId": "<string>",
  "status": "<string>",
  "message": "<string>"
}
To avoid ambiguity, we denote the smallest possible multiple of USDC (0.000001 USDC) as one uusdc, which stands for µUSDC (micro-USDC), and denote the smallest possible multiple of a contract (0.01 contract) as one ccontract (centicontract).User-facing USDC balances are specified as fixed-point strings (e.g. "1.2625" for USDC). Contract quantities in the API and SDK are specified as integer ccontracts strings (e.g. "1050" for 10.50 contracts at precision 2).

Body

application/json
​
chain
enum<string>
required

Chain to execute the action on; one of: base, bsc

Available options:
base,
bsc
Example:

"base"

​
marketId
string
required

ID of the market to buy/sell in

Example:

"PRES-2024"

​
ccontracts
string
required

Number of ccontracts as a positive integer string (1 contract = 100 ccontracts).

Example:

"1050"

​
priceUusdc
string
required

Price per contract in µUSDC (micro-USDC, 1 µUSDC = 0.000001 USD). Must be positive integer string.

Example:

"750000"

​
action
enum<string>
required

Action to execute

Available options:
buy,
sell
Example:

"buy"

​
side
enum<string>
required

Side of the market (yes or no)

Available options:
yes,
no
Example:

"yes"

​
userAddress
string
required

User wallet address

Example:

"0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266"

​
signature
string
required

EIP-712 signature from the user authorizing the order

Example:

"0x..."

​
expiry
number
required

Unix timestamp when the authorization expires

Example:

1234567890

​
devAccountId
string

Optional dev account ID to attribute this order to

Example:

"bison"

Response

Order placed successfully

​
success
boolean
required
​
orderId
string
required
​
status
string
required
​
message
string