---
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`

## Request

- Base URL: `https://dex.tomochain.com/api`
- URL: `https://dex.tomochain.com/api/trades/history`
- Auth: none required
- TypeScript: <https://skmtc.dev/buildonviction/apis/tomodex-apis/docs/trades/history/get.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/buildonviction/apis/tomodex-apis.md) - [All operations](https://skmtc.dev/buildonviction/apis/tomodex-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/buildonviction/apis/tomodex-apis/revisions/18b6ffedd480?raw)