@wellze/integration-kalshi

Kalshi integration for Wellze workflows, built on the official TypeScript SDK.

Overview

This package provides:

• SDK-backed Kalshi operations as Wellze steps and tools
• Typed polling trigger presets for market and portfolio activity
• Helper utilities for common trading/monitoring workflows

Installation

pnpm add @wellze/integration-kalshi

Credentials

Required:

• KALSHI_API_KEY_ID
• One of KALSHI_PRIVATE_KEY_PEM or KALSHI_PRIVATE_KEY_PATH

Private key precedence:

1. KALSHI_PRIVATE_KEY_PEM
2. KALSHI_PRIVATE_KEY_PATH

Safety Model

All mutating tool operations are marked with needsApproval: true.

SDK Usage

Operations are implemented via SDK API classes from kalshi-typescript, including:

• ApiKeysApi
• CommunicationsApi
• EventsApi
• ExchangeApi
• IncentiveProgramsApi
• LiveDataApi
• MarketApi
• MilestoneApi
• MultivariateApi
• OrdersApi
• OrderGroupsApi
• PortfolioApi
• StructuredTargetsApi
• AccountApi
• FcmApi
• HistoricalApi
• SearchApi

Domain Modules

• api-keys
• communications
• events
• exchange
• incentive-programs
• live-data
• market-lifecycle
• markets
• milestones
• multivariate-collections
• portfolio
• primary-markets
• rate-limits
• series
• structured-targets
• user-data

Each operation is exported as:

• operationName (step)
• operationNameTool (tool)

Example

import { getMarket, getMarketOrderbook, getMarkets } from '@wellze/integration-kalshi/markets';
import { createOrder, getPortfolioBalance } from '@wellze/integration-kalshi/portfolio';

void getMarkets;
void getMarket;
void getMarketOrderbook;
void getPortfolioBalance;
void createOrder;

Integration Tests

Run integration tests with real Kalshi credentials:

pnpm --filter @wellze/integration-kalshi test:int

Required environment variables:

• KALSHI_API_KEY_ID
• one of KALSHI_PRIVATE_KEY_PEM or KALSHI_PRIVATE_KEY_PATH

Optional:

• KALSHI_API_BASE_URL

Notes:

• test:int includes read and mutating endpoint coverage.
• Mutating tests use deterministic resource prefixes and best-effort cleanup.
• Use a dedicated Kalshi test account with appropriate risk controls.