> ## 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: Account
    description: Account-specific endpoints and data
  - 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: Points
    description: Points-related account metrics
  - name: Trading Points
    description: Trading points endpoints
  - name: Trading Hz
    description: Trading Hz endpoints
  - name: Tier
    description: Tier information endpoints
  - name: Streaks
    description: User streak tracking endpoints
  - name: Predeposit Rewards
    description: Season 0 predeposit USDC rewards
  - name: Referrals
    description: Referral code management and tracking
  - name: Affiliates
    description: Affiliate code and earnings endpoints
  - name: Campaigns
    description: On-chain reward campaign endpoints
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 (`user` query alias is also accepted)
          required: true
          schema:
            type: string
        - name: limit
          in: query
          description: Page size
          required: false
          schema:
            type: integer
            format: int32
            default: 10
            maximum: 200
            minimum: 0
          example: 100
        - name: offset
          in: query
          description: Page offset
          required: false
          schema:
            type: integer
            format: int32
            default: 0
            maximum: 10000
            minimum: 0
          example: 0
        - name: start_timestamp
          in: query
          description: >-
            Start timestamp in Unix milliseconds (inclusive). Must be provided
            together with `end_timestamp`.
          required: false
          schema:
            type: integer
            format: int64
          example: 1700000000000
        - name: end_timestamp
          in: query
          description: >-
            End timestamp in Unix milliseconds (inclusive). Must be provided
            together with `start_timestamp`.
          required: false
          schema:
            type: integer
            format: int64
          example: 1701000000000
        - name: sort_key
          in: query
          description: Sort key for history ordering. Defaults to `timestamp` when omitted.
          required: false
          schema:
            $ref: '#/components/schemas/HistorySortKey'
        - name: sort_dir
          in: query
          description: >-
            Sort direction for history ordering. Defaults to `DESC` when
            omitted.
          required: false
          schema:
            $ref: '#/components/schemas/SortDir'
      responses:
        '200':
          description: TWAP history retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedResponse_TwapDto'
        '500':
          description: Database error
components:
  schemas:
    HistorySortKey:
      type: string
      description: Sort key for history endpoints
      enum:
        - timestamp
    SortDir:
      type: string
      enum:
        - ASC
        - DESC
    PaginatedResponse_TwapDto:
      type: object
      required:
        - items
      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
            - 'null'
          format: int32
          description: >-
            The total number of items across all pages.

            Optional: history endpoints omit this field to avoid expensive
            COUNT(*) queries.
          minimum: 0
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Bearer token from Geomi. See
        [Authentication](/api-reference/rest/authentication) for setup
        instructions.

````