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

> Read the discussion under a topic, with author positions

Flat, newest-first top-level comments of a topic. Each comment may carry the
**author's position** (which side they hold) — a shortcut for sentiment
analysis: you see not just what people say but what they've staked on.

**REST equivalent**: `GET /open/v1/topics/{id}/comments`

## Parameters

| Name               | Type          | Required | Default | Notes |
| ------------------ | ------------- | -------- | ------- | ----- |
| `topic_id`         | string (uuid) | ✅        | —       |       |
| `cursor` / `limit` |               |          | — / 20  |       |

## Returns

Captured live:

```json theme={null}
{
  "data": [
    {
      "id": "447654e5-edd8-4a83-b18d-c8a6837e057f",
      "author": {
        "id": "e1d0245e-c24f-4887-be50-e6ba4840f440",
        "handle": "1000000125",
        "nickname": "Nanaue",
        "avatar_url": "https://cdn.seesaw.fun/avatars/20260209/55e50dcc-6975-400a-92d8-a832a07cef25.png",
        "account_type": "user",
        "url": "https://seesaw.fun/profile/e1d0245e-c24f-4887-be50-e6ba4840f440"
      },
      "content": "Ang is not good",
      "created_at": "2026-02-14T02:56:52Z",
      "like_count": 0,
      "reply_count": 0,
      "is_creator_comment": true,
      "author_position": { "label": "Yes", "option_name": "" }
    }
  ],
  "next_cursor": "bzoy",
  "has_more": true
}
```

Field notes:

* `author_position` is `null` when the commenter holds no position.
* `is_creator_comment` marks the topic creator's own comments.
* Replies stay behind `reply_count` — the list is top-level only.
* **Poll comments can be vote-gated**: if viewers must vote before reading,
  `data` comes back empty with a top-level `"gated": true`.

## Example prompts

* "What are people saying about this market?"
* "Summarize the bull vs bear arguments in the comments — weigh by which side each commenter holds."

## Related

[`get_topic`](/mcp/tools/get-topic) ·
[`get_topic_price_history`](/mcp/tools/get-topic-price-history)