Place order batch
Submit multiple orders (maximum 1024) at once to be processed in a batch. This operation does not make guarantees about the successful execution of all orders, it only places each in the matching engine queue.
We book every order or none. We price each order on its own, not the batch total. We refuse the batch when your balance cannot cover its largest order by itself. The batch total may exceed your balance. Each order still needs collateral when it reaches the book, so we can reject an order after we book it.
201: we booked every order.422: we booked no order. A balance refusal setscodetoINSUFFICIENT_BALANCE. Itserrorslist each order your balance cannot cover on its own.indexis the order’s position in your request, counting from zero.
Your order-volume budget is charged for the orders you send, not for the orders we book.
Rate limit: 64 requests per second.
Body
The server-generated UUID of the outcome for which the order will increase exposure
"123e4567-e89b-12d3-a456-426614174000"
The price of the order in decimal probability, up to 3 decimal places
0.667
The number of minimal currency units for the order. Note that this must be a positive integer. For CASH orders, 1 unit = 0.01 Novig Cash (e.g., 100 units = 1.00 Cash). For COIN orders, 1 unit = 1 Novig Coin
110
Denomination of the order, i.e. CASH or COIN
"CASH"
GTC, GTT, IOC, FOK, or PO (default is GTC). PO (post only) rejects the order instead of matching it immediately as a taker, so it only ever rests as a maker order.
"GTC"
Time to live for the order (milliseconds) after which the order will be automatically canceled if not totally filled. Required under GTT time-in-force; optional under PO, where it self-expires if provided and otherwise rests until canceled
2400
Custom 8-character string field for storing trader-specified flags or metadata about the order
8"ABC12345"
Response
We booked every order.
The unique identifier of the order
"123e4567-e89b-12d3-a456-426614174002"
The ID of the outcome associated with this order
"123e4567-e89b-12d3-a456-426614174000"
The ID of the market associated with this order
"123e4567-e89b-12d3-a456-426614174003"
The limit price at which the order is placed
0.125
The remaining quantity of the order, denominated in Minimum Currency Units
4200
The original quantity of the order, denominated in Minimum Currency Units
4200
The currency in which the order is denominated
"COIN"
The timestamp when the order was placed
"2023-10-05T12:00:00Z"
The current status of the order
"FILLED"
The trader-specified metadata associated with the order
"ABC12345"