Skip to main content
Create multiple limit or market orders in a single API call. Each item in the orders array is validated and matched independently — partial failures do not block successful orders in the same batch. Use this endpoint to quote ladders, hedge positions, or rebalance across multiple markets without sending separate requests.

​
Endpoint

POST https://api.futuur.com/orders/batch/

​
Authentication

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

​
Headers

​
Idempotency-Key
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 creating duplicate orders. A different body produces a new fingerprint, so requoting is not blocked.

​
Request

​
orders
object[]
required
An array of 1 to 20 order objects. Each entry follows the same shape as Create order.

​
Response

Returns 200 OK with one result per submitted order, plus the IDs of any conflicting orders that were canceled to make room for them.
​
results
object[]
required
Per-order result, returned in the same order as the request.
​
cancelled_existing_order_ids
integer[]
required
IDs of existing open orders that were canceled because cancel_conflicting_orders was set on one or more items in the batch.

​
Example

curl --request POST \
  --url "https://api.futuur.com/orders/batch/" \
  --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": [
      {
        "event": 873,
        "market": 2231,
        "shares": "13",
        "currency": "OOM",
        "position": "long",
        "side": "bid",
        "price": "0.43"
      },
      {
        "event": 873,
        "market": 2231,
        "shares": "0.04",
        "currency": "OOM",
        "position": "short",
        "side": "bid",
        "price": "0.44"
      }
    ]
  }'
Sample response (200 OK)
{
  "results": [
    {
      "index": 0,
      "success": true,
      "order": {
        "id": 10501,
        "event": "873",
        "market": "2231",
        "price": 0.43,
        "shares": 13.0,
        "shares_requested": 13.0,
        "shares_filled": "0.0",
        "currency": "OOM",
        "side": "bid",
        "position": "long",
        "expired_at": null,
        "status": "open",
        "created": "2026-04-07T12:00:00Z"
      }
    },
    {
      "index": 1,
      "success": false,
      "errors": "InvalidShares"
    }
  ],
  "cancelled_existing_order_ids": []
}