Skip to main content

GET /api/v1/creators/polymarket-outcomes

Looks up a Polymarket event by its URL or slug and returns its outcomes with current probabilities, together with the event title, image and resolution rules. Event creators use it to pick the outcomes to attach to their markets: the returned token_id values are passed as polymarket_token_ids when creating a pool, so the platform can keep the odds in sync with Polymarket. See Create Event (full).

Authentication

Required -- Bearer token. The caller must be a registered creator; other users receive 403 Forbidden.

Request

Query Parameters

ParameterTypeRequiredDescription
urlstringYesPolymarket event URL (e.g. https://polymarket.com/event/<slug>) or the bare event slug

Example

curl -G https://intotes.com/api/v1/creators/polymarket-outcomes \
--data-urlencode "url=https://polymarket.com/event/presidential-election-winner-2028" \
-H "Authorization: Bearer <token>"

Response

200 OK

{
"title": "Presidential Election Winner 2028",
"name_ru": "Победитель президентских выборов 2028",
"image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/election-2028.png",
"rules": "This market will resolve to the candidate who wins the 2028 US presidential election...",
"rules_ru": "Рынок разрешится в пользу кандидата, победившего на президентских выборах в США 2028 года...",
"market_context": "Multi-candidate market on the 2028 US presidential election.",
"market_context_ru": "Рынок с несколькими кандидатами на президентских выборах в США 2028 года.",
"tags": ["politics", "us-election"],
"outcomes": [
{
"token_id": "21742633143463906290569050155826241533067272736897614950488156847949938836455",
"name": "J.D. Vance",
"name_ru": "Дж. Д. Вэнс",
"probability": 0.31,
"market_question": "Will J.D. Vance win the 2028 US Presidential Election?",
"image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/vance.png"
},
{
"token_id": "48331043336612883890938759509493159234755048973500640148014422747788308965732",
"name": "Gavin Newsom",
"name_ru": "Гэвин Ньюсом",
"probability": 0.18,
"market_question": "Will Gavin Newsom win the 2028 US Presidential Election?",
"image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/newsom.png"
}
]
}
FieldTypeDescription
titlestringEvent title on Polymarket
name_rustringRussian title (machine translation; empty string if unavailable)
imagestringEvent image URL
rulesstringResolution rules from Polymarket
rules_rustringRussian rules (machine translation; empty string if unavailable)
market_contextstringShort generated description of the event (empty string if unavailable)
market_context_rustringRussian version of market_context (empty string if unavailable)
tagsstring[]Suggested tags for the event (null if unavailable)
outcomesobject[]Outcomes sorted by probability, highest first
outcomes[].token_idstringPolymarket CLOB token ID -- use it in polymarket_token_ids
outcomes[].namestringShort outcome name
outcomes[].name_rustringRussian outcome name (machine translation; empty string if unavailable)
outcomes[].probabilitynumberCurrent probability, 0..1
outcomes[].market_questionstringFull question of the underlying Polymarket market (omitted when empty)
outcomes[].imagestringOutcome image URL (omitted when empty)

All outcomes of the event are returned; there is no limit. A binary Yes/No event is returned as a single outcome named after the market question, with the token_id and probability of the "Yes" side.

Errors

StatusDescription
400url is missing, or the Polymarket event could not be fetched (invalid URL or slug, unknown event)
401Missing or invalid access token
403The caller is not a creator
500Internal server error
503Creator or Polymarket service temporarily unavailable