---
title: "Get Trade History"
method: GET
path: "/api/v1/execution/list"
tags: ["Trade"]
---

# Get Trade History

`GET /api/v1/execution/list`

Query users' execution records, sorted by execTime in descending order.

## Query parameters

- `sub_account_address` string, required
- `symbol` string
- `order_id` string, uuid
- `order_link_id` string
- `start_time` string, date-time, nullable
- `end_time` string, date-time, nullable
- `limit` integer, nullable
- `cursor` string, nullable

## Response `200`

Trade history

- GetTradeHistoryResponse — Response for trade history queries.
  - `list` Execution[], required
    - `closed_size` string, nullable — Closed position size
    - `create_type` 'CreateByUser' | 'CreateByFutureSpread' | 'CreateByAdminClosing' | 'CreateBySettle' | 'CreateByStopOrder' | 'CreateByTakeProfit' | 'CreateByPartialTakeProfit' | 'CreateByStopLoss' | 'CreateByPartialStopLoss' | 'CreateByTrailingStop' | 'CreateByTrailingProfit' | 'CreateByLiq' | 'CreateByTakeOverPassThrough' | 'CreateByAdlPassThrough' | 'CreateByBlockPassThrough' | 'CreateByBlockTradeMovePositionPassThrough' | 'CreateByClosing' | 'CreateByFGridBot' | 'CloseByFGridBot' | 'CreateByTWAP' | 'CreateByTVSignal' | 'CreateByMmRateClose' | 'CreateByMartingaleBot' | 'CloseByMartingaleBot' | 'CreateByIceBerg' | 'CreateByArbitrage' | 'CreateByDdh' | 'CreateByBboOrder'
    - `exec_id` string, uuid, required
    - `exec_price` string, required — Execution price
    - `exec_qty` string, required — Execution quantity
    - `exec_time` string, date-time, required — Executed timestamp (ms)
    - `exec_type` 'Trade' | 'AdlTrade' | 'Funding' | 'BustTrade' | 'Delivery' | 'Settle' | 'BlockTrade' | 'MovePosition' | 'FutureSpread', required — Execution type for trade history entries.
    - `exec_value` string, required — Executed value (price * qty)
    - `fee_rate` string, required — Trading fee rate
    - `index_price` string, required — Index price at execution
    - `is_maker` boolean, required — Is maker order. true: maker, false: taker
    - `leaves_qty` string, required — Remaining quantity not yet executed after this fill
    - `mark_price` string, required — Mark price at execution
    - `order_id` string, uuid, required
    - `order_link_id` string
    - `order_price` string, required — Original order price
    - `order_qty` string, required — Original order quantity
    - `order_type` 'Limit' | 'Market', required — Order type: Limit, Market.
    - `seq` integer, required — Cross sequence, used to associate each fill and each position update * The seq will be the same when conclude multiple transactions at the same time * Different symbols may have the same seq, please use seq + symbol to check unique
    - `side` 'Sell' | 'Buy', required — Order side: buy or sell.
    - `stop_order_type` 'TakeProfit' | 'StopLoss' | 'TrailingStop' | 'Stop' | 'PartialTakeProfit' | 'PartialStopLoss' | 'TpslOrder' | 'OcoOrder' | 'MmRateClose' | 'BidirectionalTpslOrder'
    - `sub_account_address` string, required
    - `symbol` string, required
  - `next_page_cursor` string, nullable

---

[API](https://skmtc.net/ekidenfi/apis/ekiden-gateway.md) · [All operations](https://skmtc.net/ekidenfi/apis/ekiden-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ekidenfi/ekiden-gateway/versions/75ffe546b73a/schema)