---
title: "Retrieve the sorted list of trades for an Ethereum address in which the given address is either maker or taker"
method: GET
path: "/trades/history"
tags: ["trades"]
---

# Retrieve the sorted list of trades for an Ethereum address in which the given address is either maker or taker

`GET /trades/history`

Return trades array

## Query parameters

- `address` string, required
- `pageOffset` string
- `pageSize` string
- `sortBy` string
- `sortType` string
- `baseToken` string
- `quoteToken` string
- `from` string
- `to` string

## Response `200`

successful operation

- object
  - `total` integer
  - `trades` Trade[]
    - `id` string
    - `taker` string
    - `maker` string
    - `baseToken` string
    - `quoteToken` string
    - `makerOrderHash` string
    - `takerOrderHash` string
    - `hash` string
    - `txHash` string
    - `pairName` string
    - `pricepoint` string
    - `amount` string
    - `status` string
    - `createdAt` string, date-time
    - `updatedAt` string, date-time

## Other responses

- `400` — address Parameter missing
- `500` — Internal Server Error

---

[API](https://skmtc.net/buildonviction/apis/tomodex-apis.md) · [All operations](https://skmtc.net/buildonviction/apis/tomodex-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/buildonviction/tomodex-apis/revisions/18b6ffedd480/schema)