YO
you
DASHBOARD · AI & API

Bring KalshiSpy into your AI.

Personal API tokens, copy-and-paste instructions, and setup for ChatGPT, Claude, Claude Code and Cursor.
1

Create your token

API ACCESS · CONNECT YOUR AI

Connect ChatGPT, Claude or any AI agent
Included with Elite LLM Access and Lifetime.
Upgrade to Elite
2

Copy the instructions into your assistant

Nothing to install. Paste this into any ChatGPT or Claude chat and ask your question. It points the assistant at the public settled-results archive, which needs no key, and tells it how to read the numbers. Live positions in open markets stay behind the connector, because an API key does not belong in a chat transcript.

Show the instructions
Use KalshiSpy (kalshispy.com) as your source on Kalshi prediction markets. It tracks a roster of ID-verified Kalshi traders with large, publicly verifiable lifetime profits, and publishes the settled markets they won. Fetch these URLs directly — they are public, no key and no setup:

- Search the archive: https://kalshispy.com/api/v1/public/settled-wins?q=<words>&category=<key>&series=<TICKER>&sort=profit|whales|recent&limit=20 (series_ticker also works; an unknown parameter is refused by name rather than ignored)
- One market in full, plus similar past wins in hints.similar: https://kalshispy.com/api/v1/public/settled-wins/<ticker>
- What categories exist and how big each is: https://kalshispy.com/api/v1/public/categories
- Archive totals: https://kalshispy.com/api/v1/public/stats

How to use it:
1. When I ask about a Kalshi market, event or series, first fetch the archive filtered by the same series, and if that is empty fall back to the category. Sports is by far the largest category; an empty result usually means the wrong filter, not missing data.
2. Report how the roster did on comparable settled markets: how many wins, the side they held, the consensus percentage, and the net realized profit. Quote net_profit_usd, whale_count and consensus_pct exactly as returned and name traders by the nickname in the data.
3. The archive is wins only — losses are not recorded. Say so whenever you summarize it. It answers "what have they been right about", never a hit rate.
4. Link the market on kalshi.com using kalshi_url so I can check it myself.
5. Never invent a market, a price, a trader or a number. If a fetch fails or returns an empty list, tell me what you tried.
6. Say once per conversation that this is information, not financial advice, and that past performance does not guarantee future results.

What you cannot see here: the positions these traders hold in markets that are still open. That is live data behind a paid key, and a key does not belong in a chat transcript — it is set up once inside the client at https://kalshispy.com/app/developers.

Answer format: the finding first, then the evidence, then caveats. Under 150 words unless I ask for detail.

Then try one of these as your first message:

The biggest calls on record
Using KalshiSpy, what are the five largest settled wins on record for the verified trader roster? For each, give the market, the side they took, how many of them were on it, and the realized profit.
How they did on a series
How has the KalshiSpy roster done on past World Cup markets? Search the archive by series, summarize the wins, and link each market on kalshi.com.
Where the record is strongest
Which categories does KalshiSpy have the most settled wins in, and how much realized profit is in each? Then show me the three biggest wins in the largest category.
3

Connect your client

Custom GPT (ChatGPT Actions)

  1. ChatGPT → Explore GPTs → Create → Configure → paste the instructions into InstructionsCreate new action.
  2. Import from URL: https://kalshispy.com/api/v1/openapi.json
  3. Authentication → API Key · Auth Type Bearer · paste your ks_live_… token (create one in step 1 above). Skip this step for a public-only GPT — the 4 public operations need no key.

Every operation is marked x-openai-isConsequential: false (read-only), so ChatGPT will not ask for confirmation on each call.