> ## 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.

# list_topics

> Browse topics by ranking — trending, newest, or ending soon

Browse SeeSaw topics by ranking. Returns prediction markets (tradeable, with
probabilities) **or** polls (vote-based) — the two kinds are separate lists,
never mixed. Use [`search_topics`](/mcp/tools/search-topics) for keyword
search.

**REST equivalent**: `GET /open/v1/topics`

## Parameters

| Name               | Type                                           | Required | Default      | Notes                                                             |
| ------------------ | ---------------------------------------------- | -------- | ------------ | ----------------------------------------------------------------- |
| `type`             | `prediction` \| `poll`                         |          | `prediction` |                                                                   |
| `sort`             | `trending` \| `newest` \| `ending_soon`        |          | `trending`   | `ending_soon` is prediction-only                                  |
| `status`           | `open` \| `closed` \| `resolved` \| `refunded` |          | `open`       | Polls only support `open`; `resolving` isn't filterable           |
| `zone`             | string (slug)                                  |          | —            | Prediction-only; slugs from [`list_zones`](/mcp/tools/list-zones) |
| `cursor` / `limit` |                                                |          | — / 20       |                                                                   |

<Note>
  `status=open` filters by the stored active state — it can include topics past
  their deadline that haven't settled yet; such items show `status: "closed"`
  on themselves.
</Note>

## Returns

Captured live (`sort=trending&limit=2`, trimmed to one item):

```json theme={null}
{
  "data": [
    {
      "id": "9cef7a1a-235c-4aac-9715-cd3732ee75b5",
      "type": "prediction",
      "title": "Will the Nasdaq close up or down tomorrow?",
      "status": "open",
      "creator": {
        "id": "73d02898-4d8f-4af4-8846-6fa4a7c2a84c",
        "handle": "abai",
        "nickname": "阿白",
        "avatar_url": "https://cdn.seesaw.fun/avatars/20260604/92b52f0d-20c6-44e9-b232-f58f4cab190e.jpg",
        "account_type": "user",
        "url": "https://seesaw.fun/profile/73d02898-4d8f-4af4-8846-6fa4a7c2a84c"
      },
      "created_at": "2026-07-03T06:32:30Z",
      "end_time": "2026-07-10T15:59:00Z",
      "comments_count": 0,
      "favorites_count": 58,
      "url": "https://seesaw.fun/topic/9cef7a1a-235c-4aac-9715-cd3732ee75b5",
      "options": [
        { "id": "4d995c85-e5c6-4048-989d-e177442db219", "name": "Yes", "probability": "0.7995", "is_winner": false },
        { "id": "d502b13a-64f6-4951-8029-b84d59019ce5", "name": "No", "probability": "0.2005", "is_winner": false }
      ],
      "total_volume": "112551.8486",
      "traders_count": 104
    }
  ],
  "next_cursor": "bzoy",
  "has_more": true
}
```

Poll items replace the trading fields with `voters_count`, `total_stake`,
`votes_visible`, and per-option `votes_count` — see
[`get_topic`](/mcp/tools/get-topic) for the poll shape.

## Example prompts

* "What's trending on SeeSaw right now?"
* "Show me the newest polls."
* "Which prediction markets close in the next day or two?"
* "What's hot in the stocks zone?"

## Related

[`search_topics`](/mcp/tools/search-topics) ·
[`get_topic`](/mcp/tools/get-topic) ·
[`list_zones`](/mcp/tools/list-zones)