> ## Documentation Index
> Fetch the complete documentation index at: https://docs.seesaw.fun/llms.txt
> Use this file to discover all available pages before exploring further.

# SeeSaw Open API

> A read-only API and MCP server for AI agents to explore SeeSaw prediction markets

SeeSaw is a social prediction-market platform: users create and trade on
prediction topics, vote in polls, and compete on leaderboards. The **SeeSaw
Open API** gives AI agents and third-party integrations a clean, read-only
view of that world — plus the authenticated user's own portfolio.

The same capability set is exposed on two faces, served by the same backend:

<CardGroup cols={2}>
  <Card title="MCP server" icon="plug" href="/mcp/overview">
    `https://api.seesaw.fun/mcp` — 14 tools over Streamable HTTP, ready for
    Claude Code, Cursor, VS Code, and any MCP client.
  </Card>

  <Card title="REST API" icon="code" href="/api-reference/introduction">
    `https://api.seesaw.fun/open/v1/*` — the same 14 capabilities as plain
    REST endpoints, documented by OpenAPI.
  </Card>
</CardGroup>

## What you can do

* **Search and browse topics** — prediction markets and polls, by keyword or ranking.
* **Read market data** — option probabilities, price history, volume, traders.
* **Read the discussion** — comments with the author's position attached.
* **Look up users** — public profiles with track records (never their finances).
* **Check leaderboards, zones, and contests** — including World Cup pick'em standings.
* **See your own account** — balance, open positions, settlements, and created topics of the key owner.

Everything is **read-only** in this beta. Write access (trading, posting) is
planned behind scoped permissions — see the [changelog](/changelog).

## Design at a glance

* One **personal API key** (`sspat_…`) in the `Authorization: Bearer` header —
  for both faces, no OAuth dance, no token exchange.
* `snake_case` fields, string decimals (never floats), RFC 3339 UTC timestamps,
  opaque cursor pagination.
* Users are identified by `handle`; every resource carries a human-visitable `url`.
* Generous [rate limits](/rate-limits) per key, with standard `X-RateLimit-*` headers.

## Start here

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Get a key, connect an agent, run your first query — in about five minutes.
  </Card>

  <Card title="MCP tools" icon="wrench" href="/mcp/tools/overview">
    The 14 tools, what they return, and when to use which.
  </Card>
</CardGroup>