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.