Back to Details

trading-kalshi

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Kalshi Trading

Kalshi交易

Full access to Kalshi prediction markets: search, trade, stream real-time data, and use advanced order types (TWAP, bracket, trigger).
完全访问Kalshi预测市场：搜索、交易、实时数据流，以及使用高级订单类型（TWAP、区间订单、触发订单）。

Required Environment Variables

所需环境变量

bash
KALSHI_API_KEY_ID=your_api_key_id
KALSHI_PRIVATE_KEY=your_private_key_pem_contents
bash
KALSHI_API_KEY_ID=your_api_key_id
KALSHI_PRIVATE_KEY=your_private_key_pem_contents

OR

或

KALSHI_PRIVATE_KEY_PATH=/path/to/private_key.pem

Authentication uses RSA key-pair signing (not email/password). Generate an API key from the Kalshi dashboard.

Optional:

```bash
DRY_RUN=true   # Simulate trades without executing
KALSHI_PRIVATE_KEY_PATH=/path/to/private_key.pem

身份验证采用RSA密钥对签名（而非邮箱/密码）。请从Kalshi控制台生成API密钥。

可选配置：

```bash
DRY_RUN=true   # 模拟交易，不实际执行

Commands

命令

Market Data

市场数据

/kalshi search <query>                     - Search markets
/kalshi market <ticker>                    - Market details
/kalshi book <ticker>                      - View orderbook (REST snapshot)
/kalshi events [query]                     - Browse events
/kalshi event <event-ticker>              - Event details + markets
/kalshi search <query>                     - 搜索市场
/kalshi market <ticker>                    - 查看市场详情
/kalshi book <ticker>                      - 查看订单簿（REST快照）
/kalshi events [query]                     - 浏览事件
/kalshi event <event-ticker>              - 查看事件详情及关联市场

Trading

交易操作

/kalshi buy <ticker> <contracts> <price>   - Buy YES contracts
/kalshi sell <ticker> <contracts> <price>  - Sell YES contracts
/kalshi orders                             - View open orders
/kalshi cancel <order-id>                  - Cancel an order
/kalshi cancel all                         - Cancel all orders
/kalshi balance                            - Account balance
/kalshi buy <ticker> <contracts> <price>   - 买入YES合约
/kalshi sell <ticker> <contracts> <price>  - 卖出YES合约
/kalshi orders                             - 查看未成交订单
/kalshi cancel <order-id>                  - 取消单个订单
/kalshi cancel all                         - 取消所有订单
/kalshi balance                            - 查看账户余额

Advanced Orders

高级订单

/kalshi twap <buy|sell> <ticker> <total> <price> [slices] [interval-sec]
/kalshi twap status                        - Active TWAP progress
/kalshi twap cancel <id>                   - Cancel TWAP

/kalshi bracket <ticker> <size> <tp> <sl>  - Set take-profit / stop-loss
/kalshi bracket status                     - Active brackets
/kalshi bracket cancel <id>                - Cancel bracket

/kalshi trigger buy <ticker> <size> <price> [limit]   - Buy when price drops
/kalshi trigger sell <ticker> <size> <price> [limit]  - Sell when price rises
/kalshi trigger list                       - Active triggers
/kalshi trigger cancel <id>                - Cancel trigger
/kalshi twap <buy|sell> <ticker> <total> <price> [slices] [interval-sec]
/kalshi twap status                        - 查看活跃TWAP订单进度
/kalshi twap cancel <id>                   - 取消TWAP订单

/kalshi bracket <ticker> <size> <tp> <sl>  - 设置止盈/止损（区间订单）
/kalshi bracket status                     - 查看活跃区间订单
/kalshi bracket cancel <id>                - 取消区间订单

/kalshi trigger buy <ticker> <size> <price> [limit]   - 价格下跌时买入（触发订单）
/kalshi trigger sell <ticker> <size> <price> [limit]  - 价格上涨时卖出（触发订单）
/kalshi trigger list                       - 查看活跃触发订单
/kalshi trigger cancel <id>                - 取消触发订单

Real-Time Streaming (WebSocket)

实时流（WebSocket）

/kalshi stream <ticker> [channels]         - Start streaming (ticker,trade,orderbook)
/kalshi stream-fills                       - Stream your order fills
/kalshi streams                            - List active streams
/kalshi unstream <ticker>                  - Stop streaming a market
/kalshi unstream-fills                     - Stop fill notifications
/kalshi realtime-book <ticker>             - Get real-time orderbook from stream
/kalshi stream <ticker> [channels]         - 启动实时流（支持ticker、trade、orderbook频道）
/kalshi stream-fills                       - 实时推送订单成交信息
/kalshi streams                            - 查看活跃实时流
/kalshi unstream <ticker>                  - 停止指定市场的实时流
/kalshi unstream-fills                     - 停止成交通知推送
/kalshi realtime-book <ticker>             - 从实时流获取最新订单簿

Cross-Platform

跨平台功能

/kalshi route <ticker> <buy|sell> <size>   - Compare prices across platforms
/kalshi circuit                            - Circuit breaker status
/kalshi route <ticker> <buy|sell> <size>   - 跨平台价格对比
/kalshi circuit                            - 查看熔断机制状态

Examples

示例

/kalshi search bitcoin
/kalshi market KXBTC-24JAN01
/kalshi book KXBTC-24JAN01
/kalshi buy KXBTC-24JAN01 10 0.65
/kalshi sell KXBTC-24JAN01 5 0.70
/kalshi stream KXBTC-24JAN01 ticker,trade
/kalshi twap buy KXBTC-24JAN01 50 0.60 10 30
/kalshi bracket KXBTC-24JAN01 10 0.80 0.40
/kalshi trigger buy KXBTC-24JAN01 10 45
/kalshi search bitcoin
/kalshi market KXBTC-24JAN01
/kalshi book KXBTC-24JAN01
/kalshi buy KXBTC-24JAN01 10 0.65
/kalshi sell KXBTC-24JAN01 5 0.70
/kalshi stream KXBTC-24JAN01 ticker,trade
/kalshi twap buy KXBTC-24JAN01 50 0.60 10 30
/kalshi bracket KXBTC-24JAN01 10 0.80 0.40
/kalshi trigger buy KXBTC-24JAN01 10 45

Notes

注意事项

  • Prices are in decimal format for commands (0.65 = 65 cents)
  • Trigger prices are in cents (45 = 45 cents)
  • Contracts pay $1 if correct; cost is the price
  • Circuit breaker integration blocks trades when risk limits are hit
  • Trigger orders poll every 5 seconds
  • 命令中的价格采用小数格式（0.65 = 65美分）
  • 触发订单的价格单位为美分（45 = 45美分）
  • 若预测正确，每份合约支付1美元；成本为下单价格
  • 熔断机制集成：当达到风险限制时，将阻止交易
  • 触发订单每5秒轮询一次