Skip to main content
GET /api/v1/execution-price Walks the live orderbook to estimate the average fill price, cost, and slippage for a hypothetical order.
If you do not know the market identifiers yet, start with /markets. You can call this endpoint with either parsec_id or exchange + market_id.

Parameters

parsec_id
string
Canonical selector. Provide either parsec_id or both exchange + market_id.
exchange
string
Exchange selector used with market_id.
market_id
string
Exchange-native market ID used with exchange.
outcome
string
default:"yes"
Outcome selector. For binary markets this is usually yes or no.
side
string
required
Order side: buy or sell.
amount
number
required
Order size in contracts.

Response

(root)
object
curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.parsecapi.com/api/v1/execution-price?parsec_id=polymarket:572473&outcome=yes&side=buy&amount=100"
{
  "avg_price": 0.652,
  "total_cost": 65.2,
  "filled_amount": 100.0,
  "fully_filled": true,
  "slippage": 0.002,
  "levels_consumed": 3,
  "worst_price": 0.654,
  "fee_estimate": null,
  "net_cost": null
}