list_topics

Browse SeeSaw topics by ranking — newest, the personalized recommended feed, or topics from creators the key owner follows — optionally filtered by category. Scope: read · Annotations: readOnlyHint REST equivalent: GET /open/v1/topics

Parameters

Name	Type	Default	Notes
`sort`	`newest` \| `recommended` \| `following`	`newest`	`recommended` is the personalized feed; `following` is creators the owner follows
`category_id`	string (uuid)	—	From `list_topic_categories`. Ignored when `sort=recommended`
`mechanism`	`v21_lmsr` \| `v2_share`	`v21_lmsr`
`cursor`	string	—
`limit`	integer ≤ 100	20
`language`	see languages	`en`

Returns

Topic cards. close_time is the trading deadline — the countdown anchor, and what can_buy is computed from. end_time is the creator’s expected result-submission time and is operational only; don’t show it as a deadline. implied_price is each option’s current price (0–1); prices across a topic sum to 1. my_option_ids lists the options the key owner already holds — with v21_lmsr at most one, because a topic takes one order per user (an order later sold in the SeeSaw app still counts as that one order). stake_rules is the range of coins the topic accepts per order (min_coins..max_coins; null on v2_share). ruby_boost is the ruby boost running on the topic right now, or null. Orders placed, settled, or (in the app) sold while the boost is live get the multiplier. See Rubies and positions. Example:

{
  "data": [
    {
      "id": "a3f21c48-6b19-4d7e-9c04-8e5b2f7a1d63",
      "title": "Will the Fed cut rates at the November 2026 meeting?",
      "status": "active",
      "mechanism": "v21_lmsr",
      "close_time": "2026-10-06T23:34:02.46058Z",
      "end_time": "2026-10-08T23:34:02.46058Z",
      "can_buy": true,
      "options": [
        {
          "id": "b1c0d9e8-4a72-4f31-95d6-0c1e7a83b402",
          "label": "Yes",
          "index": 0,
          "implied_price": "0.4988"
        },
        {
          "id": "c2d1e0f9-5b83-4a42-86e7-1d2f8b94c513",
          "label": "No",
          "index": 1,
          "implied_price": "0.5012"
        }
      ],
      "traders_count": 2,
      "comments_count": 2,
      "creator": {
        "id": "22222222-2222-4222-8222-222222222222",
        "nickname": "Mira Chen",
        "avatar_url": "https://cdn.seesaw.fun/avatars/20260901/mira.png",
        "url": "https://seesaw.fun/profile/22222222-2222-4222-8222-222222222222"
      },
      "my_option_ids": [
        "b1c0d9e8-4a72-4f31-95d6-0c1e7a83b402"
      ],
      "ruby_boost": {
        "multiplier": "2.0000",
        "ends_at": "2026-09-30T16:00:00Z"
      },
      "stake_rules": {
        "min_coins": "1.0000",
        "max_coins": "10000.0000",
        "default_coins": "100.0000",
        "rules_version": 2
      },
      "created_at": "2026-09-02T23:34:02.46058Z",
      "url": "https://seesaw.fun/topic/a3f21c48-6b19-4d7e-9c04-8e5b2f7a1d63"
    }
  ],
  "next_cursor": null,
  "has_more": false
}

Statuses

`status`	Meaning
`active`	Trading open
`waiting`	Past `close_time`, awaiting the creator’s ruling
`proposed`	A result was submitted; the publicity window is running
`voting`	Under appeal investigation
`resolved`	Settled

Buying is closed from proposed onwards.

Example prompts

“What’s new on SeeSaw?”
“Show me the crypto topics.”
“What are the people I follow predicting?”

search_topics · get_topic · list_topic_categories

Getting Started

Concepts

MCP Server

Platform

Parameters

Returns

Statuses

Example prompts

​Parameters

​Returns

​Statuses

​Example prompts

​Related

Parameters

Returns

Statuses

Example prompts

Related