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

# Get Trade History

`GET /api/v1/execution/list`

## Request

- Base URL: `https://api.ekiden.fi`
- URL: `https://api.ekiden.fi/api/v1/execution/list`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/ekidenfi/apis/ekiden-gateway/docs/api/v1/execution/list/get.ts> (a function with typed inputs; its response is checked against the schema)

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
    - `base_fee` string, required: Flat base fee charged on order creation.
    - `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

## Changes

- **2026-09-10** `fad9eecaba2e`: 1 info
  - added the required property `list/items/base_fee` to the response with the `200` status
- **2026-01-29** `16fe50636aa5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ekidenfi/apis/ekiden-gateway/changes/api/v1/execution/list/get.md)

---

[API](https://skmtc.dev/ekidenfi/apis/ekiden-gateway.md) - [All operations](https://skmtc.dev/ekidenfi/apis/ekiden-gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/ekidenfi/apis/ekiden-gateway/revisions/fad9eecaba2e?raw)