Skip to main content
POST
Edit an order
Cambia el precio (orderOdds) y/o el volumen (orderVolume) de una orden limit existente. En órdenes parcialmente cruzadas, 4casters cancela la orden existente y envía una nueva con los valores indicados. El nuevo orderVolume no descuenta el volumen ya cruzado: si originalmente colocaste bet: 10, se cruzaron 5yeditasa‘orderVolume:10‘,laordenanteriorsecancela(reembolsando5 y editas a `orderVolume: 10`, la orden anterior se cancela (reembolsando 5) y se crea una nueva por 10(debitando10 (debitando 10), dejándote $5 netos menos.
Existe una variante gRPC más reciente en POST /session/v4/editOrder. Acepta el mismo cuerpo de solicitud y además devuelve errorType en fallos de validación. Prefiérela en integraciones nuevas cuando hayas confirmado que la forma te funciona.

Solicitud

POST /session/editOrder
string
requerido
Id de la orden a editar. Obténlo de data.unmatched.orderID de /session/v3/place o de id de /user/getUnmatched.
integer
Nuevas cuotas americanas. Pasa null para dejar las cuotas sin cambios.
number
Nuevo importe de bet. Pasa null para dejar el volumen sin cambios.
string
El valor por defecto es limit. Consulta tipos de orden.
string
Opcional. Reemplaza el userReference existente de la orden.
number
Opcional. El volumen que originalmente pretendías colocar; el servidor lo usa al conciliar cruces parciales.
string
Opcional. Nueva expiración en minutos (cadena).
boolean
Solo v4. Rechaza la edición si no hay liquidez en espera del lado contrario.

Respuesta

El resultado refleja la forma de respuesta de colocar orden: un resumen cancelled más el resultado nuevo matched / unmatched:
object
Resumen de la orden original cancelada y reemplazada.
array
Cruces producidos al reenviar al nuevo precio/volumen. Misma forma que un MatchedFill en colocar orden.
object
Oferta en espera del resto no cruzado de la nueva orden.

Errores

Autorizaciones

Authorization
string
header
requerido

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.

Cuerpo

application/json
sessionID
string
requerido

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 whatever size is available at your price or better and cancel the remainder; never rests. A partial fill is a success; rejected only when there is no matchable liquidity at all.
  • fillOrKill — all-or-nothing taker. Match the entire bet immediately or the whole order is rejected and any partial fills are rolled back; never rests.
Opciones disponibles:
limit,
post,
postArb,
fillAndKill,
fillOrKill
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.

Respuesta

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

data
object