cURL Example

curl -X DELETE "localhost:80/nbx/v2/emm/orders/batch" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '[
    "550e8400-e29b-41d4-a716-446655440001",
    "550e8400-e29b-41d4-a716-446655440002",
    "550e8400-e29b-41d4-a716-446655440003"
]'

{
  "canceled": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174002",
      "outcomeId": "123e4567-e89b-12d3-a456-426614174000",
      "marketId": "123e4567-e89b-12d3-a456-426614174003",
      "price": 0.125,
      "qty": 4200,
      "originalQty": 4200,
      "currency": "COIN",
      "timestamp": "2023-10-05T12:00:00Z",
      "status": "FILLED",
      "flags": "ABC12345"
    }
  ],
  "notCanceled": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174002",
      "reason": "FILLED"
    }
  ]
}

{
  "canceled": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174002",
      "outcomeId": "123e4567-e89b-12d3-a456-426614174000",
      "marketId": "123e4567-e89b-12d3-a456-426614174003",
      "price": 0.125,
      "qty": 4200,
      "originalQty": 4200,
      "currency": "COIN",
      "timestamp": "2023-10-05T12:00:00Z",
      "status": "FILLED",
      "flags": "ABC12345"
    }
  ],
  "notCanceled": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174002",
      "reason": "FILLED"
    }
  ]
}

{
  "canceled": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174002",
      "outcomeId": "123e4567-e89b-12d3-a456-426614174000",
      "marketId": "123e4567-e89b-12d3-a456-426614174003",
      "price": 0.125,
      "qty": 4200,
      "originalQty": 4200,
      "currency": "COIN",
      "timestamp": "2023-10-05T12:00:00Z",
      "status": "FILLED",
      "flags": "ABC12345"
    }
  ],
  "notCanceled": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174002",
      "reason": "FILLED"
    }
  ]
}

Cancel order batch

Cancel up to 1024 orders by ID. Each order must belong to the trader associated with the API key.

We cancel every resting order in the request. The status code summarizes the batch:

200: we sent a cancel for every ID.
207: we found every ID. Some orders were already filled, cancelled, or rejected. notCanceled lists them with that status.
404: at least one ID does not match an order of yours. notCanceled lists it with reason NOT_FOUND.

A new order reads as NOT_FOUND until its place event arrives on your private WebSocket channel. Wait for that event, then cancel again.

This operation is idempotent. It does not guarantee that the cancel reaches the matching engine before a fill. To confirm a cancel, consume the matching tape and rebuild the order book from it.

Note: An entry under canceled means we sent the cancel. It does not mean the order is cancelled.

Rate limit: 1024 requests per second.

DELETE

nbx

emm

orders

batch

cURL Example

curl -X DELETE "localhost:80/nbx/v2/emm/orders/batch" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '[
    "550e8400-e29b-41d4-a716-446655440001",
    "550e8400-e29b-41d4-a716-446655440002",
    "550e8400-e29b-41d4-a716-446655440003"
]'

{
  "canceled": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174002",
      "outcomeId": "123e4567-e89b-12d3-a456-426614174000",
      "marketId": "123e4567-e89b-12d3-a456-426614174003",
      "price": 0.125,
      "qty": 4200,
      "originalQty": 4200,
      "currency": "COIN",
      "timestamp": "2023-10-05T12:00:00Z",
      "status": "FILLED",
      "flags": "ABC12345"
    }
  ],
  "notCanceled": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174002",
      "reason": "FILLED"
    }
  ]
}

{
  "canceled": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174002",
      "outcomeId": "123e4567-e89b-12d3-a456-426614174000",
      "marketId": "123e4567-e89b-12d3-a456-426614174003",
      "price": 0.125,
      "qty": 4200,
      "originalQty": 4200,
      "currency": "COIN",
      "timestamp": "2023-10-05T12:00:00Z",
      "status": "FILLED",
      "flags": "ABC12345"
    }
  ],
  "notCanceled": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174002",
      "reason": "FILLED"
    }
  ]
}

{
  "canceled": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174002",
      "outcomeId": "123e4567-e89b-12d3-a456-426614174000",
      "marketId": "123e4567-e89b-12d3-a456-426614174003",
      "price": 0.125,
      "qty": 4200,
      "originalQty": 4200,
      "currency": "COIN",
      "timestamp": "2023-10-05T12:00:00Z",
      "status": "FILLED",
      "flags": "ABC12345"
    }
  ],
  "notCanceled": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174002",
      "reason": "FILLED"
    }
  ]
}

Body

application/json

The server-generated UUID of the order to be cancelled

Response

We sent a cancel for every order.

The result of a batch cancel. 200: we cancelled every order. 207: we skipped some orders, see notCanceled. 404: we did not find an ID.

canceled

object[]

required

The orders we sent a cancel for, in request order

Show child attributes

notCanceled

object[]

required

The IDs we sent no cancel for, in request order, each with a reason

Show child attributes

Introduction

Fees

REST Endpoints

Websocket

GraphQL

RFQs

Public Data

Cancel order batch

Body

Response