Step 0 — Check whether Kalshi itself is down
Check Kalshi's own service announcements before diagnosing an outage. The checks on kalshi.health run from your browser and reflect that browser's connection to the tested endpoints. A failed check can result from your network, browser restrictions, a timeout, or a service problem; it does not prove a platform-wide incident. A successful check does not establish that login, deposits, or trading work. Compare the app with the website, note the time and error message, and contact Kalshi support if an account or transaction issue persists.
Geolocation verification failures
Location or eligibility messages need to be evaluated using Kalshi's current official instructions. A location error alone does not establish its cause or whether you are eligible to trade.
- Read the exact message and follow official eligibility and location-verification instructions; do not use a workaround to bypass restrictions.
- Review device or browser location permissions if official instructions request them.
- Check network/privacy settings only as directed by official guidance, without masking or misrepresenting your location.
- If eligibility is unclear or verification remains denied, stop and contact official support. This guide provides no assurance of legality.
WebSocket connection drops and stale prices
Live order-book prices stream over a WebSocket connection. Frozen prices or a reconnecting banner can indicate a streaming or connection problem, but the visible symptom alone does not identify the cause.
- Switch networks — move from Wi-Fi to cellular or vice versa. Some corporate and campus firewalls block WebSocket traffic entirely.
- Inspect the exact app/browser connection message, the last update time, and whether official views disagree. Follow official connection guidance rather than disabling security or privacy protections based on a guess.
- If official guidance recommends restarting, first reconcile any uncertain order in the official account; restarting does not prove the underlying cause is resolved.
- Compare official service announcements with your local connection evidence. Browser reachability cannot establish that the price stream or trading is healthy.
Pending or missing deposits
A pending deposit does not identify the cause of the delay. Use the transfer method's current stated processing time and status inside your official account.
- Identify the payment method and read its current in-account processing window; do not apply a generic deadline to every method.
- Check the account's transfer notice and your payment provider's record for any stated review, rejection, or reversal.
- If the stated window has passed or records disagree, contact official support with the existing transfer reference privately.
- Do not repeat a transfer solely because it is pending; ask support if the status or applicable timing is unclear.
API 403 and 500 errors
If you use the Kalshi API directly (or a third-party tool built on it), HTTP error codes are evidence to interpret alongside the response and official documentation, not a complete diagnosis. If the order and fill terms in those responses are unfamiliar, our prediction market glossary defines them.
- For 403 Forbidden, review the specific response and official authentication/permission documentation. Do not assume a new key is required or blame the clock without evidence; never share credentials or raw logs here.
- 429 indicates rate limiting. For safe read-only requests, follow official rate-limit guidance and backoff before another read. Do not apply automatic retries to orders or other mutations; reconcile any uncertain order first in official Orders and fills, and contact support if its outcome remains unknown.
- 500/502/503 responses indicate a server-side error response, but do not establish whether an order executed. The browser checks on kalshi.health cannot inspect these HTTP status codes.
- After a timeout or uncertain order response, STOP repeated submit. Check Orders and fills in the official account, retain existing order/client IDs, time, and market privately, and contact support if the outcome remains unknown. Canceled orders can have prior fills.
Clearing cache and reinstalling the app
Local state can contribute to display problems, but clearing cache is not a diagnosis or a guaranteed fix. Reconcile any uncertain order before changing app state, and make sure you can complete official account recovery if needed.
- On iOS, follow official app/device instructions for offloading or reinstalling. Do not assume this clears all cached state or preserves login; you may need to sign in or recover access again.
- On Android: Settings → Apps → Kalshi → Storage → Clear Cache (use Clear Data only as a last resort, since it signs you out).
- On web: hard-refresh with Ctrl/Cmd+Shift+R, or clear site data for kalshi.com in your browser settings.
- After reinstalling, follow the official sign-in and any verification prompts. Reinstallation does not resolve eligibility or an uncertain order outcome.
When to contact Kalshi support
Escalate persistent access problems, inconsistent transaction records, or an uncertain order outcome through the official support channel inside your Kalshi account. A green check on kalshi.health does not confirm exchange, login, or account health. Keep the exact error, a sanitized screenshot, time with timezone, and existing transaction/order references privately for official support; do not post keys, raw logs, or account IDs here.