GET
/
price
Get market price
curl --request GET \
  --url https://clob.polymarket.com/price
{
  "price": "1800.50"
}

​
Get Price

Get the price for a market (best bid or best ask). HTTP REQUEST GET /<clob-endpoint>/price

​
Request Payload Parameters

NameRequiredTypeDescription
token_idyesstringtoken ID to get price for
sideyesstringbuy or sell (ask and bid)

​
Response

{"price": ".512"} 
print(
    client.get_price(
        token_id="71321045679252212594626385532706912750332728571942532289631379312455583992563", side="buy
    )
)

​
Get Prices

Get the prices for a group of markets (best bid or best ask). HTTP REQUEST POST /<clob-endpoint>/prices

​
Request Payload Parameters

NameRequiredTypeDescription
paramsyesBookParamssearch params for books
A BookParams object is of the form:
NameRequiredTypeDescription
token_idyesstringtoken ID of market to get book for
sideyesstringBUY or SELL

​
Response

{[asset_id]: {[side]: price}} 
resp = client.get_prices(
    params=[
        BookParams(
            token_id="71321045679252212594626385532706912750332728571942532289631379312455583992563",
            side="BUY",
        ),
        BookParams(
            token_id="71321045679252212594626385532706912750332728571942532289631379312455583992563",
            side="SELL",
        ),
        BookParams(
            token_id="52114319501245915516055106046884209969926127482827954674443846427813813222426",
            side="BUY",
        ),
        BookParams(
            token_id="52114319501245915516055106046884209969926127482827954674443846427813813222426",
            side="SELL",
        ),
    ]
)
print(resp)

Query Parameters

​
token_id
string
required

The unique identifier for the token

​
side
enum<string>
required

The side of the market (BUY or SELL)

Available options:
BUY,
SELL

Response

Successful response

​
price
string
required

The market price (as string to maintain precision)

Example:

"1800.50"