---
title: "Get TWAP order history"
method: GET
path: "/api/v1/twap_history"
tags: ["TWAP"]
---

# Get TWAP order history

`GET /api/v1/twap_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.

## Query parameters

- `account` string, required
- `limit` integer
- `offset` integer
- `start_timestamp` integer
- `end_timestamp` integer
- `sort_key` 'timestamp' — Sort key for history endpoints
- `sort_dir` 'ASC' | 'DESC'

## Response `200`

TWAP history retrieved successfully

- PaginatedResponseTwapDto
  - `items` object[], required — The items in the current page
    - `client_order_id` string, required
    - `duration_s` integer, required
    - `frequency_s` integer, required
    - `is_buy` boolean, required
    - `is_reduce_only` boolean, required
    - `market` string, required
    - `order_id` string, required
    - `orig_size` number, double, required
    - `remaining_size` number, double, required
    - `start_unix_ms` integer, required
    - `status` string, required
    - `transaction_unix_ms` integer, required
    - `transaction_version` integer, required
  - `total_count` integer, nullable — The total number of items across all pages. Optional: history endpoints omit this field to avoid expensive COUNT(*) queries.

## Other responses

- `500` — Database error

---

[API](https://skmtc.net/decibel/apis/decibel-trading-api.md) · [All operations](https://skmtc.net/decibel/apis/decibel-trading-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/decibel/decibel-trading-api/revisions/37a02083ff59/schema)