Skip to main content

Comments

Every prediction event on Yoyo Market (hereinafter “Yoyo”) has a comment section where users can discuss outcomes, share analysis, and debate probabilities. Comments also display the author's current position in the market, adding transparency to the discussion.

Viewing Comments​

Event Comments​

GET /api/v1/events/{event_id}/comments

Returns top-level comments for the specified event. Each comment includes the author's profile information and their current market position (if any).

Replies to a Comment​

GET /api/v1/comments/{id}/replies

Returns all replies to a specific comment, forming a threaded conversation.

Creating Comments​

Post a Top-Level Comment​

POST /api/v1/events/{event_id}/comments
{
  "text": "I think this event resolves YES based on recent data."
}

Requires authentication.

Reply to a Comment​

POST /api/v1/comments/{id}/reply
{
  "text": "Good point, but consider the opposing trend."
}

Requires authentication. Creates a nested reply under the specified parent comment.

Editing and Deleting​

Update a Comment​

PUT /api/v1/comments/{id}
{
  "text": "Updated analysis with new information."
}

You can only edit your own comments. Requires authentication.

Delete a Comment​

DELETE /api/v1/comments/{id}

You can only delete your own comments. Requires authentication.

Reactions​

Users can like or dislike comments to surface the most valuable discussion.

Add a Reaction​

POST /api/v1/comments/{id}/like
POST /api/v1/comments/{id}/dislike

Requires authentication. Each user can add only one reaction per comment. Adding a like when you have already disliked (or vice versa) replaces the previous reaction.

Remove a Reaction​

DELETE /api/v1/comments/{id}/reaction

Removes your reaction from the comment. Requires authentication.

Position Transparency​

Each comment displayed in the UI includes the author's current position in the event's market. This means other users can see whether the commenter has a long (YES) or short (NO) stake, and its approximate size. This feature helps the community evaluate opinions in the context of the commenter's financial interest.

Summary of Endpoints​

MethodEndpointAuthDescription
GET/api/v1/events/{event_id}/commentsOptionalList event comments
GET/api/v1/comments/{id}/repliesOptionalList replies to a comment
POST/api/v1/events/{event_id}/commentsRequiredCreate a top-level comment
POST/api/v1/comments/{id}/replyRequiredReply to a comment
PUT/api/v1/comments/{id}RequiredEdit your comment
DELETE/api/v1/comments/{id}RequiredDelete your comment
POST/api/v1/comments/{id}/likeRequiredLike a comment
POST/api/v1/comments/{id}/dislikeRequiredDislike a comment
DELETE/api/v1/comments/{id}/reactionRequiredRemove your reaction