> ## Documentation Index
> Fetch the complete documentation index at: https://orderly.network/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Batch create order

> **Limit: 1 request per 1 second**

`POST /v1/batch-order`

Creates a batch of orders as a list according to the same rules as a single Create Order.

Parameters for each order within the batch will be the same as the create single order. The batch of orders should be sent as a JSON array containing all the orders. The maximum number of orders that can be sent in 1 batch order request is 10. Each order within the batch order request is counted as 1 order towards the overall create order rate limit.



Note: This endpoint requires `trading` scope in orderly key.



## OpenAPI

````yaml orderly.openapi post /v1/batch-order
openapi: 3.0.1
info:
  title: EVM
  description: ''
  version: 1.0.0
servers:
  - url: https://api.orderly.org
    description: Mainnet
  - url: https://testnet-api.orderly.org
    description: Testnet
security: []
tags:
  - name: public
  - name: private
paths:
  /v1/batch-order:
    post:
      tags:
        - private
      summary: Batch create order
      description: >-
        **Limit: 1 request per 1 second**


        `POST /v1/batch-order`


        Creates a batch of orders as a list according to the same rules as a
        single Create Order.


        Parameters for each order within the batch will be the same as the
        create single order. The batch of orders should be sent as a JSON array
        containing all the orders. The maximum number of orders that can be sent
        in 1 batch order request is 10. Each order within the batch order
        request is counted as 1 order towards the overall create order rate
        limit.




        Note: This endpoint requires `trading` scope in orderly key.
      parameters:
        - $ref: '#/components/parameters/orderly_timestamp'
        - $ref: '#/components/parameters/orderly_account_id'
        - $ref: '#/components/parameters/orderly_key'
        - $ref: '#/components/parameters/orderly_signature'
        - $ref: '#/components/parameters/recv_window_header'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                orders:
                  type: array
                  items:
                    $ref: '#/components/schemas/BatchCreateOrderBody'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchOrderResponse'
      deprecated: false
components:
  parameters:
    orderly_timestamp:
      name: orderly-timestamp
      in: header
      description: Timestamp of the signed request in milliseconds.
      required: true
      style: simple
      explode: false
      schema:
        type: string
      example: '1649920583000'
    orderly_account_id:
      name: orderly-account-id
      in: header
      description: Account ID of the authenticated account.
      required: true
      style: simple
      explode: false
      schema:
        type: string
      example: 6.858456565150415e+75
    orderly_key:
      name: orderly-key
      in: header
      description: Public orderly key used to sign the request.
      required: true
      style: simple
      explode: false
      schema:
        type: string
      example: ed25519:8tm7dnKYkSc3FzgPuJaw1wztr79eeZpN35nHW5pL5XhX
    orderly_signature:
      name: orderly-signature
      in: header
      description: Signature of the request payload generated with the orderly key.
      required: true
      style: simple
      explode: false
      schema:
        type: string
      example: >-
        dG4bkKiqG0dUYLzViRZkvbI6Sy239JxAdNMIBxFZ4w030Jofr0ORV06GHtvXZkaZaWUXE+XAU3fnzKN/5fDeBQ==
    recv_window_header:
      name: x-recv-window
      in: header
      description: >-
        Use this parameter to control the timeout threshold for placing order,
        unit in miliseconds
      required: false
      schema:
        type: number
      example: 20
  schemas:
    BatchCreateOrderBody:
      required:
        - order_type
        - side
        - symbol
      type: object
      properties:
        symbol:
          type: string
        client_order_id:
          type: string
        order_type:
          type: string
        order_price:
          type: number
        order_quantity:
          type: number
        order_amount:
          type: number
        visible_quantity:
          type: number
        side:
          type: string
        order_tag:
          type: string
          description: >
            Optional tag for the order. Supports two formats:

            - Referral code: plain string (e.g., `REFERRAL2026`) - overrides
            referral relationship

            - Order tag fee config: `enum:<enum_id>` (e.g., `enum:STRATEGY_DCA`)
            - adds fee on top of existing fees, preserves referral

            Max length: 36 characters. Cannot be modified after order placement.
        margin_mode:
          type: string
          description: >-
            Margin mode for the order. Default: the symbol's current default
            margin mode.
          enum:
            - CROSS
            - ISOLATED
    BatchOrderResponse:
      allOf:
        - $ref: '#/components/schemas/BasicResponse'
        - type: object
          required:
            - data
          properties:
            data:
              type: object
              required:
                - rows
              properties:
                rows:
                  type: array
                  items:
                    $ref: '#/components/schemas/CreatedOrder'
    BasicResponse:
      required:
        - success
      type: object
      properties:
        success:
          description: Indicates whether the request was successful.
          type: boolean
          example: true
        timestamp:
          description: Server timestamp in milliseconds.
          type: integer
          example: 1702989203989
    CreatedOrder:
      type: object
      properties:
        order_id:
          type: number
          example: 13
        client_order_id:
          type: string
          example: testclientid
        order_type:
          type: string
          example: LIMIT
        order_price:
          type: number
          example: 100.12
        order_quantity:
          type: number
          example: 0.987654
        error_message:
          type: string
          example: none

````