Polymarket

Get Polymarket prices

Get Polymarket prices for up to 150 outcome tokens in one request.

GET/v1/polymarket/prices
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
tokenIdsarrayrequiredquery

Outcome token ids, 1–150. Repeat the parameter or separate ids with commas. Token ids are the `tokenId` of a market outcome.

Response fields
19

Endpoint-specific response payload.

One entry per requested token id, in request order.

dataresults[]tokenId
string

The token id as requested.

dataresults[]lookupStatus
string

`not_found` when the token has no live prices: unknown, or its market has closed.

one of: found, not_found

Current prices for one outcome token.

dataresults[]pricebestBid
numbernullable

Highest buy price.

dataresults[]pricebestAsk
numbernullable

Lowest sell price.

dataresults[]pricemidpoint
numbernullable

Halfway between best bid and best ask.

dataresults[]pricespread
numbernullable

Gap between best ask and best bid.

dataresults[]pricelastTradePrice
numbernullable

Price of the last trade.

dataresults[]pricelastTradeSide
stringnullable

`BUY` or `SELL`: which side the last trade took.

Counts across the batch.

datasummaryrequested
integer

Token ids requested.

datasummaryfound
integer

Token ids with data.

datasummarynotFound
integer

Token ids with no data: unknown, or the market has closed and no longer has an order book.

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/prices?tokenIds=54533043819946592547517511176940999955633860128497669742211153063842200957669" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Polymarket prices.