Skip to main content
POST
/
2
/
pm
/
order
/
quote
Quote an order against the live book (price impact / expected fill)
curl --request POST \
  --url https://demo-api.mobula.io/api/2/pm/order/quote \
  --header 'Content-Type: application/json' \
  --data '
{
  "tokenId": "<string>",
  "side": "<string>",
  "size": 50000000
}
'
{
  "hostname": "<string>",
  "took": 123,
  "data": "<unknown>"
}
Alpha — This endpoint is part of the Prediction Markets API, currently in early access. May change without notice.

​
Request Body

​
tokenId
string
required
The outcome token ID to get a quote for.
​
side
string
required
Order side: BUY or SELL.
​
size
number
required
Number of tokens to buy or sell. Must be positive.

​
Response

​
data
object
Fill estimation result.
​
hostname
string
Server node identifier.
​
took
number
Request processing time in milliseconds.

​
Usage Example

curl -X POST "https://api.mobula.io/api/2/pm/order/quote" \
  -H "Content-Type: application/json" \
  -d '{
    "tokenId": "71321045533314185944161150504789982525459828614995786377552078351132518100924",
    "side": "BUY",
    "size": 1000
  }'

​
Example Response

{
  "data": {
    "avgPriceUSD": 0.352,
    "bestPriceUSD": 0.35,
    "totalCostUSD": 352,
    "filledToken": 1000,
    "unfilledToken": 0,
    "side": "BUY",
    "outcomeId": "71321...",
    "amountInUSD": 352,
    "amountOutUSD": 352,
    "marketImpactPercentage": 0.57,
    "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "fee": {
      "amountUSD": "0.000000",
      "platformFeesPercentage": 0,
      "wallet": null,
      "deductedFrom": "input"
    },
    "outcome": {
      "outcomeId": "71321...",
      "label": null,
      "marketId": null,
      "question": null
    },
    "details": {
      "levels": [
        { "priceUSD": 0.35, "sizeToken": 5000, "filledToken": 800 },
        { "priceUSD": 0.36, "sizeToken": 3000, "filledToken": 200 }
      ]
    }
  },
  "hostname": "node-xyz",
  "took": 42
}

Body

application/json
​
tokenId
string
required
Minimum string length: 1
Pattern: ^[0-9]+$
​
side
string
required
​
size
number
required
Required range: 0 < x <= 100000000

Response

201 - application/json

Prediction Markets response

​
hostname
string
required
​
took
number
required
​
data
any | null

See the per-endpoint reference for the exact response shape.