Getting Started

Connecting Your Kalshi Account

Before you can trade, you must connect your Kalshi API credentials:

  1. Navigate to Order Entry from the Prediction Dashboard

  2. You'll be prompted to enter your Kalshi API Key and Secret

  3. Choose between Demo (paper trading) or Live (real money) environment

  4. Your credentials are encrypted and stored securely

Tip: Start with Demo mode to practice before trading with real funds.

The Order Entry page consists of several key sections from top to bottom:

  • Header – Shows the selected contract name (with live scores during games), contract selector, and settings

  • Control Bar – Chart timeframe, chart style toggle, position info, and last price

  • Price Chart – Line or block chart showing contract price history

  • Orderbook – Interactive bid/offer display with your open orders

  • Action Row – BUY/SELL buttons with quantity and price inputs

  • Macro Carousel – Quick action buttons for common operations

Selecting Contracts

Using the Contract Selector

Tap the contract name in the header to open the Contract Selector modal:

  • Date Filter – Browse contracts by game date

  • Search – Type to search for specific teams or contracts

  • Contract List – Shows all available contracts with current prices

Tip: The selector remembers your last selected contract and date for faster access next time.

Live Game Scores

Once a game starts, the header displays live scores alongside the contract name (e.g., "26 DAL to win vs MIN 34"). Scores appear in the accent color for quick visibility.

Reading the Charts

Chart Timeframes

Tap the timeframe button (e.g., "1H", "4H", "1D") to cycle through:

  • 1H – One hour of data

  • 4H – Four hours of data

  • 1D – Full trading day

  • 1W – One week of historical data

Chart Styles

Toggle between two chart types using the icon next to the timeframe button:

  • Line Chart – Traditional price line with smooth curves

  • Block Chart – Brick-style visualization showing price movement blocks

Chart Indicators

When enabled in Settings:

  • Position Line – Horizontal line showing your average entry price

  • Order Lines – Markers showing your open order prices

Y-Axis Scale

Click the left Y-axis margin to cycle through three scale modes:

  1. Default – Adaptive scale based on current price

  2. Expanded – Default domain ±10 on each side

  3. Full – Fixed 0-100 range

Using the Orderbook

Understanding the Display

The orderbook shows two columns:

  • Left (Bids) – Buy orders from the market

  • Right (Offers) – Sell orders from the market

Each row displays the Price and the Total Quantity at that level. Your open orders appear as colored badges on the appropriate rows.

Selecting Prices

Tap any orderbook row to:

  • Set that price as your order price

  • Highlight the selected row

Drag-to-Modify Orders

Move your open orders to different price levels:

  1. Press and hold an order badge for 200ms

  2. Drag up or down to the target price row

  3. Release to move the order

The row highlights as you drag, showing where the order will be placed.

Tip: Dragging uses Kalshi's Amend Order endpoint, which preserves your queue position.

Tapping Orders

Tap an order badge (without dragging) to open the Order Modify Modal, where you can:

  • Adjust quantity

  • Change price precisely

  • Cancel the order

Placing Orders

Using the Action Row

The action row contains four elements:

  1. BUY Button – Place a buy order at the current price/quantity

  2. QTY Input – Tap to open quantity entry panel

  3. PRC Input – Tap to open price entry panel

  4. SELL Button – Place a sell order at the current price/quantity

Quantity Entry Panel

Tap the QTY input to open a full number pad:

  • Digits 0-9 – Build your quantity

  • Clear – Reset to empty

  • Enter – Confirm and close panel

Quick Amounts:

  • Position – Sets Quantity to your current position size

  • $20, $30, $50, $75, $100 – Automatically calculates contract quantity based on current price

Tip: When a dollar amount is active, a badge shows above the quantity input (e.g., "$50").

Price Entry Panel

Tap the PRC input for a similar number pad limited to prices 1-99.

Order Confirmation

When "Confirm orders" is enabled in Settings, you'll see a confirmation dialog before each order is submitted showing:

  • Contract ticker

  • Side (Buy/Sell)

  • Quantity and Price

  • Estimated cost

The bottom carousel provides quick actions across three swipeable pages:

Center Page (Main Controls)

  • Exit – Close your entire position at an aggressive price (also cancels all open orders for this contract)

  • CXL – Cancel the last submitted order

  • CXL ALL – Cancel all open orders for the current contract

  • Reverse – Close and reverse position (2x size)

Left Page (Buy Macros)

  • B1, B2, B3, B4 – Custom buy macro buttons (placeholder)

Right Page (Sell Macros)

  • S1, S2, S3, S4 – Custom sell macro buttons (placeholder)

Use the left/right arrows (desktop) or swipe (mobile) to navigate pages.

Keyboard Shortcuts

When "Enable hotkeys" is turned on in Settings:

  • B – Place buy order at current price/quantity

  • S – Place sell order at current price/quantity

  • Esc – Cancel last submitted order (or most recent if that order is gone)

Tip: Hotkeys are disabled when typing in unrelated input fields.

Settings & Customization

Tap the gear icon in the header to access Order Entry Settings:

Order Controls

  • Cancel All Orders (This Contract) – Immediately cancel all orders for the selected contract

  • Cancel All Orders (All Contracts) – Cancel your entire order book

Trading Preferences

  • Confirm orders – Show confirmation dialog before submitting orders

  • Enable hotkeys – Activate keyboard shortcuts (B, S, Esc)

Default Quantity

Set the quantity used when you have no existing position:

  • Number of Contracts – Fixed contract count (default: 10)

  • Dollar Amount – Automatically calculated based on price

Chart Settings

  • Chart update frequency – How often the chart refreshes during games (1s, 2s, 5s, 10s, 60s)

  • Show position line – Display your average price on the chart

  • Show order lines – Display open orders on the chart

Appearance

  • Dark Mode – Toggle between dark navy and white background

  • Colored Buy/Sell Buttons – Use Up/Down colors instead of default button color

  • Reverse Buy/Sell Buttons – Swap button positions (SELL | QTY | PRC | BUY)

Custom Colors

Fully customize the color scheme for both Light and Dark modes:

  • Background – Main page background

  • Main Text – Primary text color

  • Accent – Labels, muted text, borders

  • Buttons – Button backgrounds

  • Button Text – Text on buttons

  • Up – Price increases, long positions

  • Down – Price decreases, short positions

Position & Metrics Display

The control bar shows real-time position information:

  • Pos – Your current position quantity (green for long, red for short)

  • Avg – Your average entry price

  • Last – Most recent trade price