Skip to main content
GET
Get one topic in full detail

Authorizations

Authorization
string
header
required

Personal API key issued per SeeSaw user account: Authorization: Bearer sspat_…. Manage keys on the app API (/v1/users/me/api-keys). Revocation propagates within ~60 seconds (validation cache window).

Path Parameters

id
string<uuid>
required

Topic UUID (prediction or poll).

Query Parameters

type
enum<string>

Optional hint; when omitted, prediction is probed first, then poll.

Available options:
prediction,
poll

Response

The topic

Unified prediction+poll card for lists and search. Deliberately trimmed (no description/images) — fetch the topic for details. total_volume/traders_count are prediction-only; voters_count/total_stake/votes_visible are poll-only.

id
string<uuid>
required
type
enum<string>
required
Available options:
prediction,
poll
title
string
required
status
enum<string>
required

Unified lifecycle. closed = past deadline, not yet settled; resolving = outcome being determined (prediction only).

Available options:
open,
closed,
resolving,
resolved,
refunded
created_at
string<date-time>
required
end_time
string<date-time> | null
required
comments_count
integer
required
favorites_count
integer
required
url
string
required

Share page: https://seesaw.fun/topic/{id} (prediction) or /poll/{id} (poll).

options
object[]
required

Shape depends on the parent topic's type.

description
string | null
required
image_urls
string[]
required
resolved_at
string<date-time> | null
required
creator
object

Embedded wherever a user appears. Deliberately carries no financial fields.

total_volume
string

Prediction-only. Decimal string.

traders_count
integer

Prediction-only.

voters_count
integer

Poll-only.

total_stake
string

Poll-only. Decimal string.

votes_visible
boolean

Poll-only. False until the viewer voted or the poll settled; option votes_count is null then.

moderation_status
string

Owner view only — populated exclusively by GET /me/topics.

category
object

Prediction-only.

ref
object

Forwarding/source attribution of the topic.