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

# List Orders

> Returns the execution plan required to list orders on the exchange.



## OpenAPI

````yaml POST /v1/orders/list
openapi: 3.0.0
info:
  title: Lootex Plus API - V1
  description: V1 endpoints
  version: 0.0.1
  contact: {}
servers:
  - url: https://api.lootexplus.com
security: []
tags: []
paths:
  /v1/orders/list:
    post:
      tags:
        - V1
      summary: Get execution plan for listing orders
      description: Returns the execution plan required to list orders on the exchange.
      operationId: OrdersController_listOrders
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ListOrdersDto'
      responses:
        '200':
          description: Order listing execution plan
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExecutionDto'
              example:
                steps:
                  - id: approve-tokens
                    items:
                      - type: transaction
                        data:
                          to: '0x247369e90ef44b845865b3d2763c8857e9F27593'
                          data: >-
                            0xa22cb465000000000000000000000000a313d4f11e69a320a68167e7aafacea8f34135930000000000000000000000000000000000000000000000000000000000000001
                        token: '0x247369e90ef44b845865b3d2763c8857e9F27593'
                        identifierOrCriteria: '0'
                  - id: create-orders
                    needEncodeProofAndSignature: false
                    items:
                      - type: signTypedData
                        data:
                          domain:
                            name: Seaport
                            version: '1.6'
                            chainId: 1868
                            verifyingContract: '0xA313D4f11e69A320A68167E7aAfacEA8F3413593'
                          types:
                            OrderComponents:
                              - name: offerer
                                type: address
                              - name: zone
                                type: address
                              - name: offer
                                type: OfferItem[]
                              - name: consideration
                                type: ConsiderationItem[]
                              - name: orderType
                                type: uint8
                              - name: startTime
                                type: uint256
                              - name: endTime
                                type: uint256
                              - name: zoneHash
                                type: bytes32
                              - name: salt
                                type: uint256
                              - name: conduitKey
                                type: bytes32
                              - name: counter
                                type: uint256
                            OfferItem:
                              - name: itemType
                                type: uint8
                              - name: token
                                type: address
                              - name: identifierOrCriteria
                                type: uint256
                              - name: startAmount
                                type: uint256
                              - name: endAmount
                                type: uint256
                            ConsiderationItem:
                              - name: itemType
                                type: uint8
                              - name: token
                                type: address
                              - name: identifierOrCriteria
                                type: uint256
                              - name: startAmount
                                type: uint256
                              - name: endAmount
                                type: uint256
                              - name: recipient
                                type: address
                          message:
                            offerer: '0x7D878A527e86321aECd80A493E584117A907A0AB'
                            zone: '0x0000000000000000000000000000000000000000'
                            zoneHash: >-
                              0x0000000000000000000000000000000000000000000000000000000000000000
                            startTime: '1754901647'
                            endTime: '1754988047'
                            orderType: 1
                            offer:
                              - itemType: 2
                                token: '0x247369e90ef44b845865b3d2763c8857e9F27593'
                                identifierOrCriteria: '0'
                                startAmount: '1'
                                endAmount: '1'
                            consideration:
                              - itemType: 0
                                token: '0x0000000000000000000000000000000000000000'
                                identifierOrCriteria: '0'
                                startAmount: '980000000000000000'
                                endAmount: '980000000000000000'
                                recipient: '0x7D878A527e86321aECd80A493E584117A907A0AB'
                              - itemType: 0
                                token: '0x0000000000000000000000000000000000000000'
                                identifierOrCriteria: '0'
                                startAmount: '20000000000000000'
                                endAmount: '20000000000000000'
                                recipient: '0x44bC1E612e11d0Acd2c43218Ea55717aC28e3a40'
                            totalOriginalConsiderationItems: 2
                            salt: >-
                              0x000000000000000000000000000000000000000000000000b0d3d3058c34fef6
                            conduitKey: >-
                              0x0000000000000000000000000000000000000000000000000000000000000000
                            counter: '0'
                          primaryType: OrderComponents
                      - type: post
                        endpoint: /v1/orders
                        body:
                          data:
                            - offerer: '0x7D878A527e86321aECd80A493E584117A907A0AB'
                              zone: '0x0000000000000000000000000000000000000000'
                              zoneHash: >-
                                0x0000000000000000000000000000000000000000000000000000000000000000
                              startTime: '1754901647'
                              endTime: '1754988047'
                              orderType: 1
                              offer:
                                - itemType: 2
                                  token: '0x247369e90ef44b845865b3d2763c8857e9F27593'
                                  identifierOrCriteria: '0'
                                  startAmount: '1'
                                  endAmount: '1'
                              consideration:
                                - itemType: 0
                                  token: '0x0000000000000000000000000000000000000000'
                                  identifierOrCriteria: '0'
                                  startAmount: '980000000000000000'
                                  endAmount: '980000000000000000'
                                  recipient: '0x7D878A527e86321aECd80A493E584117A907A0AB'
                                - itemType: 0
                                  token: '0x0000000000000000000000000000000000000000'
                                  identifierOrCriteria: '0'
                                  startAmount: '20000000000000000'
                                  endAmount: '20000000000000000'
                                  recipient: '0x44bC1E612e11d0Acd2c43218Ea55717aC28e3a40'
                              totalOriginalConsiderationItems: 2
                              salt: >-
                                0x000000000000000000000000000000000000000000000000b0d3d3058c34fef6
                              conduitKey: >-
                                0x0000000000000000000000000000000000000000000000000000000000000000
                              counter: '0'
                              category: listing
                              exchangeAddress: '0xA313D4f11e69A320A68167E7aAfacEA8F3413593'
                              chainId: '1868'
                              hash: >-
                                0x06843bdf43d1a9e9ab9483476083d425ca6db0cc604a5aeecaf7af82c559c398
                              signature: >-
                                0x0000000000000000000000000000000000000000000000000000000000000000
                          signature: >-
                            0x0000000000000000000000000000000000000000000000000000000000000000
      security:
        - x-api-key: []
components:
  schemas:
    ListOrdersDto:
      type: object
      properties:
        chainId:
          type: number
          example: 1868
          description: Chain ID
        accountAddress:
          type: string
          example: '0x7D878A527e86321aECd80A493E584117A907A0AB'
          description: Account address
        items:
          description: Array of listing inputs
          type: array
          items:
            $ref: '#/components/schemas/ListOrderItemDto'
      required:
        - chainId
        - accountAddress
        - items
    ExecutionDto:
      type: object
      properties:
        steps:
          type: array
          items:
            $ref: '#/components/schemas/StepDto'
          description: Execution steps
      required:
        - steps
    ListOrderItemDto:
      type: object
      properties:
        tokenAddress:
          type: string
          example: '0xfc8e7bda94874f6baa591dd70af0fda1fca201ab'
          description: Address of the token being traded
        tokenType:
          type: string
          enum:
            - ERC721
            - ERC1155
          description: Type of the token (ERC721 or ERC1155)
          example: ERC721
        tokenId:
          type: string
          example: '142'
          description: ID of the token
        unitPrice:
          type: string
          example: '0.1'
          description: Price per unit
        quantity:
          type: string
          example: '1'
          description: Quantity of tokens
        currencyAddress:
          type: string
          example: '0x4200000000000000000000000000000000000006'
          description: Currency token address
        currencySymbol:
          type: string
          example: WETH
          description: Currency symbol
        currencyDecimals:
          type: number
          example: 18
          description: Currency decimals
          default: 18
        startTime:
          type: number
          description: Order start time
          example: 1753328679
        endTime:
          type: number
          description: Order end time
          example: 1911066278
        fees:
          description: Array of fee specifications
          type: array
          items:
            $ref: '#/components/schemas/ListOrderFeeDto'
      required:
        - tokenAddress
        - tokenType
        - tokenId
        - unitPrice
    StepDto:
      type: object
      properties:
        id:
          type: string
          description: Step identifier
          enum:
            - approve-tokens
            - approve-aggregator
            - create-orders
            - cancel-orders
            - exchange
          example: approve-tokens
        items:
          type: array
          items:
            $ref: '#/components/schemas/StepItemDto'
          description: Step items
      required:
        - id
        - items
    ListOrderFeeDto:
      type: object
      properties:
        recipient:
          type: string
          example: '0x7D878A527e86321aECd80A493E584117A907A0AB'
          description: Fee recipient address
        bps:
          type: number
          example: 250
          description: Fee amount in basis points
      required:
        - recipient
        - bps
    StepItemDto:
      type: object
      properties:
        type:
          type: string
          description: Step item type
          enum:
            - transaction
            - signTypedData
            - post
          example: transaction
        data:
          type: object
          description: Step item data
      required:
        - type
        - data
  securitySchemes:
    x-api-key:
      type: apiKey
      in: header
      name: x-api-key

````