List Polymarket event annotations
List the dated explanations of a Polymarket event's price moves.
Headers
Get your API keyAPI key (`sfk_...`)
Event id (digits) or slug, as in polymarket.com/event/{slug}.
min 1 chars · max 300 chars · pattern: ^[A-Za-z0-9_]+(?:-[A-Za-z0-9_]+)*$
Only annotations about this outcome, matched on its name without regard to case.
min 1 chars · max 200 chars
Endpoint-specific response payload.
`not_found` when no event has this id or slug.
one of: found, not_found
Id of the event, when known.
Slug of the event.
Newest first. Empty when the event has none: only events with large price moves carry annotations.
When the price moved (ISO-8601, UTC).
Headline of the explanation.
What happened and why the price moved.
The outcome whose price moved.
Price before the move (0 to 1).
Price after the move (0 to 1).
Size of the move.
News articles cited for the move.
Publisher name.
Link to the article.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/polymarket/events/democratic-presidential-nominee-2028/annotations" \
-H "x-api-key: YOUR_API_KEY"Responses
Polymarket event annotations.