Skip to main content
GET
/
api
/
v1
/
user-info
/
people
/
{username}
/
portfolio
/
live
Get the live portfolio of a user
curl --request GET \
  --url https://public-api.etoro.com/api/v1/user-info/people/{username}/portfolio/live \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-request-id: <x-request-id>' \
  --header 'x-user-key: <x-user-key>'
{
  "realizedCreditPct": 123,
  "unrealizedCreditPct": 123,
  "positions": [
    {
      "positionId": 123,
      "openTimestamp": "2023-11-07T05:31:56Z",
      "openRate": 123,
      "instrumentId": 123,
      "isBuy": true,
      "leverage": 123,
      "takeProfitRate": 123,
      "stopLossRate": 123,
      "socialTradeId": 123,
      "parentPositionId": 123,
      "investmentPct": 123,
      "netProfit": 123,
      "trailingStopLoss": true
    }
  ],
  "socialTrades": [
    {
      "socialTradeId": 123,
      "parentUsername": "<string>",
      "stopLossPercentage": 123,
      "openTimestamp": "2023-11-07T05:31:56Z",
      "investmentPct": 123,
      "openInvestmentPct": 123,
      "netProfit": 123,
      "openNetProfit": 123,
      "closedNetProfit": 123,
      "realizedPct": 123,
      "unrealizedPct": 123,
      "isClosing": true,
      "positions": [
        {
          "positionId": 123,
          "openTimestamp": "2023-11-07T05:31:56Z",
          "openRate": 123,
          "instrumentId": 123,
          "isBuy": true,
          "leverage": 123,
          "takeProfitRate": 123,
          "stopLossRate": 123,
          "socialTradeId": 123,
          "parentPositionId": 123,
          "investmentPct": 123,
          "netProfit": 123,
          "trailingStopLoss": true
        }
      ]
    }
  ]
}

Headers

​
x-request-id
string<uuid>
required

A unique request identifier.

Example:

"33531c06-e05d-40f9-90fd-11cb127476bc"

​
x-api-key
string<password>
required

API key for authentication.

Example:

"lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663"

​
x-user-key
string<password>
required

User-specific authentication key.

Example:

"eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_"

Path Parameters

​
username
string
required

The username of the user to retrieve the live portfolio for.

Response

200 - application/json

OK

​
realizedCreditPct
number<decimal>

Credit as a percentage of the realized credit

​
unrealizedCreditPct
number<decimal>

Credit as a percentage of the unrealized credit

​
positions
object[]
​
socialTrades
object[]