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

# Get TWAP order history

> Retrieve TWAP order history for a specific user including completed and cancelled orders.
Returns historical TWAP orders sorted by most recent first.
Supports filtering by timestamp range, sorting by timestamp, and pagination. Page size is capped at 200.



## OpenAPI

````yaml /api-reference/openapi.json get /api/v1/twap_history
openapi: 3.1.0
info:
  title: Decibel Trading API
  description: >-
    RESTful API for Decibel. Provides read-only endpoints for market data,
    trading operations, positions, and analytics.
  contact:
    name: Decibel Team
    url: https://decibel.trade/
  license:
    name: ''
  version: 1.0.0
servers:
  - url: https://api.mainnet.aptoslabs.com/decibel
    description: Mainnet
  - url: https://api.testnet.aptoslabs.com/decibel
    description: Testnet
security:
  - bearerAuth: []
tags:
  - name: Market Data
    description: Market information and real-time data endpoints
  - name: User
    description: User information and account management
  - name: Trades
    description: Trading operations and history
  - name: Positions
    description: User position management
  - name: Orders
    description: Order management and history
  - name: TWAP
    description: Time-weighted average price orders
  - name: Bulk Orders
    description: Bulk order management
  - name: Vaults
    description: Vault operations and management
  - name: Analytics
    description: Analytics and performance metrics
  - name: Predeposit Rewards
    description: Season 0 predeposit USDC rewards
  - name: Referrals
    description: Referral code management and tracking
paths:
  /api/v1/twap_history:
    get:
      tags:
        - TWAP
      summary: Get TWAP order history
      description: >-
        Retrieve TWAP order history for a specific user including completed and
        cancelled orders.

        Returns historical TWAP orders sorted by most recent first.

        Supports filtering by timestamp range, sorting by timestamp, and
        pagination. Page size is capped at 200.
      operationId: handle_twap_history
      parameters:
        - name: account
          in: query
          description: User account address
          required: true
          schema:
            type: string
          example: 0x123...
        - name: pagination
          in: query
          description: Pagination parameters (limit and offset)
          required: true
          schema:
            type: object
            properties:
              limit:
                type: integer
                format: int32
                maximum: 1000
                minimum: 0
              offset:
                type: integer
                format: int32
                maximum: 10000
                minimum: 0
        - name: filter
          in: query
          description: Timestamp range filter
          required: true
          schema:
            $ref: 24e93dfc-f72d-4b88-9b3a-91162ef46f02
        - name: sorting
          in: query
          description: Sorting parameters
          required: true
          schema:
            $ref: 250c3ae3-9c34-48a6-b4be-a45159c4bc4d
      responses:
        '200':
          description: TWAP history retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedResponse_TwapDto'
        '500':
          description: Database error
components:
  schemas:
    PaginatedResponse_TwapDto:
      type: object
      required:
        - items
        - total_count
      properties:
        items:
          type: array
          items:
            type: object
            required:
              - market
              - is_buy
              - order_id
              - is_reduce_only
              - start_unix_ms
              - frequency_s
              - duration_s
              - orig_size
              - remaining_size
              - status
              - client_order_id
              - transaction_unix_ms
              - transaction_version
            properties:
              client_order_id:
                type: string
                example: client_order_123
              duration_s:
                type: integer
                format: int64
                example: 300
                minimum: 0
              frequency_s:
                type: integer
                format: int64
                example: 30
                minimum: 0
              is_buy:
                type: boolean
                example: true
              is_reduce_only:
                type: boolean
              market:
                type: string
                example: 0xmarket123...
              order_id:
                type: string
              orig_size:
                type: number
                format: double
              remaining_size:
                type: number
                format: double
              start_unix_ms:
                type: integer
                format: int64
                example: 1730841600000
              status:
                type: string
              transaction_unix_ms:
                type: integer
                format: int64
              transaction_version:
                type: integer
                format: int64
                minimum: 0
          description: The items in the current page
        total_count:
          type: integer
          format: int32
          description: The total number of items across all pages
          minimum: 0
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Bearer token from Geomi. See
        [Authentication](/api-reference/rest/authentication) for setup
        instructions.

````