Skip to main content
POST
Edit an order
Change the price (orderOdds) and/or volume (orderVolume) of an existing limit order. For partially-filled orders, 4casters cancels the existing order and submits a new one with the supplied values. The new orderVolume does not account for previously filled volume — if you originally placed bet: 10, 5wasfilled,andyouedittoorderVolume:10,thepreviousorderiscancelled(refunding5 was filled, and you edit to `orderVolume: 10`, the previous order is cancelled (refunding 5) and a new order is created for 10(debiting10 (debiting 10), leaving you net $5 down.
A newer gRPC variant lives at POST /session/v4/editOrder. It accepts the same request body and additionally returns errorType on validation failures. Prefer it for new integrations once you’ve confirmed the shape works for you.

Request

POST /session/editOrder
string
required
Order id to edit. Get it from data.unmatched.orderID of /session/v3/place or id from /user/getUnmatched.
integer
New American odds. Pass null to leave odds unchanged.
number
New bet amount. Pass null to leave volume unchanged.
string
Defaults to limit. See order types.
string
Optional. Replaces the existing userReference on the order.
number
Optional. The volume you originally intended to place; used by the server when reconciling partial fills.
string
Optional. New expiration in minutes (string).
boolean
v4 only. Reject the edit if there is no resting opposite-side liquidity.

Response

The result mirrors the place order response shape — a cancelled summary plus the new matched / unmatched outcome:
object
Summary of the cancelled-and-replaced original order.
array
Fills produced by re-submitting at the new price/volume. Same shape as a MatchedFill in place order.
object
Resting offer for the unfilled remainder of the new order.

Errors

Authorizations

Authorization
string
header
required

Pass your auth token in the Authorization header. The Bearer prefix is optional; the server also accepts a signed auth cookie or a token field in the request body.

Body

application/json
sessionID
string
required

Order id to edit.

orderOdds
integer | null

New American odds. Pass null to leave odds unchanged.

orderVolume
number | null

New bet amount. Pass null to leave volume unchanged. Does not account for previously-filled volume.

orderType
enum<string>

Order placement strategy.

  • limit — default. Match against any liquidity at your price or better as a taker, rest the remainder as a maker.
  • post — guarantee maker. Reject if the order would match resting liquidity.
  • postArb — like post, but allowed to match if the matched odds are within 1% of yours, avoiding taker fees.
  • fillAndKill — guarantee taker. Match immediately or reject.
Available options:
limit,
post,
postArb,
fillAndKill
userReference
string
intendedOrderVolume
number

Optional. The volume you originally intended to place; used by the server when reconciling partial fills.

expiryChange
string

Optional. New expiration in minutes (string).

blockIfNoOtherSideOrders
boolean

v4 only. Reject the edit if there is no resting opposite-side liquidity.

Response

Edit result. Mirrors the place-order response shape: a cancelled summary plus the new matched / unmatched outcome.

data
object