get_topic

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:

{
  "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:

{
  "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"
}

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.

A 404 means the topic doesn’t exist or isn’t publicly available (moderation/privacy) — see 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-…?”

get_topic_price_history · list_topic_comments · search_topics

Getting Started

MCP Server

Platform

Parameters

Returns

Example prompts

​Parameters

​Returns

​Example prompts

​Related

Parameters

Returns

Example prompts

Related