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

# List Delta orders

> Paginated list of a user's Delta V2 orders, filterable by chain, status, type, and on-chain order type.



## OpenAPI

````yaml api-reference/specs/delta-v2.json GET /v2/delta/orders
openapi: 3.0.3
info:
  title: Velora Delta API V2
  version: 2.0.0
  description: >-
    Velora Delta API V2 — server-built EIP-712 orders, route-based pricing with
    alternatives, paginated order history, and a unified status model. Ships
    alongside Delta V1; both protocols share the same on-chain contracts.
servers:
  - url: https://api.velora.xyz
    description: Production
security: []
paths:
  /v2/delta/orders:
    get:
      summary: List a user's Delta V2 orders (paginated)
      operationId: deltaV2OrdersList
      parameters:
        - name: userAddress
          in: query
          required: true
          schema:
            type: string
        - name: page
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            default: 1
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 1000
            default: 100
        - name: chainId
          in: query
          required: false
          schema:
            type: string
          description: Comma-separated chain IDs. Omit for all chains.
        - name: type
          in: query
          required: false
          schema:
            type: string
            enum:
              - MARKET
              - LIMIT
        - name: status
          in: query
          required: false
          schema:
            type: string
          description: >-
            Comma-separated `OrderStatusV2` values: `PENDING`,
            `AWAITING_SIGNATURE`, `ACTIVE`, `SUSPENDED`, `CANCELLING`,
            `BRIDGING`, `COMPLETED`, `FAILED`, `EXPIRED`, `REFUNDING`,
            `CANCELLED`, `REFUNDED`.
        - name: onChainOrderType
          in: query
          required: false
          schema:
            type: string
            enum:
              - Order
              - ProductiveOrder
              - ExternalOrder
              - TWAPOrder
              - TWAPBuyOrder
      responses:
        '200':
          description: Paginated envelope.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/DeltaAuction'
                  total:
                    type: integer
                  page:
                    type: integer
                  limit:
                    type: integer
                  hasMore:
                    type: boolean
components:
  schemas:
    DeltaAuction:
      type: object
      description: >-
        V2 order shape returned by every order endpoint (reads and posts).
        `input` and `output` carry the *expected* + *executed* amounts so you
        don't need to compute fill-percent yourself. `onChainOrderType` selects
        the family the `order` struct belongs to. Crosschain refunds appear in
        `refunds` after Velora verifies the refund transaction receipt.
      properties:
        id:
          type: string
          format: uuid
        status:
          type: string
          enum:
            - PENDING
            - AWAITING_SIGNATURE
            - ACTIVE
            - SUSPENDED
            - CANCELLING
            - BRIDGING
            - COMPLETED
            - FAILED
            - EXPIRED
            - REFUNDING
            - CANCELLED
            - REFUNDED
        side:
          type: string
          enum:
            - SELL
            - BUY
        type:
          type: string
          enum:
            - MARKET
            - LIMIT
        onChainOrderType:
          type: string
          enum:
            - Order
            - FillableOrder
            - ProductiveOrder
            - ExternalOrder
            - TWAPOrder
            - TWAPBuyOrder
        input:
          type: object
          description: >-
            Source-side token movement. SELL: `{ chainId, token, amount }`. BUY:
            `{ chainId, token, expectedAmount, executedAmount }`.
          properties:
            chainId:
              type: integer
            token:
              type: string
            amount:
              type: string
            expectedAmount:
              type: string
              nullable: true
            executedAmount:
              type: string
              nullable: true
        output:
          type: object
          description: >-
            Destination-side token movement. SELL: `{ chainId, token,
            expectedAmount, executedAmount }`. BUY: `{ chainId, token, amount
            }`.
          properties:
            chainId:
              type: integer
            token:
              type: string
            amount:
              type: string
            expectedAmount:
              type: string
              nullable: true
            executedAmount:
              type: string
              nullable: true
        owner:
          type: string
        beneficiary:
          type: string
        orderHash:
          type: string
        partner:
          type: string
        order:
          type: object
          description: The signed on-chain Order struct.
        transactions:
          type: array
          items:
            type: object
            properties:
              originTx:
                type: string
              destinationTx:
                type: string
                nullable: true
                description: >-
                  Set for crosschain orders once the fill lands on
                  `destChainId`.
              filledPercent:
                type: number
                description: 0–100.
              spentAmount:
                type: string
                nullable: true
              receivedAmount:
                type: string
                nullable: true
        refunds:
          type: array
          description: >-
            Verified bridge refund transactions for crosschain orders. Empty
            until Velora can match an on-chain refund receipt; some bridge
            providers may not emit source-chain token refund metadata.
          items:
            type: object
            properties:
              tx:
                type: string
                description: Refund transaction hash.
              chainId:
                type: integer
                description: Chain where the refund transaction was observed.
              token:
                type: string
                description: Refunded token address.
              amount:
                type: string
                description: Refunded token amount in raw token units.
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
        expiresAt:
          type: string
          format: date-time

````