---
title: "Get Trades"
method: POST
path: "/trading/trades"
tags: ["Trading"]
---

# Get Trades

`POST /trading/trades`

Get trade history across all or filtered accounts with complex filtering.

Args:
    filter_request: JSON payload with filtering criteria

Returns:
    Paginated response with trade data and pagination metadata

## Request body

- TradeFilterRequest — Request model for filtering trades
  - `limit` integer — Number of items per page
  - `start_time` integer, nullable — Start time as Unix timestamp in milliseconds
  - `end_time` integer, nullable — End time as Unix timestamp in milliseconds
  - `cursor` string, nullable — Cursor for next page
  - `account_names` string[], nullable — List of account names to filter by
  - `connector_names` string[], nullable — List of connector names to filter by
  - `trading_pairs` string[], nullable — List of trading pairs to filter by
  - `trade_types` string[], nullable — List of trade types to filter by (BUY/SELL)

## Response `200`

Successful Response

- PaginatedResponse — Generic paginated response.
  - `data` object[], required
  - `pagination` object, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/hummingbot/apis/hummingbot-api.md) · [All operations](https://skmtc.net/hummingbot/apis/hummingbot-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hummingbot/hummingbot-api/versions/5347fe79537f/schema)