Modify stop-loss and take-profit settings on an open position

curl --request PATCH \
  --url https://public-api.etoro.com/api/v2/trading/positions/{positionId} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --header 'x-request-id: <x-request-id>' \
  --header 'x-user-key: <api-key>' \
  --data '
{
  "stopLossRate": 145.25,
  "takeProfitRate": 165.5,
  "stopLossType": "fixed"
}
'

import requests

url = "https://public-api.etoro.com/api/v2/trading/positions/{positionId}"

payload = {
    "stopLossRate": 145.25,
    "takeProfitRate": 165.5,
    "stopLossType": "fixed"
}
headers = {
    "x-request-id": "<x-request-id>",
    "x-api-key": "<api-key>",
    "x-user-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {
    'x-request-id': '<x-request-id>',
    'x-api-key': '<api-key>',
    'x-user-key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({stopLossRate: 145.25, takeProfitRate: 165.5, stopLossType: 'fixed'})
};

fetch('https://public-api.etoro.com/api/v2/trading/positions/{positionId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://public-api.etoro.com/api/v2/trading/positions/{positionId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'stopLossRate' => 145.25,
    'takeProfitRate' => 165.5,
    'stopLossType' => 'fixed'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>",
    "x-request-id: <x-request-id>",
    "x-user-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://public-api.etoro.com/api/v2/trading/positions/{positionId}"

	payload := strings.NewReader("{\n  \"stopLossRate\": 145.25,\n  \"takeProfitRate\": 165.5,\n  \"stopLossType\": \"fixed\"\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("x-request-id", "<x-request-id>")
	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("x-user-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://public-api.etoro.com/api/v2/trading/positions/{positionId}")
  .header("x-request-id", "<x-request-id>")
  .header("x-api-key", "<api-key>")
  .header("x-user-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"stopLossRate\": 145.25,\n  \"takeProfitRate\": 165.5,\n  \"stopLossType\": \"fixed\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://public-api.etoro.com/api/v2/trading/positions/{positionId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["x-request-id"] = '<x-request-id>'
request["x-api-key"] = '<api-key>'
request["x-user-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"stopLossRate\": 145.25,\n  \"takeProfitRate\": 165.5,\n  \"stopLossType\": \"fixed\"\n}"

response = http.request(request)
puts response.read_body

{
  "operationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "positionId": 13902598,
  "referenceId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>"
}

Trading - Real

Modify stop-loss and take-profit settings on an open position

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.

Submits an asynchronous request to update stop-loss and/or take-profit on an open position. You can set a new stopLossRate, takeProfitRate, stopLossType, or clear either value (clearStopLoss, clearTakeProfit). At least one SL/TP-related field is required. The response returns acceptance and correlation metadata only.

PATCH

api

trading

positions

{positionId}

Modify stop-loss and take-profit settings on an open position

curl --request PATCH \
  --url https://public-api.etoro.com/api/v2/trading/positions/{positionId} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --header 'x-request-id: <x-request-id>' \
  --header 'x-user-key: <api-key>' \
  --data '
{
  "stopLossRate": 145.25,
  "takeProfitRate": 165.5,
  "stopLossType": "fixed"
}
'

import requests

url = "https://public-api.etoro.com/api/v2/trading/positions/{positionId}"

payload = {
    "stopLossRate": 145.25,
    "takeProfitRate": 165.5,
    "stopLossType": "fixed"
}
headers = {
    "x-request-id": "<x-request-id>",
    "x-api-key": "<api-key>",
    "x-user-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {
    'x-request-id': '<x-request-id>',
    'x-api-key': '<api-key>',
    'x-user-key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({stopLossRate: 145.25, takeProfitRate: 165.5, stopLossType: 'fixed'})
};

fetch('https://public-api.etoro.com/api/v2/trading/positions/{positionId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://public-api.etoro.com/api/v2/trading/positions/{positionId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'stopLossRate' => 145.25,
    'takeProfitRate' => 165.5,
    'stopLossType' => 'fixed'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>",
    "x-request-id: <x-request-id>",
    "x-user-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://public-api.etoro.com/api/v2/trading/positions/{positionId}"

	payload := strings.NewReader("{\n  \"stopLossRate\": 145.25,\n  \"takeProfitRate\": 165.5,\n  \"stopLossType\": \"fixed\"\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("x-request-id", "<x-request-id>")
	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("x-user-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://public-api.etoro.com/api/v2/trading/positions/{positionId}")
  .header("x-request-id", "<x-request-id>")
  .header("x-api-key", "<api-key>")
  .header("x-user-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"stopLossRate\": 145.25,\n  \"takeProfitRate\": 165.5,\n  \"stopLossType\": \"fixed\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://public-api.etoro.com/api/v2/trading/positions/{positionId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["x-request-id"] = '<x-request-id>'
request["x-api-key"] = '<api-key>'
request["x-user-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"stopLossRate\": 145.25,\n  \"takeProfitRate\": 165.5,\n  \"stopLossType\": \"fixed\"\n}"

response = http.request(request)
puts response.read_body

{
  "operationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "positionId": 13902598,
  "referenceId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>"
}

Authorizations

x-api-key

string

header

default:lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663

required

API key of the application. Only valid together with the x-user-key header — the pair is an alternative to OAuth bearer authentication, never sent alongside it. The pair is granted the same permissions the operation's OAuth scopes describe.

Demo credential for trying the API from these docs: lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663

x-user-key

string

header

default:eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_

required

User-specific authentication key. Only valid together with the x-api-key header — the pair is an alternative to OAuth bearer authentication, never sent alongside it.

Demo credential for trying the API from these docs: eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_

Headers

x-request-id

string<uuid>

required

A unique request identifier.

Example:

"26a2a014-b075-4d57-942c-19125d6a797e"

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. Note that deepening a stop loss beyond the allowed maximum stop loss will cause funds to be transferred from the account balance into the position margin.

takeProfitRate

number<decimal> | null

New take-profit rate for the position.

stopLossType

enum<string> | null

Stop-loss type. fixed - the stop-loss rate does not change. trailing - the stop-loss rate moves up whenever the instrument rate goes up such that the stop loss is triggered from the same distance from the last peak rate as the distance of the stop-loss rate from the rate at the open.

Available options:

fixed,

trailing

clearStopLoss

boolean | null

When true, removes stop-loss from the position, if the system allows the position to clear its stop loss. Normally it cannot be done for leveraged and future positions.

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.

⌘I

Getting started

Guides

Core API

Deprecated

WebSocket API

Vibe Code

AI Agents

Changelog

Modify stop-loss and take-profit settings on an open position

Authorizations

Headers

Path Parameters

Body

Response