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

# Submit multiple signed orders

> Submits between 1 and 50 EIP-712 signed orders for one market in a single request. Orders are processed sequentially in request order and each order can be accepted or rejected independently. Check every item in `results`; the batch is not atomic. SIWE login is optional, but every order must have a valid signature.



## OpenAPI

````yaml /api-spec/openapi.yaml post /markets/{id}/orders/batch
openapi: 3.0.3
info:
  title: United Market API
  version: 1.0.0
  description: >-
    Public backend API for market data, trading, authentication, profiles,
    comments, and leaderboards.
servers:
  - url: https://api.unitedmarket.ai
    description: United Market backend
security: []
tags:
  - name: Markets
    description: >-
      Market discovery, market details, orderbooks, tickers, price history, and
      trades.
  - name: Orders
    description: Signed order submission, cancellation, order lookup, and balances.
  - name: Authentication
    description: SIWE wallet authentication.
  - name: Discovery
    description: Tags and market groups.
  - name: Social
    description: Comments, users, and leaderboard data.
  - name: Fees
    description: Effective trading fee rate per market.
  - name: Referral
    description: Referral codes, attribution, and reward summaries.
paths:
  /markets/{id}/orders/batch:
    post:
      tags:
        - Orders
      summary: Submit multiple signed orders
      description: >-
        Submits between 1 and 50 EIP-712 signed orders for one market in a
        single request. Orders are processed sequentially in request order and
        each order can be accepted or rejected independently. Check every item
        in `results`; the batch is not atomic. SIWE login is optional, but every
        order must have a valid signature.
      operationId: submitMarketOrdersBatch
      parameters:
        - $ref: '#/components/parameters/MarketId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BatchSubmitOrderRequest'
      responses:
        '200':
          description: Batch processed; individual results may include rejections.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchSubmitOrderResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
      security: []
components:
  parameters:
    MarketId:
      name: id
      in: path
      required: true
      schema:
        type: string
      description: Market id.
  schemas:
    BatchSubmitOrderRequest:
      type: object
      required:
        - orders
      properties:
        orders:
          type: array
          minItems: 1
          maxItems: 50
          description: Signed orders for the market identified in the URL.
          items:
            $ref: '#/components/schemas/SubmitOrderRequest'
    BatchSubmitOrderResponse:
      type: object
      required:
        - accepted
        - rejected
        - results
      properties:
        accepted:
          type: integer
          minimum: 0
          description: Number of accepted orders.
        rejected:
          type: integer
          minimum: 0
          description: Number of rejected orders.
        results:
          type: array
          description: Per-order results in the same order as the request.
          items:
            oneOf:
              - $ref: '#/components/schemas/BatchSubmitOrderSuccess'
              - $ref: '#/components/schemas/BatchSubmitOrderFailure'
    SubmitOrderRequest:
      type: object
      required:
        - order
      properties:
        orderType:
          type: string
          enum:
            - GTC
            - IOC
            - FOK
            - POST_ONLY
            - MARKET
          default: GTC
        order:
          $ref: '#/components/schemas/SignedOrder'
    BatchSubmitOrderSuccess:
      type: object
      required:
        - ok
        - orderHash
        - status
        - orderType
        - matches
      properties:
        ok:
          type: boolean
          enum:
            - true
        orderHash:
          type: string
          example: '0x0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef'
        status:
          type: string
        orderType:
          type: string
          enum:
            - GTC
            - IOC
            - FOK
            - POST_ONLY
            - MARKET
        matches:
          type: array
          items:
            type: object
            additionalProperties: true
    BatchSubmitOrderFailure:
      type: object
      required:
        - ok
        - statusCode
        - error
        - orderHash
      properties:
        ok:
          type: boolean
          enum:
            - false
        statusCode:
          type: integer
        error:
          type: string
        orderHash:
          type: string
          nullable: true
    Error:
      type: object
      properties:
        message:
          type: string
        statusCode:
          type: integer
    SignedOrder:
      type: object
      required:
        - salt
        - maker
        - signer
        - taker
        - tokenId
        - makerAmount
        - takerAmount
        - expiration
        - nonce
        - feeRateBps
        - side
        - signatureType
        - signature
      properties:
        salt:
          type: string
        maker:
          type: string
        signer:
          type: string
        taker:
          type: string
          example: '0x0000000000000000000000000000000000000000'
        tokenId:
          type: string
        makerAmount:
          type: string
        takerAmount:
          type: string
        expiration:
          type: string
          example: '0'
        nonce:
          type: string
        feeRateBps:
          type: string
          description: >-
            Fee rate in basis points, signed into the order. Must be at least
            the market's effective rate from GET /markets/{id}/fee (markets with
            a 0 rate accept 0). Maximum 1000 (10%). Orders signing less than the
            required rate are rejected.
          example: '15'
        side:
          type: integer
          enum:
            - 0
            - 1
          description: 0 = BUY, 1 = SELL
        signatureType:
          type: integer
          enum:
            - 0
            - 1
            - 2
            - 3
        signature:
          type: string
  responses:
    BadRequest:
      description: Invalid request.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'

````