Polymarket

Get Polymarket market resolution

Get how a Polymarket market resolved or is resolving, with the oracle's record.

GET/v1/polymarket/markets/{conditionId}/resolution
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
conditionIdstringrequiredpath

Condition id of the market: 0x followed by 64 hex digits.

pattern: ^0x[0-9a-fA-F]{64}$

Response fields
23

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when no market has this condition id.

one of: found, not_found

dataconditionId
string

The condition id asked for.

The resolution record. Null when there is no record for this market; a market that is still trading can already have one. A record without an oracle question has `status: "resolved"` and null prices and question id.

dataresolutionstatus
stringnullable

Resolution state: `posed` (question asked), `proposed`, `disputed` or `resolved`.

dataresolutionwasDisputed
boolean

Whether an answer was disputed.

dataresolutionextendedReview
boolean

Whether the dispute went to extended review.

dataresolutionproposedPrice
stringnullable

The first proposed answer as the oracle's number. Null when there is no proposal, or when the record carries no proposed price. For yes/no markets 1000000000000000000 means Yes and 0 means No.

dataresolutionreproposedPrice
stringnullable

The answer proposed after a dispute. Null when there is none, or when the record carries no price.

dataresolutionsettledPrice
stringnullable

The final answer once settled. Null until a resolution is recorded, or when the record carries no settled price.

dataresolutionupdatedAt
stringnullable

When the resolution state last changed (ISO-8601, UTC).

dataresolutionquestionId
stringnullable

The oracle's question id. Null when the record carries no question id.

datastatus
stringnullable

`open`, `closed` or `inactive`, from the market.

dataclosedAt
stringnullable

When the market closed (ISO-8601, UTC).

datawinningOutcome
stringnullable

The winning outcome, once the market closed.

Outcomes with their final or current prices.

dataoutcomes[]name
string

Outcome name, for example `Yes`.

dataoutcomes[]tokenId
stringnullable

Outcome token id, used for order books, prices and price history. A decimal string.

dataoutcomes[]price
numbernullable

Current price as a probability between 0 and 1. Null when the market is not trading.

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/markets/0x0f49db97f71c68b1e42a6d16e3de93d85dbf7d4148e3f018eb79e88554be9f75/resolution" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Polymarket market resolution.