---
url: "https://predictiontoolkit.com/guides/kalshi-api/"
publisher: "PredictionToolkit"
dateModified: "2026-11-03"
---

[← Polymarket guides](<https://predictiontoolkit.com/guides/>) 

# Kalshi API: choose public data, streams or account access

By PredictionToolkit · Published 2026-11-03 · Updated 2026-11-03

You do not need the same access for a market browser and an order engine. Define the data and actions first, then choose Kalshi's native API or a wrapper with the right credentials, environment and operating model.

## Choose the event-contract API

Use Kalshi's Predictions documentation for event contracts. Its Perps APIs cover perpetual futures separately. The public REST quickstart shows how to retrieve series, events, markets and order books without authentication. That access covers public data; it gives no basis for assuming that account data or order placement is available anonymously.

## Match credentials to the interface

-   Public market REST reads: use the documented public endpoints for discovery and book snapshots.
-   WebSocket: authenticate the connection handshake even when subscribing to public market-data channels; those channels do not add a second channel-level authorization check.
-   Account and trading operations: use the required signed requests and the account's permitted capabilities.

The current key guide supports Ed25519 and RSA-PSS. Choose a key type your actual client version supports instead of copying an older RSA-only example. A key ID identifies the registered key; the private key signs requests. Keep that private key out of browser bundles, public repositories and logs, and use the official signing guide for the exact method and path.

## Keep demo and production separate

The recommended REST hosts are external-api.kalshi.com for production and external-api.demo.kalshi.co for demo, with /trade-api/v2 as the API base path. Demo and production keys are not interchangeable. Start account-dependent development in demo and explicitly check the environment before enabling a production action. A demo result does not validate live liquidity or execution.

## Direct client, local wrapper or hosted service?

With a direct integration, you work with Kalshi's own identifiers and API contracts. PMXT supplies a shared SDK interface for capabilities implemented by each venue. Choose the operating mode before configuring credentials: self-hosted pmxt-core runs locally, connects to the venue and uses venue-native credentials where required, while hosted PMXT uses its own key and infrastructure. The documented hosted write path uses PreFundedEscrow custody. Check both custody and method support for that mode; matching SDK function names do not establish the same behavior.

## Build one bounded data flow first

-   Resolve the series, event and market ticker and retain the exact contract rules. An event name is not an executable market identifier.
-   Read a small market/book sample and retain timestamps, price units and available size before building a chart or comparison.
-   For streams, handle connection loss and state recovery; an open connection alone does not prove current usable data.
-   Check the account's current limits and endpoint costs, and back off on HTTP 429 responses.
-   Review account permissions and order semantics separately from a successful public-data request.

## Budget capacity and money separately

Kalshi documents token-based request budgets, including separate read and write budgets. Tokens here meter API capacity; a requests-per-second number from an old example is not a universal allowance. Check current endpoint costs and tier rules. A hosted vendor's plan, your infrastructure and exchange trading charges are separate cost categories.

This guide's access recommendations come from a review of the linked documentation. The review did not include creating a key, connecting an account or submitting an order. The linked profiles describe the available integration interfaces; confirm endpoint details and permissions in the official references before implementing a request.

[Kalshi public market-data quickstart](<https://docs.kalshi.com/getting_started/quick_start_market_data>) [API keys and signing](<https://docs.kalshi.com/getting_started/api_keys>) [Demo and production endpoints](<https://docs.kalshi.com/getting_started/api_environments>) [WebSocket connection guide](<https://docs.kalshi.com/getting_started/quick_start_websockets>) [Current API rate limits](<https://docs.kalshi.com/getting_started/rate_limits>) [PMXT hosted and local modes](<https://www.pmxt.dev/docs/introduction>) 

## Continue researching

-   [Kalshi](<https://predictiontoolkit.com/tools/kalshi/>)  · context: Read the venue profile for the account and market context.
-   [Kalshi tools](<https://predictiontoolkit.com/kalshi-tools/>)  · context: Compare the selected venue, development and weather-research routes.
-   [PMXT open-source SDK](<https://predictiontoolkit.com/tools/pmxt-open-source-sdk/>)  · context: Inspect the local wrapper and venue-specific configuration.
-   [PMXT hosted API](<https://predictiontoolkit.com/tools/pmxt-hosted-api/>)  · context: Review hosted catalog access, credentials and custody.