Orders

Create bulk orders

Creates multiple orders in a single request, up to 1000. Note that a successful call to this endpoint does not necessarily mean your orders have been accepted, e.g. a downstream venue might reject your order. You should therefore utilize our WebSocket APIs to listen for changes in order lifecycle events.

The response will contain an array of objects, indicating whether your order was submitted. If the order was submitted, the order_id field will be populated with the order ID assigned to this order. If the order was rejected, the reason field will be populated with the reason for rejection. The data array returned in the response object is guaranteed to be ordered in the same order as the orders you provided in the request. Again, note that even if your order was submitted, that doesn't mean it was accepted, and may still be rejected by downstream venues.

post/accounts/{account_id}/bulk-orders

Path parameters

account_idstring required

Account ID for the account.

Example:100000

Request body

Example request

{
  "orders": [
    {
      "reference_id": "my-order-id-123",
      "quantity": "100",
      "price": "123.99",
      "stop_price": "123.99",
      "symbol": "AAPL",
      "strategy": {
        "min_percent": 1,
        "max_percent": 35
      }
    }
  ]
}

Response

Orders received. Indicates the orders were received and are pending further processing.

submittedinteger required

Total number of orders submitted

rejectedinteger required

Total number of orders rejected

Example response

{
  "data": [
    {
      "order_id": "12390213"
    }
  ]
}

Changes

Changed in 10 of the 22 revisions of this API.28930

Mar 3, 202605b4df42c05622See the full diff
- ▲
  request property // was restricted to a list of enum values
  request-property-became-enum
- ▲
  the // request property type changed from no type to string
  request-property-type-changed
- ○
  added the new close enum value to the request property //
  request-property-enum-value-added
- ○
  added the new open enum value to the request property //
  request-property-enum-value-added
Mar 3, 20269deaa48a0d683See the full diff
- ▲
  removed the enum value close of the request property //
  request-property-enum-value-removed
- ▲
  removed the enum value open of the request property //
  request-property-enum-value-removed
- ▲
  the // request property type changed from string to no type
  request-property-type-changed
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Mar 3, 202605b4df42c0561See the full diff
- ○
  added the new optional request property //
  new-optional-request-property
Feb 26, 202521ec6316c7346See the full diff
- ○
  added the new ap enum value to the request property ///////
  request-property-enum-value-added
- ○
  added the new dark enum value to the request property ///////
  request-property-enum-value-added
- ○
  added the new pov enum value to the request property ///////
  request-property-enum-value-added
- ○
  added the new sor enum value to the request property ///////
  request-property-enum-value-added
- ○
  added the new twap enum value to the request property ///////
  request-property-enum-value-added
- ○
  added the new vwap enum value to the request property ///////
  request-property-enum-value-added
Feb 24, 2025d8047ed6956911See the full diff
- ▲
  removed from the // request property oneOf list
  request-property-one-of-removed
- ○
  added to the // request property anyOf list
  request-property-any-of-added
Feb 20, 2025b9727888407f118See the full diff
- ▲
  added subschema #2 to the ////// request property allOf list
  request-property-all-of-added
- ▲
  added subschema #2 to the ////// request property allOf list
  request-property-all-of-added
- ▲
  added subschema #2 to the ////// request property allOf list
  request-property-all-of-added
- ▲
  added subschema #2 to the ////// request property allOf list
  request-property-all-of-added
- ▲
  added subschema #2 to the ////// request property allOf list
  request-property-all-of-added
- ▲
  removed the enum value ap of the request property ///////
  request-property-enum-value-removed
- ▲
  removed the enum value dark of the request property ///////
  request-property-enum-value-removed
- ▲
  removed the enum value pov of the request property ///////
  request-property-enum-value-removed
- ▲
  removed the enum value sor of the request property ///////
  request-property-enum-value-removed
- ▲
  removed the enum value twap of the request property ///////
  request-property-enum-value-removed
- ▲
  removed the enum value vwap of the request property ///////
  request-property-enum-value-removed
- ●
  removed the request property ///////
  request-property-removed
- ●
  removed the request property ///////
  request-property-removed
- ●
  removed the request property ///////
  request-property-removed
- ●
  removed the request property ///////
  request-property-removed
- ●
  removed the request property ///////
  request-property-removed
- ●
  removed the request property ///////
  request-property-removed
- ●
  removed the request property ///////
  request-property-removed
- ●
  removed the request property ///////
  request-property-removed
Oct 11, 2024468b5da24bbf3See the full diff
- ▲
  removed the enum value gotc of the request property ///////
  request-property-enum-value-removed
- ▲
  removed the enum value xchi of the request property ///////
  request-property-enum-value-removed
- ▲
  removed the enum value xphl of the request property ///////
  request-property-enum-value-removed
Oct 4, 2024414d28e743999See the full diff
- ○
  added dma discriminator mapping keys to the // request property
  request-property-discriminator-mapping-added
- ○
  added the new dma enum value to the request property ///////////
  request-property-enum-value-added
- ○
  added the new dma enum value to the request property ///////////
  request-property-enum-value-added
- ○
  added the new dma enum value to the request property ///////////
  request-property-enum-value-added
- ○
  added the new dma enum value to the request property ///////////
  request-property-enum-value-added
- ○
  added the new dma enum value to the request property ///////////
  request-property-enum-value-added
- ○
  added the new dma enum value to the request property ///////////
  request-property-enum-value-added
- ○
  added the new stop-limit enum value to the request property //
  request-property-enum-value-added
- ○
  added to the // request property oneOf list
  request-property-one-of-added
Sep 5, 2024dc777b93c0ed88See the full diff
- ▲
  the /////// request property type changed from number to integer
  request-property-type-changed
- ▲
  the /////// request property type changed from number to integer
  request-property-type-changed
- ▲
  the /////// request property type changed from number to integer
  request-property-type-changed
- ▲
  the /////// request property type changed from number to integer
  request-property-type-changed
- ▲
  the /////// request property type changed from number to integer
  request-property-type-changed
- ▲
  the /////// request property type changed from number to integer
  request-property-type-changed
- ▲
  the /////// request property type changed from number to integer
  request-property-type-changed
- ▲
  the /////// request property type changed from number to integer
  request-property-type-changed
- ○
  the /////// request property's max was increased from 1.00 to 100.00
  request-property-max-increased
- ○
  the /////// request property's max was increased from 1.00 to 100.00
  request-property-max-increased
- ○
  the /////// request property's max was increased from 1.00 to 100.00
  request-property-max-increased
- ○
  the /////// request property's max was increased from 1.00 to 100.00
  request-property-max-increased
- ○
  the /////// request property's max was increased from 0.50 to 50.00
  request-property-max-increased
- ○
  the /////// request property's max was increased from 1.00 to 100.00
  request-property-max-increased
- ○
  the /////// request property's max was increased from 1.00 to 50.00
  request-property-max-increased
- ○
  the /////// request property's max was increased from 1.00 to 100.00
  request-property-max-increased
Aug 27, 2024cac25d6221de13See the full diff
- ●
  removed the request property //
  request-property-removed
- ○
  added the new optional request property //
  new-optional-request-property
- ○
  added the new optional request property //
  new-optional-request-property
- ○
  added the new stop enum value to the request property //
  request-property-enum-value-added

Full history