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

# search_topics

> Search prediction markets and polls by keyword

Full-text search across SeeSaw topics. Use this when you have a **keyword**;
use [`list_topics`](/mcp/tools/list-topics) when you want a ranking instead.

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

<Note>
  Search has its own tighter budget — 30 requests/min on top of the general
  limit. Browse with `list_topics` where you can.
</Note>

## Parameters

| Name     | Type                            | Required | Default | Notes                             |
| -------- | ------------------------------- | -------- | ------- | --------------------------------- |
| `query`  | string                          | ✅        | —       | Keyword(s)                        |
| `type`   | `all` \| `prediction` \| `poll` |          | `all`   | See pagination note below         |
| `cursor` | string                          |          | —       | Only honored with a single `type` |
| `limit`  | integer ≤ 100                   |          | 20      | Only honored with a single `type` |

<Warning>
  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`. To paginate, request `type=prediction` or `type=poll`.
</Warning>

## Returns

A topic list (same shape as `list_topics`). Captured live:

```json theme={null}
{
  "data": [
    {
      "id": "48566076-03be-4aa4-8f12-b4f061221f96",
      "type": "prediction",
      "title": "Argentina wins the 2026 FIFA World Cup",
      "status": "closed",
      "creator": {
        "id": "a9997b8e-5e97-4d28-8c9a-b8adb286ddd0",
        "handle": "63941083",
        "nickname": "Erica",
        "avatar_url": "https://api.dicebear.com/7.x/avataaars/png?seed=seesaw04&size=200",
        "account_type": "user",
        "url": "https://seesaw.fun/profile/a9997b8e-5e97-4d28-8c9a-b8adb286ddd0"
      },
      "created_at": "2026-06-27T03:50:59Z",
      "end_time": "2026-07-04T15:59:00Z",
      "comments_count": 2,
      "favorites_count": 104,
      "url": "https://seesaw.fun/topic/48566076-03be-4aa4-8f12-b4f061221f96",
      "options": [
        { "id": "c580f397-7344-47a2-8639-8d6b1c56b614", "name": "Yes", "probability": "0.5079", "is_winner": false },
        { "id": "7970f347-5b3f-4d9e-929f-0e5b78a3f498", "name": "No", "probability": "0.4921", "is_winner": false }
      ],
      "total_volume": "168945.5017",
      "traders_count": 168
    }
  ],
  "next_cursor": "bzoy",
  "has_more": true
}
```

## Example prompts

* "Search SeeSaw for World Cup predictions."
* "Are there any markets about bitcoin hitting 100k?"
* "Find polls about AI."

## Related

[`list_topics`](/mcp/tools/list-topics) ·
[`get_topic`](/mcp/tools/get-topic) ·
[`list_topic_comments`](/mcp/tools/list-topic-comments)