# SeeSaw Developer ## Docs - [Get one contest](https://docs.seesaw.fun/api-reference/contests/get-one-contest.md) - [List contests](https://docs.seesaw.fun/api-reference/contests/list-contests.md) - [REST API](https://docs.seesaw.fun/api-reference/introduction.md): Base URL, conventions, pagination, and errors - [Get a leaderboard (global, zone, or contest)](https://docs.seesaw.fun/api-reference/leaderboards/get-a-leaderboard-global-zone-or-contest.md): Parameters depend on `scope`: - **global** — `type` (credits|accuracy|volume, default credits), `period` (all|monthly|weekly, default all), `limit`. Top-N only: `next_cursor` is always `null`. - **zone** — `id` (zone slug, **required**), `month` (`YYYY-MM`, default current month), `cursor`/`li… - [Get the key owner's own profile](https://docs.seesaw.fun/api-reference/me/get-the-key-owners-own-profile.md): The only user shape that carries financial fields (credits, diamonds, assets). - [List the key owner's open positions](https://docs.seesaw.fun/api-reference/me/list-the-key-owners-open-positions.md): Open prediction-market positions with average cost, current price, and unrealized P&L. - [List the key owner's settlement records](https://docs.seesaw.fun/api-reference/me/list-the-key-owners-settlement-records.md): Settled predictions with payout, claim status, and realized P&L (no cost/current-price fields — use /me/positions for open positions). - [List topics created by the key owner](https://docs.seesaw.fun/api-reference/me/list-topics-created-by-the-key-owner.md): Owner view — items may carry `moderation_status` (this endpoint only). - [Browse topics by ranking](https://docs.seesaw.fun/api-reference/topics/browse-topics-by-ranking.md): Lists prediction markets or polls (the two kinds are separate lists, no mixed ranking). Filters: - `sort=ending_soon` is prediction-only (400 for polls). - `status` defaults to `open`. `resolving` is not filterable (omit `status` instead); polls only support `open`. - `zone` is prediction-only (40… - [Get a prediction market's probability history](https://docs.seesaw.fun/api-reference/topics/get-a-prediction-markets-probability-history.md): Only for `type=prediction` topics; poll IDs return 404. No pagination. - [Get one topic in full detail](https://docs.seesaw.fun/api-reference/topics/get-one-topic-in-full-detail.md) - [List top-level comments of a topic](https://docs.seesaw.fun/api-reference/topics/list-top-level-comments-of-a-topic.md): Flat top-level comments (replies stay behind `reply_count`). Comments may include the author's position — useful for sentiment analysis. Poll comments can be vote-gated: then `data` is empty and `gated` is `true`. - [Search topics by keyword](https://docs.seesaw.fun/api-reference/topics/search-topics-by-keyword.md): Full-text search across prediction markets and polls. With `type=all` the result is a fixed-size preview mixing both kinds: `cursor`/`limit` are ignored, `next_cursor` is always `null`, and `has_more` is always `false` — specify `type=prediction` or `type=poll` to paginate. - [List topics created by a user](https://docs.seesaw.fun/api-reference/users/list-topics-created-by-a-user.md): Respects the target user's privacy settings: when the created list is hidden, `data` is empty and `hidden` is `true` (an empty list with `hidden: false` really is empty). - [Look up a public user profile by handle](https://docs.seesaw.fun/api-reference/users/look-up-a-public-user-profile-by-handle.md) - [List topic zones (communities)](https://docs.seesaw.fun/api-reference/zones/list-topic-zones-communities.md): Returns the full list (no pagination); `next_cursor` is always `null`. - [Authentication](https://docs.seesaw.fun/authentication.md): Personal API keys: format, usage, lifecycle, and security - [Changelog](https://docs.seesaw.fun/changelog.md): What's new on the SeeSaw Open API - [Errors](https://docs.seesaw.fun/errors.md): Error envelope, codes, and real examples - [SeeSaw Open API](https://docs.seesaw.fun/index.md): A read-only API and MCP server for AI agents to explore SeeSaw prediction markets - [Claude Code](https://docs.seesaw.fun/mcp/clients/claude-code.md): Connect Claude Code to the SeeSaw MCP server - [Cursor](https://docs.seesaw.fun/mcp/clients/cursor.md): Connect Cursor to the SeeSaw MCP server - [Other clients](https://docs.seesaw.fun/mcp/clients/other-clients.md): Claude Desktop and any client without custom-header support, via mcp-remote - [VS Code](https://docs.seesaw.fun/mcp/clients/vscode.md): Connect VS Code (GitHub Copilot agent mode) to the SeeSaw MCP server - [MCP server](https://docs.seesaw.fun/mcp/overview.md): Connect any MCP client to SeeSaw's 14 read-only tools - [get_contest](https://docs.seesaw.fun/mcp/tools/get-contest.md): World Cup pick'em contests: schedule, options, and results - [get_leaderboard](https://docs.seesaw.fun/mcp/tools/get-leaderboard.md): Global, zone, and contest leaderboards - [get_my_profile](https://docs.seesaw.fun/mcp/tools/get-my-profile.md): The key owner's own profile, including balances - [get_topic](https://docs.seesaw.fun/mcp/tools/get-topic.md): Get one topic in full detail - [get_topic_price_history](https://docs.seesaw.fun/mcp/tools/get-topic-price-history.md): Probability time series of a prediction market - [get_user](https://docs.seesaw.fun/mcp/tools/get-user.md): Look up a public user profile by handle - [list_my_positions](https://docs.seesaw.fun/mcp/tools/list-my-positions.md): The key owner's open positions with cost, price, and unrealized P&L - [list_my_settlements](https://docs.seesaw.fun/mcp/tools/list-my-settlements.md): Settled predictions: payouts, claim status, realized P&L - [list_my_topics](https://docs.seesaw.fun/mcp/tools/list-my-topics.md): Topics created by the key owner, including moderation status - [list_topic_comments](https://docs.seesaw.fun/mcp/tools/list-topic-comments.md): Read the discussion under a topic, with author positions - [list_topics](https://docs.seesaw.fun/mcp/tools/list-topics.md): Browse topics by ranking — trending, newest, or ending soon - [list_user_topics](https://docs.seesaw.fun/mcp/tools/list-user-topics.md): List topics created by a user (privacy-gated) - [list_zones](https://docs.seesaw.fun/mcp/tools/list-zones.md): List topic zones (communities) - [Tools overview](https://docs.seesaw.fun/mcp/tools/overview.md): The 14 SeeSaw tools and when to use which - [search_topics](https://docs.seesaw.fun/mcp/tools/search-topics.md): Search prediction markets and polls by keyword - [Quickstart](https://docs.seesaw.fun/quickstart.md): Connect an AI agent to SeeSaw in five minutes - [Rate limits](https://docs.seesaw.fun/rate-limits.md): Per-key quotas, response headers, and how to handle 429s ## OpenAPI Specs - [openapi](https://docs.seesaw.fun/api-reference/openapi.yaml)