docs

Kalshi Order Node

The Kalshi Order node places, cancels, and amends binary-contract orders on Kalshi ↗, the regulated US prediction-market exchange. You connect a trade-only API key — scoped so it can trade but never move funds — and the node handles the rest, including the YES/NO direction math that trips up most integrations.

Kalshi Order
Buy Yes • HIGHNY-24JAN01-T60

Configuration

Order

How Kalshi Markets Work

Each Kalshi market is a yes/no question that settles at $1.00 if it resolves in your favor and $0 if it doesn't. Prices range from 1¢ to 99¢ and represent the implied probability — a "Yes" at 56¢ means the market thinks there's a 56% chance the event happens. Buy 10 Yes contracts at 56¢ and you risk $5.60 to win up to $10.00.

This node speaks in plain Yes / No and Buy / Sell — never Kalshi's raw bid/ask. Buying No is handled for you (internally it sells the Yes leg at 1 − price), so you can't accidentally trade the wrong direction.

Buying No and selling Yes are the same underlying trade on Kalshi. The node maps your Yes/No + Buy/Sell selection to the correct wire order automatically — always configure the trade the way you think about it.

Configuration

FieldDescription
Kalshi CredentialYour trade-only Kalshi API key (Key ID + RSA private key + environment). Create one in your Kalshi account with read + write scopes — never write::transfer.
OperationPlace a new order, or Cancel / Amend an existing one by Order ID.
MarketThe Kalshi market ticker, e.g. HIGHNY-24JAN01-T60. Paste a kalshi.com market link and the node extracts the ticker.
OutcomeYes or No.
ActionBuy to open/add, Sell to close/reduce.
SizeNumber of contracts (each settles at $1).
Limit priceOptional. Price in dollars for your chosen outcome, 0.01–0.99 (e.g. 0.56 = 56¢). Leave empty for a marketable order that fills immediately.
Time in forceOptional. Defaults to immediate-or-cancel for marketable orders and good-till-canceled for limit orders.
Reduce onlyCaps the order to your current position so a close can never overshoot and flip you to the other side.
Post onlyGuarantees maker execution.

Credentials & Safety

Kalshi is a custodial, regulated USD venue — your funds, positions, and settlement live in your Kalshi account, not in NickAI. The safety guarantee here is scope, not on-chain custody:

  • The key you store is scoped to trading only (read + write). It cannot deposit, withdraw, or transfer — those require the separate write::transfer scope, which you do not grant.
  • Worst case is a bad trade, never theft of funds.
  • Keys are encrypted at rest, same as every other trading secret.

When creating your API key on Kalshi, grant read and write only. See the Kalshi API key docs ↗.

Build and test against the Demo environment first — it's a full paper-trading sandbox. Switch the credential to Production only when you're ready to trade live.

Pre-flight Checks

Before signing an order, the node:

  1. Confirms the credential is a valid Kalshi trade-only key.
  2. Checks your account balance and verifies the order is affordable (opening orders only — reduce_only closes are exempt).
  3. Translates your Yes/No + Buy/Sell selection into the correct wire order.

The order result includes the order ID, fill count, remaining count, average fill price, and status (executed, partially_filled, or resting).

Pricing

The Kalshi Order node costs 1 credit per execution — a flat charge for the signed API request. Trades themselves settle in your own Kalshi account using your real USD balance.