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

# Bulk orders

> User's bulk orders (multi-order submissions)



## AsyncAPI

````yaml api-reference/asyncapi.json bulkOrders
id: bulkOrders
title: Bulk orders
description: User's bulk orders (multi-order submissions)
servers:
  - id: testnet
    protocol: wss
    host: api.testnet.aptoslabs.com/decibel/ws
    bindings: []
    variables: []
address: bulk_orders:{userAddr}
parameters:
  - id: userAddr
    jsonSchema:
      type: string
      description: User wallet address (Aptos address format, e.g. 0x123...)
    description: User wallet address (Aptos address format, e.g. 0x123...)
    type: string
    required: true
    deprecated: false
bindings: []
operations:
  - &ref_1
    id: receivebulkOrders
    title: Receivebulk orders
    description: Receive updates for user's bulk orders (multi-order submissions)
    type: receive
    messages:
      - &ref_2
        id: BulkOrdersMessage
        payload:
          - name: BulkOrdersMessage
            description: User's bulk orders (multi-order submissions)
            type: object
            properties:
              - name: bulk_order
                type: object
                required: true
                properties:
                  - name: bulk_order
                    type: object
                    required: false
                    properties:
                      - name: ask_prices
                        type: array
                        required: false
                      - name: ask_sizes
                        type: array
                        required: false
                      - name: bid_prices
                        type: array
                        required: false
                      - name: bid_sizes
                        type: array
                        required: false
                      - name: cancelled_ask_prices
                        type: array
                        required: false
                      - name: cancelled_ask_sizes
                        type: array
                        required: false
                      - name: cancelled_bid_prices
                        type: array
                        required: false
                      - name: cancelled_bid_sizes
                        type: array
                        required: false
                      - name: event_uid
                        type: string
                        description: >-
                          128-bit unsigned integer represented as a string
                          (event unique identifier)
                        required: false
                      - name: market
                        type: string
                        required: false
                      - name: previous_seq_num
                        type: &ref_0
                          - integer
                          - 'null'
                        required: false
                      - name: sequence_number
                        type: integer
                        required: false
                      - name: transaction_unix_ms
                        type: integer
                        required: false
                      - name: transaction_version
                        type: integer
                        required: false
                      - name: user
                        type: string
                        required: false
                  - name: details
                    type: string
                    required: false
                  - name: status
                    type: string
                    required: false
              - name: topic
                type: string
                required: true
        headers: []
        jsonPayloadSchema:
          type: object
          required:
            - topic
            - bulk_order
          properties:
            bulk_order:
              type: object
              required:
                - status
                - details
                - bulk_order
              properties:
                bulk_order:
                  type: object
                  required:
                    - market
                    - user
                    - sequence_number
                    - bid_prices
                    - bid_sizes
                    - ask_prices
                    - ask_sizes
                    - cancelled_bid_prices
                    - cancelled_bid_sizes
                    - cancelled_ask_prices
                    - cancelled_ask_sizes
                    - transaction_version
                    - transaction_unix_ms
                    - event_uid
                  properties:
                    ask_prices:
                      type: array
                      items:
                        type: number
                        format: double
                        x-parser-schema-id: <anonymous-schema-184>
                      example:
                        - 101
                        - 102
                        - 103
                      x-parser-schema-id: <anonymous-schema-183>
                    ask_sizes:
                      type: array
                      items:
                        type: number
                        format: double
                        x-parser-schema-id: <anonymous-schema-186>
                      example:
                        - 1
                        - 2
                        - 3
                      x-parser-schema-id: <anonymous-schema-185>
                    bid_prices:
                      type: array
                      items:
                        type: number
                        format: double
                        x-parser-schema-id: <anonymous-schema-188>
                      example:
                        - 99
                        - 98
                        - 97
                      x-parser-schema-id: <anonymous-schema-187>
                    bid_sizes:
                      type: array
                      items:
                        type: number
                        format: double
                        x-parser-schema-id: <anonymous-schema-190>
                      example:
                        - 1
                        - 2
                        - 3
                      x-parser-schema-id: <anonymous-schema-189>
                    cancelled_ask_prices:
                      type: array
                      items:
                        type: number
                        format: double
                        x-parser-schema-id: <anonymous-schema-192>
                      example: []
                      x-parser-schema-id: <anonymous-schema-191>
                    cancelled_ask_sizes:
                      type: array
                      items:
                        type: number
                        format: double
                        x-parser-schema-id: <anonymous-schema-194>
                      example: []
                      x-parser-schema-id: <anonymous-schema-193>
                    cancelled_bid_prices:
                      type: array
                      items:
                        type: number
                        format: double
                        x-parser-schema-id: <anonymous-schema-196>
                      example:
                        - 100
                      x-parser-schema-id: <anonymous-schema-195>
                    cancelled_bid_sizes:
                      type: array
                      items:
                        type: number
                        format: double
                        x-parser-schema-id: <anonymous-schema-198>
                      example:
                        - 1
                      x-parser-schema-id: <anonymous-schema-197>
                    event_uid:
                      type: string
                      description: >-
                        128-bit unsigned integer represented as a string (event
                        unique identifier)
                      pattern: ^[0-9]+$
                      x-parser-schema-id: u128
                    market:
                      type: string
                      example: 0xmarket123...
                      x-parser-schema-id: <anonymous-schema-199>
                    previous_seq_num:
                      type: *ref_0
                      format: int64
                      example: 12344
                      minimum: 0
                      x-parser-schema-id: <anonymous-schema-200>
                    sequence_number:
                      type: integer
                      format: int64
                      example: 12345
                      minimum: 0
                      x-parser-schema-id: <anonymous-schema-201>
                    transaction_unix_ms:
                      type: integer
                      format: int64
                      example: 1730841600000
                      x-parser-schema-id: <anonymous-schema-202>
                    transaction_version:
                      type: integer
                      format: int64
                      example: 12345
                      minimum: 0
                      x-parser-schema-id: <anonymous-schema-203>
                    user:
                      type: string
                      example: 0x123...
                      x-parser-schema-id: <anonymous-schema-204>
                  x-parser-schema-id: BulkOrderDto
                details:
                  type: string
                  x-parser-schema-id: <anonymous-schema-205>
                status:
                  type: string
                  x-parser-schema-id: <anonymous-schema-206>
              x-parser-schema-id: BulkOrderStatusResponse
            topic:
              type: string
              x-parser-schema-id: <anonymous-schema-207>
          x-parser-schema-id: BulkOrdersResponse
        title: Bulk orders message
        description: User's bulk orders (multi-order submissions)
        example: |-
          {
            "topic": "bulk_orders:0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
            "bulk_order": {
              "status": "Placed",
              "details": "",
              "bulk_order": {
                "market": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
                "user": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
                "sequence_number": 100,
                "previous_seq_num": 99,
                "bid_prices": [
                  50000,
                  49900
                ],
                "bid_sizes": [
                  1,
                  2
                ],
                "ask_prices": [
                  50100,
                  50200
                ],
                "ask_sizes": [
                  1.5,
                  2.5
                ],
                "cancelled_bid_prices": [],
                "cancelled_bid_sizes": [],
                "cancelled_ask_prices": [],
                "cancelled_ask_sizes": [],
                "transaction_version": 12345678,
                "transaction_unix_ms": 1699564800000,
                "event_uid": 1.2345678901234568e+35
              }
            }
          }
        bindings: []
        extensions:
          - id: x-parser-unique-object-id
            value: BulkOrdersMessage
          - id: x-parser-message-name
            value: BulkOrdersMessage
    bindings: []
    extensions:
      - id: x-parser-unique-object-id
        value: bulkOrders
sendOperations:
  - *ref_1
receiveOperations: []
sendMessages:
  - *ref_2
receiveMessages: []
extensions:
  - id: x-parser-unique-object-id
    value: bulkOrders
securitySchemes: []

````