Cancelar órdenes - 4casters API

Hay cuatro variantes de cancelación. Todas responden con el mismo envoltorio: { requestID, data: [ ...CancelResponsePayload ] }.

Payload de respuesta de cancelación

Toda cancelación correcta devuelve una o más entradas con esta forma. Observa que las mayúsculas de los nombres de campo cambian entre la solicitud (orderId/gameId, d minúscula) y la respuesta (orderID/gameID, ID en mayúsculas).

{
  "success": true,
  "orderID": "67f45377c18c6697c172afa4",
  "odds": -110,
  "filled": 0,
  "offered": 100,
  "remaining": 100,
  "side": "5c12bc1ce0daba000f47ba8b",
  "number": -3.5,
  "gameID": "688c0516fbc14da0c202d426",
  "userReference": "client-ref-001",
  "description": "Dallas Mavericks +3.5"
}

boolean

true cuando la orden fue cancelada.

string

ID de la orden cancelada.

number

Importe que ya estaba cruzado antes de que llegara la cancelación.

number

Siempre 0 tras una cancelación: el lado ofertado se reduce a cero.

number

Importe que no estaba cruzado en el momento de la cancelación.

number

Cuotas de la orden cancelada en formato americano, desde la perspectiva del maker.

string

ID de participante (moneyline/spread) o over/under (totales).

number

Número de spread o de total; null en moneylines.

string

Juego al que pertenecía la orden cancelada.

string

El userReference que definiste al colocar la orden, si lo hay.

string

Descripción legible de la apuesta (p. ej. "Dallas Mavericks +3.5").

Cancelar por ID

Cancela una sola orden por su ID de orden.

Solicitud

[
  "cancelById",
  {
    "requestID": "YOUR_REQUEST_ID",
    "orderId": "ORDER_ID_TO_CANCEL"
  }
]

Respuesta

{
  "requestID": "YOUR_REQUEST_ID",
  "data": [
    {
      "success": true,
      "orderID": "67f45377c18c6697c172afa4",
      "odds": -110,
      "filled": 0,
      "offered": 0,
      "remaining": 100,
      "side": "5c12bc1ce0daba000f47ba8b",
      "number": -3.5,
      "gameID": "688c0516fbc14da0c202d426",
      "userReference": "client-ref-001",
      "description": "Dallas Mavericks +3.5"
    }
  ]
}

Cancelar varias

Cancela un conjunto concreto de órdenes por ID.

Solicitud

[
  "cancelMultiple",
  {
    "requestID": "YOUR_REQUEST_ID",
    "orderIDs": [
      "ORDER_ID_1",
      "ORDER_ID_2",
      "ORDER_ID_3"
    ]
  }
]

Respuesta

data contiene una entrada por ID de orden; comprueba cada indicador success.

{
  "requestID": "YOUR_REQUEST_ID",
  "data": [
    {
      "success": true,
      "orderID": "ORDER_ID_1",
      "odds": -110,
      "filled": 0,
      "offered": 0,
      "remaining": 100,
      "side": "5c12bc1ce0daba000f47ba8b",
      "number": -3.5,
      "gameID": "688c0516fbc14da0c202d426",
      "userReference": "",
      "description": "Dallas Mavericks +3.5"
    },
    {
      "success": false,
      "orderID": "ORDER_ID_2",
      "description": "order already cancelled"
    }
  ]
}

Cancelar todas por juego

Cancela todas las órdenes abiertas que tengas en un solo juego. Opcionalmente restringe la cancelación a un mercado concreto pasando type, side y/o market.

Solicitud

[
  "cancelAllByGame",
  {
    "requestID": "YOUR_REQUEST_ID",
    "gameId": "GAME_ID_TO_CANCEL",
    "type": "spread",
    "side": "5c12bc1ce0daba000f47ba8b",
    "market": "main"
  }
]

string

requerido

Juego cuyas órdenes deben cancelarse.

string

Opcional — filtra a un solo tipo de mercado: moneyline, spread, total o moneyline1x2.

string

Opcional — ID de participante (moneyline/spread) o over/under (totales).

string

Opcional — identificador de mercado (p. ej. main).

Respuesta

{
  "requestID": "YOUR_REQUEST_ID",
  "data": [
    {
      "success": true,
      "orderID": "67f45377c18c6697c172afa4",
      "odds": -110,
      "filled": 0,
      "offered": 0,
      "remaining": 100,
      "side": "5c12bc1ce0daba000f47ba8b",
      "number": -3.5,
      "gameID": "688c0516fbc14da0c202d426",
      "userReference": "",
      "description": "Dallas Mavericks +3.5"
    }
  ]
}

Cancelar todas

Cancela todas las órdenes abiertas de la cuenta.

Solicitud

[
  "cancelAll",
  {
    "requestID": "YOUR_REQUEST_ID"
  }
]

Respuesta

{
  "requestID": "YOUR_REQUEST_ID",
  "data": [
    {
      "success": true,
      "orderID": "67f45377c18c6697c172afa4",
      "odds": -110,
      "filled": 0,
      "offered": 0,
      "remaining": 100,
      "side": "5c12bc1ce0daba000f47ba8b",
      "number": -3.5,
      "gameID": "688c0516fbc14da0c202d426",
      "userReference": "",
      "description": "Dallas Mavericks +3.5"
    }
  ]
}

Errores

Cuando no se puede procesar una cancelación, el servidor responde con el envoltorio de error estándar (sin campo data):

{
  "requestID": "YOUR_REQUEST_ID",
  "error": "order not found"
}

Valores habituales de error:

Error	Cuándo
`invalid order ID format`	El `orderId` de `cancelById` no es un ObjectID válido.
`order not found`	El ID de orden no existe.
`unauthorized: order does not belong to user`	Estás intentando cancelar la orden de otro usuario.
`order already cancelled`	La orden ya estaba cancelada.
`order is expired`	La orden caducó antes de que llegara la cancelación.
`order already graded`	La orden ya fue liquidada.
`game not found`	El juego referenciado no está en la caché.
`Failed to process cancelMultiple`	Error inesperado al procesar un lote de `cancelMultiple`.
`Failed to process cancelAll`	Error inesperado al procesar `cancelAll`.
`Failed to process cancelAllByGame`	Error inesperado al procesar `cancelAllByGame`.

En cancelaciones por lote (cancelMultiple, cancelAllByGame, cancelAll) los fallos por orden aparecen en data con success: false y un description que explica el motivo; solo un error a nivel de envoltorio indica que falló toda la solicitud.

​Payload de respuesta de cancelación

​Cancelar por ID

​Solicitud

​Respuesta

​Cancelar varias

​Solicitud

​Respuesta

​Cancelar todas por juego

​Solicitud

​Respuesta

​Cancelar todas

​Solicitud

​Respuesta

​Errores

Payload de respuesta de cancelación

Cancelar por ID

Solicitud

Respuesta

Cancelar varias

Solicitud

Respuesta

Cancelar todas por juego

Solicitud

Respuesta

Cancelar todas

Solicitud

Respuesta

Errores