KalshiSpy Live (API key) API

Bearer API key (`Authorization: Bearer ks_live_…`). One request = one unit of the daily quota; `X-RateLimit-*` headers report it, and `X-PayG-Month-*` the month of a pay-as-you-go account’s extra requests past it.

GitHub OpenAPI

Operations 6

GET /api/v1/markets/live Live Kalshi markets where the roster holds positions now #
GET /api/v1/markets/live/{ticker} One live market by ticker #
GET /api/v1/markets/hot Roster results: settled wins and losses by market and category #
GET /api/v1/whales The verified traders behind the live feed #
GET /api/v1/watchlist Watch up to 10 Kalshi traders by nickname #
GET /api/v1/search Search Kalshi series, or recent trades by series or trader #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/kalshispy-com:kalshispy-com-live-api-key-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

kalshispy-com-live-api-key-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: KalshiSpy Live (API key) API
  version: 2.2.0
  summary: Which Kalshi markets the highest-profit verified traders hold, and how they settled comparable markets before.
  description: 'KalshiSpy is independent analytics on a roster of ID-verified, high-profit Kalshi traders. Parameter and field names call them "whales" (whale_count, min_whales, sort=whales); in prose, call them the roster or the verified traders. **Public (no key):** the settled-wins archive — settled Kalshi markets where the roster held the winning side with positive net realized profit. Wins only: it answers "what did this roster get right on markets like this", not "how often are they right". Search by keyword, series ticker, event ticker or category; every result carries Kalshi and kalshispy.com URLs to cite. **Live (API key, Elite or Lifetime plan):** the markets roster traders hold right now, recent form by market and category, roster exposure, trade search, and a watchlist of any public Kalshi traders by exact nickname. This is the data a subscriber uses to decide which Kalshi market to take. **Market search (key optional):** `searchMarkets` finds markets by title or keywords. Without a key it returns settled wins only; with an Elite or Lifetime key the same call adds open markets and uses 1 quota unit. A refused key is reported in `data.access`, not as an HTTP error. **Chaining guidance:** before answering about any current Kalshi market, call `searchSettledWins` with the same `series` or `category` and cite the comparable past wins. Live operations return `hints.next_steps` with those exact URLs. Every response includes `meta.definition` (wins only) and `meta.verification`: every trader is ID-verified, and every name and settled result is checkable on kalshi.com. Complete, live or commercial use goes through a KalshiSpy API key: Elite LLM Access includes the API and the MCP server (Lifetime includes them at a lower allowance); commercial use needs pay-as-you-go turned on, see Terms section 9: https://kalshispy.com/terms#section-9. Plans and setup: https://kalshispy.com/ai


    **Pay-as-you-go (opt-in, Elite and Lifetime):** turned on in AI & API, requests past the daily allowance keep being served at $10 per 1,000 up to a monthly cap the account sets. Extra requests are paced at roughly 60 a minute per account; bursts beyond that may be answered with rate_limited (429) and Retry-After. Those answers carry `X-PayG-Month-Extra` and `X-PayG-Month-Remaining`; the 429s `spend_cap_reached`, `extras_paused` and `rate_limited` say when to resume. Requests that fail on our side (5xx) are not charged; if one ever is, we credit it. Commercial use of the account''s own bots and products is included while it is on: https://kalshispy.com/terms#section-9. Keys: create at https://kalshispy.com/app/developers; docs at https://kalshispy.com/developers. **Changes:** 2.2.0 (2026-11-04): pay-as-you-go, opt-in on Elite and Lifetime in AI & API: requests past the daily allowance are served at $10 per 1,000 up to a monthly cap. Keyed operations document the 429 codes `spend_cap_reached`, `extras_paused` and `rate_limited` beside `quota_exceeded`, their `error` fields, and the `X-PayG-Month-Extra` and `X-PayG-Month-Remaining` headers; a long run of failed extra requests pauses extra requests for about 15 minutes (`extras_paused`). Requests that fail on our side (5xx) are not charged; if one ever is, we credit it. Additive. 2.1.1 (2026-10-29): Without an API key a page holds at most 20 rows, `total_matches` (and `keyword_matches` in the market search) stops at 100 with the new boolean `total_matches_capped` (`keyword_matches_capped`) saying so, and a client that has used its daily amount of public answers gets a 429 `limit_reached` with `Retry-After`. An Elite or Lifetime key lifts all three. Additive: every field keeps its type. 2.1.1 (2026-10-29): Removed, not deprecated first, because they were diagnostics and not data: `window.weeks_loaded` (the settled-wins list and the settled wins inside market search) and `data.resolution.reason` and `data.resolution.cached` (market search).'
  termsOfService: https://kalshispy.com/terms
  contact:
    name: KalshiSpy
    email: contact@kalshispy.com
    url: https://kalshispy.com/developers
  license:
    name: KalshiSpy Terms of Service
    url: https://kalshispy.com/terms
servers:
- url: https://kalshispy.com
security: []
tags:


# --- truncated at 32 KB (67 KB total) ---
# Full source: https://artifacts.apis.io/kalshispy-com/openapi/kalshispy-com-live-api-key-api-openapi.yml