Polymarket

List Polymarket event comments

List the comments and replies on a Polymarket event, newest or oldest first, with no depth limit.

GET/v1/polymarket/events/{eventId}/comments
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
5
eventIdstringrequiredpath

Event id (digits). Slugs are not accepted here.

pattern: ^\d{1,10}$

sortstringoptionalquery

Order of top-level comments by time. Default: `newest`. Polymarket can sort by likes only on a route that stops after 250 rows, so it is not offered here.

one of: newest, oldest

holdersOnlybooleanoptionalquery

`true` keeps comments by people who hold a position.

limitintegeroptionalquery

Top-level comments per page, 1–100. Default: 40. Replies come with their parent and do not count towards the limit.

≥ 1 · ≤ 100

cursorstringoptionalquery

Pass `page.nextCursor` from the previous response to get the next page. Keep the other filters the same.

min 1 chars · max 6000 chars

Response fields
28

Endpoint-specific response payload.

datalookupStatus
string

`found` on success. An event with no comments returns a found answer with an empty list; an event id that does not exist returns `not_found`.

one of: found, not_found

dataeventId
string

The event id asked for.

Top-level comments in the requested order, each followed by its replies. Replies are separate rows with `parentCommentId`.

datacomments[]id
string

Comment id.

datacomments[]body
string

Comment text.

datacomments[]createdAt
stringnullable

When the comment was posted (ISO-8601, UTC).

datacomments[]updatedAt
stringnullable

When the comment was last edited (ISO-8601, UTC).

datacomments[]parentCommentId
stringnullable

Id of the comment this replies to. Null for a top-level comment.

The public profile attached to a wallet.

datacomments[]authorwallet
string

The trader's wallet address (public on the Polygon chain).

datacomments[]authorname
stringnullable

Chosen username, as Polymarket sends it. Null when the trader has not set one. Present even when the holder does not show it on their own profile (see `usernamePublic`).

datacomments[]authorusernamePublic
booleannullable

Whether the holder shows the chosen username publicly on their profile. Null when Polymarket does not say, as on the trade tape.

datacomments[]authorpseudonym
stringnullable

Auto-generated name such as `Velvety-Relief`.

datacomments[]authorbio
stringnullable

Profile bio.

datacomments[]authorimage
stringnullable

Profile image URL.

datacomments[]reactionCount
integernullable

Reactions on the comment.

datacomments[]reportCount
integernullable

Times the comment was reported.

Attached media, such as GIFs.

datacomments[]media[]url
string

Media URL.

datacomments[]media[]type
stringnullable

Media kind, for example `gif`.

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more pages exist; null on the last page.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/polymarket/events/30829/comments?limit=20" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Polymarket event comments.