Skip to main content
POST
/
prices
Get multiple market prices by request
curl --request POST \
  --url https://clob.forka.st/prices \
  --header 'Content-Type: application/json' \
  --data '
[
  {
    "token_id": "66991175107696133528353695394151645462081911990365106169948013117379189357520"
  },
  {
    "token_id": "7045107161367241233811523851106536676632348173555291268726302515224841822187",
    "side": "SELL"
  }
]
'
{
  "66991175107696133528353695394151645462081911990365106169948013117379189357520": {
    "BUY": "0.15",
    "SELL": "0.17"
  },
  "7045107161367241233811523851106536676632348173555291268726302515224841822187": {
    "SELL": "0.35"
  }
}
Query multiple tokens in a single call by submitting an array payload.

​
Request payload

Send a JSON array where each object includes:
  • token_id (required) — string identifier for the market outcome you want to price.
  • side (optional) — hint for the preferred book edge to evaluate. When you omit this field the service returns both sides automatically. Even when you supply BUY or SELL, the response still contains prices for both sides so you can compare the spread.

​
Response body

The response is an object keyed by the requested token_id. Every entry includes BUY and SELL fields, each holding the latest executable price for that side of the book. Use the playground controls to test different token lists and confirm how the optional side hint influences pricing.

Body

application/json
Minimum array length: 1
​
token_id
string
required

The unique identifier for the token.

​
side
enum<string>

Optional side hint for the request. When omitted, both sides are returned. When provided, the response still includes both BUY and SELL prices.

Available options:
BUY,
SELL

Response

200 - application/json

Successful response

​
{key}
object

Prices for each market side.