Tools overview - SeeSaw Developer

Ten tools read public data; four read the key owner’s account. Tool results carry the same JSON as the corresponding REST endpoint (linked in each page).

Discover topics

Tool	Use when
`search_topics`	You have a keyword (“bitcoin”, “World Cup final”)
`list_topics`	You want a ranking — trending, newest, or ending soon

Inspect one topic

Tool	Returns
`get_topic`	Full detail: description, options with probabilities or votes, volume
`get_topic_price_history`	Probability time series (prediction markets only)
`list_topic_comments`	Discussion, with each author’s position when they hold one

People and competition

Tool	Returns
`get_user`	Public profile + track record by handle
`list_user_topics`	Topics a user created (privacy-gated)
`get_leaderboard`	Global / zone / contest boards
`list_zones`	Topic communities with counts
`get_contest`	World Cup pick’em schedule and results

The key owner’s account

Tool	Returns
`get_my_profile`	Own profile including credits, diamonds, total assets
`list_my_positions`	Open positions with cost, current price, unrealized P&L
`list_my_settlements`	Settled outcomes: payouts, claim status, realized P&L
`list_my_topics`	Own created topics, incl. moderation status

Financial fields exist only on get_my_profile and the other *_my_* tools — public profiles never expose another user’s balance.

Typical combinations

“What does the market think about X?” — search_topics → get_topic → get_topic_price_history.
“Summarize the debate” — get_topic → list_topic_comments (positions attached make sentiment analysis easy).
“How is my portfolio doing?” — get_my_profile → list_my_positions → list_my_settlements.
“Who should I follow?” — get_leaderboard → get_user → list_user_topics.