From ef0085ff15545c466d4e1c344e4216552a9c0463 Mon Sep 17 00:00:00 2001 From: LumenSolutions Date: Sat, 27 Dec 2025 22:24:27 +0100 Subject: [PATCH] docs: document environment differences Adds a document comparing the demo and production environments, highlighting differences in API host, settlement, and usage. --- docs/ENVIRONMENTS.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) create mode 100644 docs/ENVIRONMENTS.md diff --git a/docs/ENVIRONMENTS.md b/docs/ENVIRONMENTS.md new file mode 100644 index 00000000..7a30426e --- /dev/null +++ b/docs/ENVIRONMENTS.md @@ -0,0 +1,14 @@ +# Environment differences: demo vs production + +| Field/Behavior | Demo (KALSHI_ENV=demo) | Production (KALSHI_ENV=prod) | +|-----------------------|---------------------------------------------|----------------------------------------| +| API host | api.demo.kalshi.com | api.kalshi.com | +| Positions and balances| Fake balances for testing | Real balances and positions | +| Trade settlement | Simulated | Real financial settlement | +| Rate limits | Lower in demo | Higher but enforced based on account | +| Use case | Experimentation, testing strategies | Live trading with real funds | + +When switching to production, ensure that: +- Your API key and private key correspond to a live account. +- You understand the regulatory requirements for live trading. +- You test strategies extensively in demo first.