Skip to main content
GET
/
api
/
v1
/
trading
/
info
/
trade
/
history
List trading history
curl --request GET \
  --url https://public-api.etoro.com/api/v1/trading/info/trade/history \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-request-id: <x-request-id>' \
  --header 'x-user-key: <x-user-key>'
[
  {
    "netProfit": 123,
    "closeRate": 123,
    "closeTimestamp": "2023-11-07T05:31:56Z",
    "positionId": 123,
    "instrumentId": 123,
    "isBuy": true,
    "leverage": 123,
    "openRate": 123,
    "openTimestamp": "2023-11-07T05:31:56Z",
    "stopLossRate": 123,
    "takeProfitRate": 123,
    "trailingStopLoss": true,
    "orderId": 123,
    "socialTradeId": 123,
    "parentPositionId": 123,
    "investment": 123,
    "initialInvestment": 123,
    "fees": 123,
    "units": 123
  }
]

Headers

x-request-id
string<uuid>
required

A unique request identifier.

Example:

"85b9e3b5-08e7-439f-9b4f-f52f2b3b1634"

x-api-key
string<password>
required

API key for authentication.

Example:

"lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663"

x-user-key
string<password>
required

User-specific authentication key.

Example:

"eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_"

Query Parameters

minDate
string<date>
required

The start date of the period you would like to view.

page
integer

The page number.

pageSize
integer

The amount of trades in each page.

Response

200 - application/json

OK

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

The position ID of the trade

instrumentId
integer<int32>

The instrument ID of the instrument that was traded

isBuy
boolean

Indicates if the trade was a buy or sell

leverage
integer<int32>

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

The order ID of the trade

socialTradeId
integer<int64>

The social trade ID of the trade

parentPositionId
integer<int64>

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