Batch update orders

Update multiple open limit orders in a single API call. Each update cancels the existing open order and creates a replacement with the updated fields, so all order-book validations run normally. Partial failures do not block successful updates in the same batch.

Endpoint

POST https://api.futuur.com/v2.0/orders/batch-update/

Authentication

This endpoint requires HMAC authentication. Include the Key, Timestamp, and HMAC headers on every request. See the authentication guide for signing instructions.

Headers

string

Optional. A unique value chosen by the client for a logical operation. Replaying the same POST with the same key and the same JSON body returns the stored response without applying duplicate updates. A different body produces a new fingerprint, so requoting is not blocked.

Request

object[]

required

An array of 1 to 20 update objects. Each entry must include the id of an open order plus the fields to change.

Show update properties

integer

required

ID of the open limit order to update.

string

Updated number of shares. Submitted as a decimal string.

string

Updated limit price between 0 and 1. Submitted as a decimal string.

string | null

Updated ISO 8601 expiration datetime. Use null to remove expiration.

Response

Returns 200 OK with one result per submitted update, in the same order as the request.

integer

required

Zero-based position of this update in the request payload.

integer

The original order ID that was submitted for update.

boolean

required

true if the order was updated.

object

Replacement limit order. Present when success is true. See List orders for the LimitOrder field reference.

any

Validation error for this update. Present when success is false. May be a string or an object describing field-level issues.

Example

curl --request POST \
  --url "https://api.futuur.com/v2.0/orders/batch-update/" \
  --header "Key: YOUR_PUBLIC_KEY" \
  --header "Timestamp: 1712500000" \
  --header "HMAC: YOUR_HMAC_SIGNATURE" \
  --header "Idempotency-Key: 5b1f0c0a-0b9f-4d3a-9f8c-1d2b3a4e5f60" \
  --header "Content-Type: application/json" \
  --data '{
    "orders": [
      {
        "id": 100,
        "shares": "12",
        "price": "0.48"
      },
      {
        "id": 101,
        "expired_at": null
      }
    ]
  }'

Sample response (200 OK)

[
  {
    "index": 0,
    "order_id": 100,
    "success": true,
    "order": {
      "id": 10550,
      "event": "873",
      "market": "2231",
      "price": 0.48,
      "shares": 12.0,
      "shares_requested": 12.0,
      "shares_filled": "0.0",
      "currency": "OOM",
      "side": "bid",
      "position": "long",
      "expired_at": null,
      "status": "open",
      "created": "2026-06-25T12:00:00Z"
    }
  },
  {
    "index": 1,
    "order_id": 101,
    "success": false,
    "errors": "Order is being processed."
  }
]

To create new orders instead of updating existing ones, use Batch create orders.

Events

Markets

Orders

Wagers

Account

Realtime (websockets)

Endpoint

Authentication

Headers

Request

Response

Example

​Endpoint

​Authentication

​Headers

​Request

​Response

​Example

Endpoint

Authentication

Headers

Request

Response

Example