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

# get_topic

> Get one topic in full detail

Full details of one topic: description, options with current probabilities
(prediction) or vote counts (poll), volume, deadline, creator, and a
shareable URL.

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

## Parameters

| Name       | Type                   | Required | Default | Notes                                                              |
| ---------- | ---------------------- | -------- | ------- | ------------------------------------------------------------------ |
| `topic_id` | string (uuid)          | ✅        | —       | From a list/search result or a seesaw\.fun URL                     |
| `type`     | `prediction` \| `poll` |          | —       | Optional hint; when omitted, prediction is probed first, then poll |

## Returns

Everything from the list shape **plus** `description`, `image_urls`,
`resolved_at` (and `category`/`ref` when present).

Prediction market, captured live:

```json theme={null}
{
  "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,
  "description": null,
  "image_urls": [],
  "resolved_at": null
}
```

Poll (note the different option/engagement fields), captured live:

```json theme={null}
{
  "id": "666645a9-1eaf-4ba8-9693-8ed460212496",
  "type": "poll",
  "status": "resolved",
  "options": [
    { "id": "05643374-880c-4bf5-8ae9-f1ee2d40a815", "name": "TestA", "votes_count": 0, "is_winner": false },
    { "id": "cddaf8ef-3a85-44df-93ad-f6b89edf45a8", "name": "TestB", "votes_count": 0, "is_winner": false }
  ],
  "voters_count": 0,
  "total_stake": "0",
  "votes_visible": true,
  "resolved_at": "2026-05-31T16:00:06Z"
}
```

<Note>
  On unsettled polls the vote distribution can be hidden from viewers who
  haven't voted: then `votes_visible` is `false` and each `votes_count` is
  `null` — never a fake `0`.
</Note>

A 404 means the topic doesn't exist **or** isn't publicly available
(moderation/privacy) — see [Errors](/errors).

## Example prompts

* "Give me the details on that Nasdaq market."
* "What are the current odds and volume for topic [https://seesaw.fun/topic/9cef7a1a-…](https://seesaw.fun/topic/9cef7a1a-…)?"

## Related

[`get_topic_price_history`](/mcp/tools/get-topic-price-history) ·
[`list_topic_comments`](/mcp/tools/list-topic-comments) ·
[`search_topics`](/mcp/tools/search-topics)