---
title: "List trading history"
method: GET
path: "/api/v1/trading/info/trade/history"
tags: ["Trading - Real"]
---

# List trading history

`GET /api/v1/trading/info/trade/history`

## Request

- Base URL: `https://public-api.etoro.com`
- URL: `https://public-api.etoro.com/api/v1/trading/info/trade/history`
- Auth: one of:
  - OAuth 2
    - Authorization code
    - Scopes: `etoro-public:real:read`
  - OAuth 2
    - Authorization code
    - Scopes: `etoro-public:real:write`
  - OAuth 2
    - Authorization code
    - Scopes: `etoro-public:trade.real:read`
  - OAuth 2
    - Authorization code
    - Scopes: `etoro-public:trade.real:write`
- TypeScript: <https://skmtc.dev/etoro/apis/etoro-api/docs/api/v1/trading/info/trade/history/get.ts> (a function with typed inputs; its response is checked against the schema)

**Rate limit:** 60 requests per 60 seconds. This is the **default shared quota** — it is shared with every other endpoint that has no dedicated limit, so requests across those endpoints all draw from the same budget.

## Query parameters

- `minDate` string, date, required
- `page` integer
- `pageSize` integer

## Headers

- `x-request-id` string, uuid, required
- `x-api-key` string, password, required
- `x-user-key` string, password, required

## Response `200`

OK

- object[]
  - `netProfit` number, float: The net profit of the trade
  - `closeRate` number, float: The closing rate of the trade
  - `closeTimestamp` string, date-time: The closing timestamp of the trade
  - `positionId` integer: The position ID of the trade
  - `instrumentId` integer: The instrument ID of the instrument that was traded
  - `isBuy` boolean: Indicates if the trade was a buy or sell
  - `leverage` integer: The leverage used in the trade
  - `openRate` number, float: The opening rate of the trade
  - `openTimestamp` string, date-time: The opening timestamp of the trade
  - `stopLossRate` number, float: The stop loss rate of the trade
  - `takeProfitRate` number, float: The take profit rate of the trade
  - `trailingStopLoss` boolean: Indicates if the trade had a trailing stop loss
  - `orderId` integer: The order ID of the trade
  - `socialTradeId` integer: The social trade ID of the trade
  - `parentPositionId` integer: The parent position ID of the trade
  - `investment` number, float: The investment amount of the trade
  - `initialInvestment` number, float: The initial investment amount of the trade
  - `fees` number, float: The fees of the trade
  - `units` number, float: The number of units traded

## Other responses

- `429`: Too Many Requests — the shared rate limit (60 requests / 60s) was exceeded.

---

[API](https://skmtc.dev/etoro/apis/etoro-api.md) - [All operations](https://skmtc.dev/etoro/apis/etoro-api/llms.txt) - [OpenAPI document](https://skmtc.dev/etoro/apis/etoro-api/revisions/69c1fb266c35?raw)