Skip to main content
PATCH
Modify stop-loss and take-profit settings on an open position

Authorizations

Authorization
string
header
required

eToro OAuth2. Each operation lists the scopes that grant access as separate security requirements (OpenAPI OR semantics): the caller's token only needs ONE of them — you do NOT need all of them. The same scopes back the x-api-key/x-user-key credential pair.

Headers

x-request-id
string<uuid>
required

A unique request identifier.

Example:

"05489325-411b-4a3f-93cd-327fe619b4ed"

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

positionId
integer<int64>
required

The open position identifier.

Body

application/json

Request payload for patching position stop-loss and take-profit risk parameters.

stopLossRate
number<decimal> | null

New stop-loss rate for the position.

takeProfitRate
number<decimal> | null

New take-profit rate for the position.

stopLossType
enum<string> | null

Stop-loss type.

Available options:
fixed,
trailing
clearStopLoss
boolean | null

When true, removes stop-loss from the position.

clearTakeProfit
boolean | null

When true, removes take-profit from the position.

Response

Request accepted and queued for asynchronous execution.

Response returned when a position edit request is accepted for asynchronous processing.

operationId
string<uuid>
required

Correlation identifier for the accepted edit operation.

positionId
integer<int64>
required

The position identifier from the route.

referenceId
string<uuid>
required

Client reference identifier from x-request-id header.