> ## 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.

# User order history

> User's order history (filled, cancelled, rejected orders)



## AsyncAPI

````yaml api-reference/asyncapi.json userOrderHistory
id: userOrderHistory
title: User order history
description: User's order history (filled, cancelled, rejected orders)
servers:
  - id: testnet
    protocol: wss
    host: api.testnet.aptoslabs.com/decibel/ws
    bindings: []
    variables: []
address: user_order_history:{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_0
    id: receiveuserOrderHistory
    title: Receiveuser order history
    description: >-
      Receive updates for user's order history (filled, cancelled, rejected
      orders)
    type: receive
    messages:
      - &ref_1
        id: UserOrderHistoryMessage
        payload:
          - name: UserOrderHistoryMessage
            description: User's order history (filled, cancelled, rejected orders)
            type: object
            properties:
              - name: orders
                type: array
                required: true
              - name: topic
                type: string
                required: true
        headers: []
        jsonPayloadSchema:
          type: object
          required:
            - topic
            - orders
          properties:
            orders:
              type: array
              items:
                type: object
                required:
                  - parent
                  - market
                  - client_order_id
                  - order_id
                  - status
                  - order_type
                  - trigger_condition
                  - order_direction
                  - is_buy
                  - is_reduce_only
                  - details
                  - transaction_version
                  - unix_ms
                properties:
                  client_order_id:
                    type: string
                    x-parser-schema-id: <anonymous-schema-3>
                  details:
                    type: string
                    x-parser-schema-id: <anonymous-schema-4>
                  is_buy:
                    type: boolean
                    x-parser-schema-id: <anonymous-schema-5>
                  is_reduce_only:
                    type: boolean
                    x-parser-schema-id: <anonymous-schema-6>
                  market:
                    type: string
                    x-parser-schema-id: <anonymous-schema-7>
                  order_direction:
                    type: string
                    x-parser-schema-id: <anonymous-schema-8>
                  order_id:
                    type: string
                    x-parser-schema-id: <anonymous-schema-9>
                  order_type:
                    type: string
                    x-parser-schema-id: <anonymous-schema-10>
                  orig_size:
                    type:
                      - number
                      - 'null'
                    format: double
                    x-parser-schema-id: <anonymous-schema-11>
                  parent:
                    type: string
                    x-parser-schema-id: <anonymous-schema-12>
                  price:
                    type:
                      - number
                      - 'null'
                    format: double
                    x-parser-schema-id: <anonymous-schema-13>
                  remaining_size:
                    type:
                      - number
                      - 'null'
                    format: double
                    x-parser-schema-id: <anonymous-schema-14>
                  size_delta:
                    type:
                      - number
                      - 'null'
                    format: double
                    x-parser-schema-id: <anonymous-schema-15>
                  sl_limit_price:
                    type:
                      - integer
                      - 'null'
                    format: int64
                    minimum: 0
                    x-parser-schema-id: <anonymous-schema-16>
                  sl_order_id:
                    type:
                      - string
                      - 'null'
                    x-parser-schema-id: <anonymous-schema-17>
                  sl_trigger_price:
                    type:
                      - integer
                      - 'null'
                    format: int64
                    minimum: 0
                    x-parser-schema-id: <anonymous-schema-18>
                  status:
                    type: string
                    x-parser-schema-id: <anonymous-schema-19>
                  tp_limit_price:
                    type:
                      - integer
                      - 'null'
                    format: int64
                    minimum: 0
                    x-parser-schema-id: <anonymous-schema-20>
                  tp_order_id:
                    type:
                      - string
                      - 'null'
                    x-parser-schema-id: <anonymous-schema-21>
                  tp_trigger_price:
                    type:
                      - integer
                      - 'null'
                    format: int64
                    minimum: 0
                    x-parser-schema-id: <anonymous-schema-22>
                  transaction_version:
                    type: integer
                    format: int64
                    minimum: 0
                    x-parser-schema-id: <anonymous-schema-23>
                  trigger_condition:
                    type: string
                    x-parser-schema-id: <anonymous-schema-24>
                  unix_ms:
                    type: integer
                    format: int64
                    minimum: 0
                    x-parser-schema-id: <anonymous-schema-25>
                x-parser-schema-id: OrderDto
              x-parser-schema-id: <anonymous-schema-87>
            topic:
              type: string
              x-parser-schema-id: <anonymous-schema-88>
          x-parser-schema-id: UserOrderHistoryResponse
        title: User order history message
        description: User's order history (filled, cancelled, rejected orders)
        example: |-
          {
            "topic": "user_order_history:0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
            "orders": [
              {
                "parent": "0x0000000000000000000000000000000000000000000000000000000000000000",
                "market": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
                "client_order_id": "historical_order_456",
                "order_id": "45679",
                "status": "Filled",
                "order_type": "Market",
                "trigger_condition": "None",
                "order_direction": "Close Short",
                "orig_size": 2,
                "remaining_size": 0,
                "size_delta": null,
                "price": 49500,
                "is_buy": false,
                "is_reduce_only": false,
                "details": "",
                "tp_order_id": null,
                "tp_trigger_price": null,
                "tp_limit_price": null,
                "sl_order_id": null,
                "sl_trigger_price": null,
                "sl_limit_price": null,
                "transaction_version": 12345680,
                "unix_ms": 1699565000000
              }
            ]
          }
        bindings: []
        extensions:
          - id: x-parser-unique-object-id
            value: UserOrderHistoryMessage
          - id: x-parser-message-name
            value: UserOrderHistoryMessage
    bindings: []
    extensions:
      - id: x-parser-unique-object-id
        value: userOrderHistory
sendOperations:
  - *ref_0
receiveOperations: []
sendMessages:
  - *ref_1
receiveMessages: []
extensions:
  - id: x-parser-unique-object-id
    value: userOrderHistory
securitySchemes: []

````