Properties
| Name | Type | Description |
|---|---|---|
| as_of | stringnull | Send it as `since` to poll, and de-duplicate changes by id. The earliest trader as_of, or earlier where a trader's change log or closed list was cut (where it resumes); while any trader is unavailable |
| since | stringnull | The `since` applied. |
| traders | array | One per nickname asked, in the order asked. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/kalshispy-com/json-schema/kalshispy-com-watchlist-schema.json",
"title": "Watchlist",
"x-generated": "2026-11-13",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/kalshispy-com-openapi.json#/components/schemas/Watchlist",
"type": "object",
"properties": {
"as_of": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Send it as `since` to poll, and de-duplicate changes by id. The earliest trader as_of, or earlier where a trader's change log or closed list was cut (where it resumes); while any trader is unavailable, the `since` asked with (null without one), so the next poll covers that trader's gap."
},
"since": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "The `since` applied."
},
"traders": {
"type": "array",
"description": "One per nickname asked, in the order asked.",
"items": {
"$ref": "#/$defs/WatchTrader"
}
}
},
"$defs": {
"WatchChange": {
"type": "object",
"description": "One of the trader's trades, read as a buy of `side` at `price_cents`.",
"properties": {
"id": {
"type": "string",
"description": "The trade, the same in every answer: de-duplicate by it when polling. The second named trader on a trade between two public traders has an id ending in `:maker`."
},
"at": {
"type": "string",
"format": "date-time"
},
"ticker": {
"type": "string"
},
"side": {
"type": "string",
"enum": [
"YES",
"NO"
]
},
"action": {
"type": [
"string",
"null"
],
"enum": [
"opened",
"added",
"reduced",
"closed",
"flipped",
null
],
"description": "What the trade did to the position: opened (from flat), added, reduced, closed (to flat) or flipped (to the other side). null in a settled market the trader no longer holds, where the position before settlement is not known; in a market this answer does not cover (positions_complete false); and in a market traded again while the answer was being built (that trade comes in the next answer)."
},
"contracts": {
"type": "number"
},
"price_cents": {
"type": "number",
"description": "The price of `side` in cents, to 0.01."
},
"position_after": {
"type": [
"number",
"null"
],
"description": "The position right after this trade, signed: YES positive, NO negative, 0 flat. null where action is null."
}
}
},
"WatchClosed": {
"type": "object",
"description": "A market traded in the history window that the trader no longer holds.",
"properties": {
"ticker": {
"type": "string"
},
"event_ticker": {
"type": "string"
},
"side": {
"type": [
"string",
"null"
],
"enum": [
"YES",
"NO",
null
],
"description": "The side held until the position was sold. null for a settled market: the side held at settlement is not known."
},
"closed_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "sold: the trade that closed it. settled: when the market settled; null when that time is not known."
},
"reason": {
"type": "string",
"enum": [
"sold",
"settled"
],
"description": "sold: the trader traded out. settled: the market settled (it may have been sold before that; the answer cannot tell)."
}
}
},
"WatchPosition": {
"type": "object",
"description": "One open position.",
"properties": {
"ticker": {
"type": "string"
},
"event_ticker": {
"type": "string"
},
"series_ticker": {
"type": "string"
},
"question": {
"type": "string"
},
"outcome": {
"type": "string",
"description": "Kalshi's short outcome label; empty for plain Yes/No markets."
},
"side": {
"type": "string",
"enum": [
"YES",
"NO"
]
},
"contracts": {
"type": "number",
"description": "Contracts held, to 0.01 (fractional contracts exist)."
},
"value_usd": {
"type": [
"number",
"null"
],
"description": "The position's value now: contracts × the side's current value, or the payout once the market is decided. null when the market has no price."
},
"cost_usd": {
"type": [
"number",
"null"
],
"description": "What the position cost: value_usd − pnl_usd, never below 0. null when either is."
},
"pnl_usd": {
"type": [
"number",
"null"
],
"description": "Unrealized P&L on the position, USD."
},
"opened_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "When this position was opened (from flat, or by flipping sides), when that is inside the trader's history window (history_since); null when it was already held then."
},
"last_trade_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "The latest trade in this market; null when none is in the history window."
},
"closes_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"kalshi_url": {
"type": "string",
"format": "uri"
}
}
},
"WatchTrader": {
"type": "object",
"properties": {
"nickname": {
"type": "string",
"description": "As asked, exact."
},
"coverage": {
"type": "string",
"enum": [
"verified",
"public",
"private",
"not_found",
"unavailable"
],
"description": "verified: on KalshiSpy's roster of ID-verified, high-profit traders. public: a public Kalshi trader outside the roster. private: the trader keeps their positions hidden. not_found: no Kalshi account has this exact nickname. unavailable: it could not be read this time; ask again shortly. Only verified and public carry positions, closed markets and changes."
},
"rank": {
"type": [
"integer",
"null"
],
"description": "Position in KalshiSpy's public top-10 ranking. null when not ranked, and occasionally when the ranking could not be read for this call; it fills in on a later call."
},
"did_you_mean": {
"type": [
"string",
"null"
],
"description": "not_found only: the account whose nickname matches this one in another case, if any. Ask for it under that spelling."
},
"kalshi_profile_url": {
"type": [
"string",
"null"
],
"format": "uri"
},
"as_of": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "When this trader's data was taken. Positions and changes are as of then; a trade after it comes in the next answer."
},
"history_since": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "The oldest of the trader's recent trades in this answer: changes before it are not known. null when there are none."
},
"open_positions_count": {
"type": [
"integer",
"null"
],
"description": "Every open position (neither since nor positions_limit narrows it)."
},
"open_value_usd": {
"type": [
"number",
"null"
],
"description": "Sum of value_usd over every open position."
},
"unrealized_pnl_usd": {
"type": [
"number",
"null"
],
"description": "Sum of pnl_usd over every open position."
},
"positions_complete": {
"type": [
"boolean",
"null"
],
"description": "false when the trader holds more positions than one call can cover: the totals then cover only the positions the call reached, and traded markets not among them are left out of closed."
},
"positions_total": {
"type": [
"integer",
"null"
],
"description": "How many positions this answer lists before positions_limit (after since)."
},
"positions_truncated": {
"type": [
"boolean",
"null"
],
"description": "true when positions_limit cut the list."
},
"changes_truncated": {
"type": [
"boolean",
"null"
],
"description": "true when the trader had more changes than this answer lists (100)."
},
"closed_truncated": {
"type": [
"boolean",
"null"
],
"description": "true when the trader had more closed markets than this answer lists (100)."
},
"positions": {
"type": "array",
"description": "Open positions, largest value first, up to positions_limit.",
"items": {
"$ref": "#/$defs/WatchPosition"
}
},
"closed": {
"type": "array",
"description": "Up to 100 with a known close time, latest close first. Without since, the most recent (a settled market whose time is not known goes by its last trade). With since and more than 100 after it, the 100 right after since, and data.as_of stops at them so the next poll continues there (closed_truncated says so); settled markets whose settlement time is not known follow, up to 100, most recently traded first.",
"items": {
"$ref": "#/$defs/WatchClosed"
}
},
"changes": {
"type": "array",
"description": "Up to 100 trades, listed newest first. Without since, the newest 100. With since and more than 100 after it, the 100 right after since, and data.as_of stops at them so the next poll continues there (changes_truncated says so).",
"items": {
"$ref": "#/$defs/WatchChange"
}
}
}
}
}
}
Work with this as data
Every JSON Schema 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 schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.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.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/kalshispy-com-watchlist"
All schemas
curl "https://apis.io/api/v1/json-schemas?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.