name	kalshi-trading
version	1.0.0
description	Trade prediction markets on Kalshi via Quantish MCP (Solana/DFlow)
author	Quantish
tags	["trading","kalshi","prediction-markets","solana"]

Kalshi Trading Skill

Complete guide to trading on Kalshi through the Quantish MCP server using Solana and DFlow.

What is DFlow?

DFlow is the on-chain API that connects Kalshi's order book to Solana.

Kalshi is a CFTC-regulated prediction market exchange. DFlow enables:

Trading Kalshi markets using your Solana wallet
On-chain settlement of prediction market positions
Permissionless access to Kalshi liquidity

When you trade via this MCP, you're:

Swapping USDC for outcome tokens (YES/NO) via DFlow
Those tokens represent your position in Kalshi's order book
When markets resolve, you redeem winning tokens for USDC

This is not the Kalshi web API - it's fully on-chain via Solana.

Prerequisites

Run /quantish-mcp-setup first to connect to the MCP servers.

Key Differences from Polymarket

Aspect	Polymarket	Kalshi
Chain	Polygon	Solana
Gas Token	MATIC	SOL
Token Type	ERC-1155	SPL Token-2022
Order Routing	CLOB direct	DFlow DEX
Regulation	Crypto-native	CFTC-regulated

Finding Markets via Discovery

Use the Discovery MCP to search for markets, then trade directly via the ticker.

Discovery → Kalshi Direct Mapping

The id field in Discovery's nested markets IS the Kalshi ticker. Use it directly with kalshi_get_market.

Complete Workflow

Step 1: Search via Discovery

mcp__quantish-discovery__search_markets
  query: "Seattle Pro Football"
  platform: "kalshi"
  limit: 5

Response:

{
  "markets": [{
    "platform": "kalshi",
    "id": "KXSB-26",
    "title": "Pro Football Champion: Seattle vs New England",
    "markets": [
      {"id": "KXSB-26-SEA", "question": "Seattle", "prices": [{"outcome": "Yes", "price": 0.68}]},
      {"id": "KXSB-26-NE", "question": "New England", "prices": [...]}
    ]
  }]
}

Key mapping: markets[].id (e.g., KXSB-26-SEA) = Kalshi ticker for trading

Step 2: Get market details with yesMint

mcp__quantish-kalshi__kalshi_get_market
  ticker: "KXSB-26-SEA"

Response:

{
  "market": {
    "ticker": "KXSB-26-SEA",
    "yesBid": "0.6700",
    "yesAsk": "0.6800",
    "accounts": {
      "CASHx9KJUStyftLFWGvEVf59SGeG9sh5FfcnZMVPCASH": {
        "yesMint": "9xUDJs6TjXaQE1NPWVaAmEXZADxvKdtSRoSoWWYZUypd",
        "noMint": "H8YaUJvkEbvxRsZVsAftipnUPEHzTfHqb41b7xP8Qkat",
        "isInitialized": true
      }
    }
  }
}

Important: Use the yesMint/noMint from the CASHx9KJ... account (CASH settlement token).

Step 3: Execute trade

mcp__quantish-kalshi__kalshi_buy_yes
  marketTicker: "KXSB-26-SEA"
  yesOutcomeMint: "9xUDJs6TjXaQE1NPWVaAmEXZADxvKdtSRoSoWWYZUypd"
  usdcAmount: 2

Verified Working Markets

These market patterns work with Discovery → DFlow:

KXSB-26-* (Pro Football Championship)
KXNBA-26-* (Pro Basketball Finals)
KXFEDCHAIRNOM-29-* (Fed Chair Nomination)
KXNFLMVP-26-* (NFL MVP)

Handling "Market Not Found"

If kalshi_get_market returns "Market not found", the market may not be on DFlow yet. Try searching for alternative markets in the same category.

Market Initialization

Some Kalshi markets are not yet "tokenized" on-chain. Initialization happens automatically on first trade.

Check if Market is Initialized (Optional)

mcp__quantish-kalshi__kalshi_check_market_initialization
  ticker: "KXVOTEFEDCHAIR-27-RPAU"

Response:

{
  "ticker": "KXVOTEFEDCHAIR-27-RPAU",
  "isInitialized": false,
  "yesMint": "4xzcnQx6jU6oGdoryV5WarbUGXBQPSsvgBdGnXjpbdCh",
  "noMint": "42KGbgY1PGudyFtzE69kSyqHvbeXR1mfMuABh1Xotiny",
  "message": "Market needs initialization before first trade."
}

Initialization is Automatic

You do NOT need to manually initialize. When you place your first trade on an uninitialized market, DFlow handles initialization automatically.

Cost: ~0.02 SOL for initialization (included in first trade).

Note: Most popular markets are already initialized. You'll only pay the init cost on newer or less-traded markets.

Trading Workflow

1. Check Wallet Status

mcp__quantish-kalshi__kalshi_get_wallet_status

Response fields:

publicKey: Your Solana wallet address
walletType: "generated" or "imported"
status: Must be "READY"
balances: SOL and USDC amounts

2. Check Balances

mcp__quantish-kalshi__kalshi_get_balances

Response:

{
  "publicKey": "YourSolanaWalletAddress...",
  "balances": {
    "sol": 0.07,   // For gas fees (~0.004 per trade)
    "usdc": 8.0    // Available to trade
  }
}

Important: Need SOL for transaction fees (minimum ~0.01 SOL recommended).

3. Find Markets

Recommended: Use Discovery MCP (see "Finding Markets via Discovery" above).

Alternative: Direct Kalshi search:

mcp__quantish-kalshi__kalshi_search_markets
  query: "Fed Chair"
  limit: 5
  marketStatus: "active"  // "active", "inactive", "finalized", "all"

Key fields:

ticker: Market identifier (e.g., "KXFEDCHAIRNOM-29-KW")
yesMint: YES outcome token address
noMint: NO outcome token address
yesAsk: Current ask price for YES
noBid: Current bid price for NO

4. Get Market Details

mcp__quantish-kalshi__kalshi_get_market
  ticker: "KXFEDCHAIRNOM-29-KW"

Response:

{
  "market": {
    "ticker": "KXFEDCHAIRNOM-29-KW",
    "title": "Will Trump next nominate Kevin Warsh as Fed Chair?",
    "status": "active",
    "yesBid": "0.9700",
    "yesAsk": "0.9800",
    "noBid": "0.0200",
    "noAsk": "0.0300",
    "accounts": {
      "CASHx9KJ...": {
        "yesMint": "3ojpNwqx2RVYpTCXLfKknvSXWWJFuVT2pdzotZ5PG1wF",
        "noMint": "GkC4HPRbTFdEwiU7XiZeaHyH779oBVrRWrbXbB6QDFXC",
        "isInitialized": true
      }
    }
  }
}

Note: Use the yesMint or noMint from the CASHx9KJ... account (CASH token).

5. Get Live Pricing

mcp__quantish-kalshi__kalshi_get_live_data
  marketTicker: "KXFEDCHAIRNOM-29-KW"

Response:

{
  "liveData": {
    "ticker": "KXFEDCHAIRNOM-29-KW",
    "yesPrice": "0.9700",
    "noPrice": "0.0200",
    "yesBid": "0.9700",
    "yesAsk": "0.9800",
    "status": "active"
  }
}

6. Get Quote (Optional)

Preview a trade before executing:

mcp__quantish-kalshi__kalshi_get_quote
  inputMint: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"  // USDC
  outputMint: "3ojpNwqx2RVYpTCXLfKknvSXWWJFuVT2pdzotZ5PG1wF"  // YES token
  amount: 1000000  // 1 USDC (6 decimals)

7. Buy YES Shares

mcp__quantish-kalshi__kalshi_buy_yes
  marketTicker: "KXFEDCHAIRNOM-29-KW"
  yesOutcomeMint: "3ojpNwqx2RVYpTCXLfKknvSXWWJFuVT2pdzotZ5PG1wF"
  usdcAmount: 2
  slippageBps: 100  // optional, default 1%

Response:

{
  "message": "Buy YES order executed",
  "txSignature": "5TFFSF3UbaZWvz...",
  "status": "pending"
}

8. Buy NO Shares

mcp__quantish-kalshi__kalshi_buy_no
  marketTicker: "KXFEDCHAIRNOM-29-KW"
  noOutcomeMint: "GkC4HPRbTFdEwiU7XiZeaHyH779oBVrRWrbXbB6QDFXC"
  usdcAmount: 2

9. Check Token Holdings (Positions)

mcp__quantish-kalshi__kalshi_get_token_holdings

Response:

{
  "tokens": [
    {
      "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "balance": "8000000",  // 8 USDC
      "decimals": 6
    },
    {
      "mint": "3ojpNwqx2RVYpTCXLfKknvSXWWJFuVT2pdzotZ5PG1wF",
      "balance": "2000000",  // 2 YES shares
      "decimals": 6
    }
  ]
}

Note: get_token_holdings is more reliable than get_positions for Kalshi.

10. Check Orders

mcp__quantish-kalshi__kalshi_get_orders
  status: "SUBMITTED"  // optional

11. Sell Position

mcp__quantish-kalshi__kalshi_sell_position
  outcomeMint: "3ojpNwqx2RVYpTCXLfKknvSXWWJFuVT2pdzotZ5PG1wF"
  tokenAmount: 2
  slippageBps: 100

12. Redeem Winnings (After Market Settles)

Check if market is settled:

mcp__quantish-kalshi__kalshi_check_redemption_status
  ticker: "KXFEDCHAIRNOM-29-KW"

Get redeemable positions:

mcp__quantish-kalshi__kalshi_get_redeemable_positions

Redeem all:

mcp__quantish-kalshi__kalshi_redeem_all_positions

Or redeem specific:

mcp__quantish-kalshi__kalshi_redeem_winnings
  outcomeMint: "3ojpNwqx2RVYpTCXLfKknvSXWWJFuVT2pdzotZ5PG1wF"
  tokenAmount: 2

Token Swaps

Get Swap Quote

mcp__quantish-kalshi__kalshi_get_swap_quote
  inputMint: "SOL"
  outputMint: "USDC"
  amount: 0.1

Swap SOL to USDC

mcp__quantish-kalshi__kalshi_swap_sol_to_usdc
  solAmount: 0.1

Swap USDC to SOL

mcp__quantish-kalshi__kalshi_swap_usdc_to_sol
  usdcAmount: 5

Transfers

Send USDC

mcp__quantish-kalshi__kalshi_send_usdc
  toAddress: "..."
  amount: 5

Send SOL

mcp__quantish-kalshi__kalshi_send_sol
  toAddress: "..."
  amount: 0.1

Get Deposit Address

mcp__quantish-kalshi__kalshi_get_deposit_address

Important Notes

Market Ticker Format

Kalshi tickers follow this pattern:

KXFEDCHAIRNOM-29-KW = Fed Chair Nomination, 2029 expiry, Kevin Warsh

Token Decimals

All Kalshi tokens use 6 decimals:

1000000 = 1 token/USDC
2000000 = 2 tokens/USDC

Common Token Addresses

Token	Address
USDC	`EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`
CASH	`CASHx9KJUStyftLFWGvEVf59SGeG9sh5FfcnZMVPCASH`

Gas Costs

Typical trade (initialized market): ~0.005 SOL
First trade on uninitialized market: ~0.025 SOL (includes init)
Keep at least 0.05 SOL for gas

Best Practices

Check wallet has SOL - Trades fail without gas
Use get_market first - Get correct yesMint/noMint
Verify with get_token_holdings - More reliable than get_positions
Set slippage - Default 1% (100 bps) usually fine
Check market status - Only "active" markets can be traded

Example: Complete Trade Flow

1. kalshi_get_balances → Check USDC and SOL
2. discovery__search_markets → Find market via Discovery
   query: "Fed Chair", platform: "kalshi"
   → Returns event ID + nested market IDs
3. kalshi_get_market → Get yesMint/noMint from CASHx9KJ... account
   ticker: "KXVOTEFEDCHAIR-27-RPAU"
4. kalshi_buy_yes or kalshi_buy_no → Execute trade
   marketTicker + outcomeMint + usdcAmount
   (initialization happens automatically if needed)
5. kalshi_get_token_holdings → Verify position

Tested Example (Feb 2026)

Discovery: search_markets("Fed Chair", platform="kalshi")
  → Found KXVOTEFEDCHAIR-27-RPAU (Rand Paul vote)

Get Market: kalshi_get_market("KXVOTEFEDCHAIR-27-RPAU")
  → noMint: 42KGbgY1PGudyFtzE69kSyqHvbeXR1mfMuABh1Xotiny
  → isInitialized: false

Trade: kalshi_buy_no(
  marketTicker: "KXVOTEFEDCHAIR-27-RPAU",
  noOutcomeMint: "42KGbgY1PGudyFtzE69kSyqHvbeXR1mfMuABh1Xotiny",
  usdcAmount: 1
)
  → Success! Got 1 NO share for $0.66
  → Auto-initialized market (cost ~0.02 SOL)

Verify: kalshi_get_token_holdings
  → Shows 1,000,000 tokens (1 share)

Error Handling

Error	Cause	Fix
"Market not found"	Wrong ticker format	Use Discovery or kalshi_search_markets
"Insufficient SOL"	No gas	Swap USDC to SOL or deposit SOL
"Market not initialized"	First trade on this market	Use kalshi_initialize_market first
"Transaction failed"	Various	Check tx on Solscan