Get Real Account PnL and Portfolio Details

Retrieves the real account’s current portfolio, including credit, open positions, orders, mirrors, and PnL details.

GET /api/v1/trading/info/real/pnl

Get Real Account PnL and Portfolio Details

cURL

curl --request GET \
  --url https://public-api.etoro.com/api/v1/trading/info/real/pnl \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-request-id: <x-request-id>' \
  --header 'x-user-key: <x-user-key>'

200

{
  "clientPortfolio": {
    "credit": 10000.5,
    "unrealizedPnL": 251,
    "mirrors": [
      {
        "mirrorId": 1,
        "cid": 123,
        "parentCid": 456,
        "stopLossPercentage": 15.5,
        "isPaused": false,
        "copyExistingPositions": true,
        "availableAmount": 5000,
        "stopLossAmount": 750,
        "initialInvestment": 10000,
        "depositSummary": 12000,
        "withdrawalSummary": 2000,
        "positions": [
          {
            "positionId": 9002,
            "cid": 124,
            "openDateTime": "2024-01-02T09:00:00Z",
            "openRate": 1.2346,
            "instrumentId": 102,
            "isBuy": false,
            "takeProfitRate": 1.6,
            "stopLossRate": 1.1,
            "mirrorId": 1,
            "parentPositionId": 8002,
            "amount": 2000,
            "leverage": 3,
            "orderId": 5002,
            "orderType": 2,
            "units": 20.5,
            "totalFees": 3.5,
            "initialAmountInDollars": 2000,
            "isTslEnabled": true,
            "stopLossVersion": 2,
            "isSettled": false,
            "redeemStatusId": 1,
            "initialUnits": 20.5,
            "isPartiallyAltered": true,
            "unitsBaseValueDollars": 2000,
            "isDiscounted": true,
            "openPositionActionType": 2,
            "settlementTypeId": 2,
            "isDetached": true,
            "openConversionRate": 1.2,
            "pnlVersion": 2,
            "totalExternalFees": 1,
            "totalExternalTaxes": 0.5,
            "isNoTakeProfit": true,
            "isNoStopLoss": false,
            "lotCount": 2,
            "externalOperation": null,
            "pnL": 150.75,
            "closeRate": 1.3,
            "closeConversionRate": 1.15,
            "timestamp": "2024-01-02T12:00:00Z"
          }
        ],
        "parentUsername": "parent_user",
        "closedPositionsNetProfit": 350.75,
        "startedCopyDate": "2024-01-01T09:00:00Z",
        "pendingForClosure": false,
        "parentMirrors": [],
        "mirrorCalculationType": 2,
        "ordersForOpen": [
          {
            "orderId": 1001,
            "orderType": 1,
            "statusId": 1,
            "cid": 123,
            "openDateTime": "2024-01-01T09:00:00Z",
            "lastUpdate": "2024-01-02T10:00:00Z",
            "instrumentId": 101,
            "amount": 1000,
            "amountInUnits": 10.5,
            "isBuy": true,
            "leverage": 2,
            "stopLossRate": 1.2345,
            "takeProfitRate": 1.3456,
            "isTslEnabled": false,
            "isDiscounted": true,
            "mirrorId": 1,
            "frozenAmount": 0,
            "totalExternalCosts": 5,
            "isNoTakeProfit": false,
            "isNoStopLoss": false,
            "lotCount": 1,
            "openPositionActionType": 1,
            "externalOperation": null
          }
        ],
        "ordersForClose": [
          {
            "orderId": 2001,
            "orderType": 2,
            "statusId": 1,
            "cid": 123,
            "openDateTime": "2024-01-01T09:00:00Z",
            "lastUpdate": "2024-01-02T10:00:00Z",
            "instrumentId": 101,
            "unitsToDeduct": 5,
            "lotsToDeduct": 0.5,
            "positionId": 3001
          }
        ],
        "ordersForCloseMultiple": [
          {
            "orderId": 3001,
            "orderType": 3,
            "statusId": 1,
            "cid": 123,
            "openDateTime": "2024-01-01T09:00:00Z",
            "lastUpdate": "2024-01-02T10:00:00Z",
            "instrumentId": 101,
            "unitsToDeduct": 10,
            "lotsToDeduct": 1,
            "pendingClosePositionIds": [
              3001,
              3002
            ]
          }
        ],
        "mirrorStatusId": 1
      }
    ],
    "orders": [
      {
        "orderId": 5001,
        "cid": 123,
        "openDateTime": "2024-01-01T09:00:00Z",
        "instrumentId": 101,
        "isBuy": true,
        "takeProfitRate": 1.5,
        "stopLossRate": 1.2,
        "rate": 1.3,
        "amount": 1000,
        "leverage": 2,
        "units": 10.5,
        "isTslEnabled": false,
        "executionType": 1,
        "isDiscounted": false,
        "isNoTakeProfit": false,
        "isNoStopLoss": false
      }
    ],
    "ordersForOpen": [
      {
        "orderId": 1001,
        "orderType": 1,
        "statusId": 1,
        "cid": 123,
        "openDateTime": "2024-01-01T09:00:00Z",
        "lastUpdate": "2024-01-02T10:00:00Z",
        "instrumentId": 101,
        "amount": 1000,
        "amountInUnits": 10.5,
        "isBuy": true,
        "leverage": 2,
        "stopLossRate": 1.2345,
        "takeProfitRate": 1.3456,
        "isTslEnabled": false,
        "isDiscounted": true,
        "mirrorId": 1,
        "frozenAmount": 0,
        "totalExternalCosts": 5,
        "isNoTakeProfit": false,
        "isNoStopLoss": false,
        "lotCount": 1,
        "openPositionActionType": 1,
        "externalOperation": null
      }
    ],
    "ordersForClose": [
      {
        "orderId": 2001,
        "orderType": 2,
        "statusId": 1,
        "cid": 123,
        "openDateTime": "2024-01-01T09:00:00Z",
        "lastUpdate": "2024-01-02T10:00:00Z",
        "instrumentId": 101,
        "unitsToDeduct": 5,
        "lotsToDeduct": 0.5,
        "positionId": 3001
      }
    ],
    "ordersForCloseMultiple": [
      {
        "orderId": 3001,
        "orderType": 3,
        "statusId": 1,
        "cid": 123,
        "openDateTime": "2024-01-01T09:00:00Z",
        "lastUpdate": "2024-01-02T10:00:00Z",
        "instrumentId": 101,
        "unitsToDeduct": 10,
        "lotsToDeduct": 1,
        "pendingClosePositionIds": [
          3001,
          3002
        ]
      }
    ],
    "bonusCredit": 500,
    "positions": [
      {
        "positionId": 9001,
        "cid": 123,
        "openDateTime": "2024-01-01T09:00:00Z",
        "openRate": 1.2345,
        "instrumentId": 101,
        "isBuy": true,
        "takeProfitRate": 1.5,
        "stopLossRate": 1.2,
        "mirrorId": 1,
        "parentPositionId": 8001,
        "amount": 1000,
        "leverage": 2,
        "orderId": 5001,
        "orderType": 1,
        "units": 10.5,
        "totalFees": 2.5,
        "initialAmountInDollars": 1000,
        "isTslEnabled": false,
        "stopLossVersion": 1,
        "isSettled": true,
        "redeemStatusId": 0,
        "initialUnits": 10.5,
        "isPartiallyAltered": false,
        "unitsBaseValueDollars": 1000,
        "isDiscounted": false,
        "openPositionActionType": 1,
        "settlementTypeId": 1,
        "isDetached": false,
        "openConversionRate": 1,
        "pnlVersion": 1,
        "totalExternalFees": 0,
        "totalExternalTaxes": 0,
        "isNoTakeProfit": false,
        "isNoStopLoss": false,
        "lotCount": 1,
        "externalOperation": null,
        "pnL": 100.25,
        "closeRate": 1.25,
        "closeConversionRate": 1.1,
        "timestamp": "2024-01-01T12:00:00Z"
      }
    ]
  }
}

Headers

x-request-id · string<uuid> · required

A unique request identifier.

Example:

"77283588-5d47-40f7-bf49-35ba05b71cbc"

x-api-key · string<password> · required

API key for authentication.

Example:

"lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663"

x-user-key · string<password> · required

User-specific authentication key.

Example:

"eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_"

Response

200 - application/json

Successfully retrieved real account PnL and portfolio information.

Comprehensive portfolio information including positions, orders, and account status

clientPortfolio · object

Container for all portfolio-related information

Show child attributes