Open demo market order by units

curl --request POST \
  --url https://public-api.etoro.com/api/v1/trading/execution/demo/market-open-orders/by-units \
  --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 '
{
  "InstrumentID": 123,
  "IsBuy": true,
  "Leverage": 123,
  "AmountInUnits": 123,
  "StopLossRate": 123,
  "TakeProfitRate": 123,
  "IsTslEnabled": true,
  "IsNoStopLoss": true,
  "IsNoTakeProfit": true
}
'

import requests

url = "https://public-api.etoro.com/api/v1/trading/execution/demo/market-open-orders/by-units"

payload = {
    "InstrumentID": 123,
    "IsBuy": True,
    "Leverage": 123,
    "AmountInUnits": 123,
    "StopLossRate": 123,
    "TakeProfitRate": 123,
    "IsTslEnabled": True,
    "IsNoStopLoss": True,
    "IsNoTakeProfit": True
}
headers = {
    "x-request-id": "<x-request-id>",
    "x-api-key": "<api-key>",
    "x-user-key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'x-request-id': '<x-request-id>',
    'x-api-key': '<api-key>',
    'x-user-key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    InstrumentID: 123,
    IsBuy: true,
    Leverage: 123,
    AmountInUnits: 123,
    StopLossRate: 123,
    TakeProfitRate: 123,
    IsTslEnabled: true,
    IsNoStopLoss: true,
    IsNoTakeProfit: true
  })
};

fetch('https://public-api.etoro.com/api/v1/trading/execution/demo/market-open-orders/by-units', 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/v1/trading/execution/demo/market-open-orders/by-units",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'InstrumentID' => 123,
    'IsBuy' => true,
    'Leverage' => 123,
    'AmountInUnits' => 123,
    'StopLossRate' => 123,
    'TakeProfitRate' => 123,
    'IsTslEnabled' => true,
    'IsNoStopLoss' => true,
    'IsNoTakeProfit' => true
  ]),
  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/v1/trading/execution/demo/market-open-orders/by-units"

	payload := strings.NewReader("{\n  \"InstrumentID\": 123,\n  \"IsBuy\": true,\n  \"Leverage\": 123,\n  \"AmountInUnits\": 123,\n  \"StopLossRate\": 123,\n  \"TakeProfitRate\": 123,\n  \"IsTslEnabled\": true,\n  \"IsNoStopLoss\": true,\n  \"IsNoTakeProfit\": true\n}")

	req, _ := http.NewRequest("POST", 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.post("https://public-api.etoro.com/api/v1/trading/execution/demo/market-open-orders/by-units")
  .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  \"InstrumentID\": 123,\n  \"IsBuy\": true,\n  \"Leverage\": 123,\n  \"AmountInUnits\": 123,\n  \"StopLossRate\": 123,\n  \"TakeProfitRate\": 123,\n  \"IsTslEnabled\": true,\n  \"IsNoStopLoss\": true,\n  \"IsNoTakeProfit\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://public-api.etoro.com/api/v1/trading/execution/demo/market-open-orders/by-units")

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

request = Net::HTTP::Post.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  \"InstrumentID\": 123,\n  \"IsBuy\": true,\n  \"Leverage\": 123,\n  \"AmountInUnits\": 123,\n  \"StopLossRate\": 123,\n  \"TakeProfitRate\": 123,\n  \"IsTslEnabled\": true,\n  \"IsNoStopLoss\": true,\n  \"IsNoTakeProfit\": true\n}"

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

{
  "orderForOpen": {
    "instrumentID": 100000,
    "amount": 0,
    "amountInUnits": 0.001,
    "isBuy": true,
    "leverage": 1,
    "stopLossRate": 0,
    "takeProfitRate": 0,
    "isTslEnabled": false,
    "mirrorID": 0,
    "totalExternalCosts": 0,
    "lotCount": 0,
    "orderID": 13906629,
    "orderType": 18,
    "statusID": 1,
    "CID": 7765437,
    "openDateTime": "2025-04-02T15:56:50.7496838Z",
    "lastUpdate": "2025-04-02T15:56:50.7496838Z"
  },
  "token": "43ceb769-cff6-45ec-8ad7-292b7401353f"
}

Trading - Demo

Open demo market order by units

deprecated

Deprecated: This endpoint is marked deprecated in the eToro Public API Swagger. Prefer the current replacement endpoints where available.

Rate limit: 20 requests per 60 seconds. This is a shared quota — the same budget is consumed by a group of related endpoints, so calling any of them reduces what is left for the others (you cannot call each at the full rate independently). Endpoints sharing this quota:

DELETE /api/v1/trading/execution/demo/limit-orders/{orderId}
DELETE /api/v1/trading/execution/demo/market-close-orders/{orderId}
DELETE /api/v1/trading/execution/demo/market-open-orders/{orderId}
DELETE /api/v2/trading/execution/demo/orders/{orderId}
POST /api/v1/trading/execution/demo/limit-orders
POST /api/v1/trading/execution/demo/market-close-orders/positions/{positionId}
POST /api/v1/trading/execution/demo/market-open-orders/by-amount
POST /api/v2/trading/execution/demo/orders

This endpoint allows traders to place a market order to open a position by specifying the number of units (rather than an amount in cash). The trade is executed at the current market price, and optional settings like leverage, stop-loss, and take-profit can be applied. A 200 response means the order was submitted, not that the position was opened. Confirm the outcome with GET /api/v1/trading/info/demo/orders/, using the orderID returned under orderForOpen.

POST

api

trading

execution

demo

market-open-orders

by-units

Open demo market order by units

curl --request POST \
  --url https://public-api.etoro.com/api/v1/trading/execution/demo/market-open-orders/by-units \
  --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 '
{
  "InstrumentID": 123,
  "IsBuy": true,
  "Leverage": 123,
  "AmountInUnits": 123,
  "StopLossRate": 123,
  "TakeProfitRate": 123,
  "IsTslEnabled": true,
  "IsNoStopLoss": true,
  "IsNoTakeProfit": true
}
'

import requests

url = "https://public-api.etoro.com/api/v1/trading/execution/demo/market-open-orders/by-units"

payload = {
    "InstrumentID": 123,
    "IsBuy": True,
    "Leverage": 123,
    "AmountInUnits": 123,
    "StopLossRate": 123,
    "TakeProfitRate": 123,
    "IsTslEnabled": True,
    "IsNoStopLoss": True,
    "IsNoTakeProfit": True
}
headers = {
    "x-request-id": "<x-request-id>",
    "x-api-key": "<api-key>",
    "x-user-key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'x-request-id': '<x-request-id>',
    'x-api-key': '<api-key>',
    'x-user-key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    InstrumentID: 123,
    IsBuy: true,
    Leverage: 123,
    AmountInUnits: 123,
    StopLossRate: 123,
    TakeProfitRate: 123,
    IsTslEnabled: true,
    IsNoStopLoss: true,
    IsNoTakeProfit: true
  })
};

fetch('https://public-api.etoro.com/api/v1/trading/execution/demo/market-open-orders/by-units', 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/v1/trading/execution/demo/market-open-orders/by-units",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'InstrumentID' => 123,
    'IsBuy' => true,
    'Leverage' => 123,
    'AmountInUnits' => 123,
    'StopLossRate' => 123,
    'TakeProfitRate' => 123,
    'IsTslEnabled' => true,
    'IsNoStopLoss' => true,
    'IsNoTakeProfit' => true
  ]),
  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/v1/trading/execution/demo/market-open-orders/by-units"

	payload := strings.NewReader("{\n  \"InstrumentID\": 123,\n  \"IsBuy\": true,\n  \"Leverage\": 123,\n  \"AmountInUnits\": 123,\n  \"StopLossRate\": 123,\n  \"TakeProfitRate\": 123,\n  \"IsTslEnabled\": true,\n  \"IsNoStopLoss\": true,\n  \"IsNoTakeProfit\": true\n}")

	req, _ := http.NewRequest("POST", 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.post("https://public-api.etoro.com/api/v1/trading/execution/demo/market-open-orders/by-units")
  .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  \"InstrumentID\": 123,\n  \"IsBuy\": true,\n  \"Leverage\": 123,\n  \"AmountInUnits\": 123,\n  \"StopLossRate\": 123,\n  \"TakeProfitRate\": 123,\n  \"IsTslEnabled\": true,\n  \"IsNoStopLoss\": true,\n  \"IsNoTakeProfit\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://public-api.etoro.com/api/v1/trading/execution/demo/market-open-orders/by-units")

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

request = Net::HTTP::Post.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  \"InstrumentID\": 123,\n  \"IsBuy\": true,\n  \"Leverage\": 123,\n  \"AmountInUnits\": 123,\n  \"StopLossRate\": 123,\n  \"TakeProfitRate\": 123,\n  \"IsTslEnabled\": true,\n  \"IsNoStopLoss\": true,\n  \"IsNoTakeProfit\": true\n}"

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

{
  "orderForOpen": {
    "instrumentID": 100000,
    "amount": 0,
    "amountInUnits": 0.001,
    "isBuy": true,
    "leverage": 1,
    "stopLossRate": 0,
    "takeProfitRate": 0,
    "isTslEnabled": false,
    "mirrorID": 0,
    "totalExternalCosts": 0,
    "lotCount": 0,
    "orderID": 13906629,
    "orderType": 18,
    "statusID": 1,
    "CID": 7765437,
    "openDateTime": "2025-04-02T15:56:50.7496838Z",
    "lastUpdate": "2025-04-02T15:56:50.7496838Z"
  },
  "token": "43ceb769-cff6-45ec-8ad7-292b7401353f"
}

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:

"bb7b8762-b5e1-45ec-b17a-695d44129a2a"

Body

application/json

InstrumentID

integer<int32>

required

The unique identifier of the financial instrument to trade.

IsBuy

boolean

required

True for a long position, false for a short position.

Leverage

integer<int32>

required

The leverage multiplier for the trade.

AmountInUnits

number<double>

required

The number of units of the asset. Required if Amount is not provided. For most assets this can be a fractional number. Note that for Future Contracts this number should indicate the number of underlying units, and not the number of contracts, according to the formula: AmountInUnits = contract multiplier * number of contracts.

StopLossRate

number<double> | null

The stop-loss trigger price at which the position will generate a Market Order to close (after it was opened). StopLoss trigger price must be worse than current price.

TakeProfitRate

number<double> | null

The take-profit trigger price at which the position will generate a Market Order to close (after it has opened). TakeProfit trigger price must be better than the current price.

IsTslEnabled

boolean | null

Indicates if a trailing stop loss (TSL) is enabled. This means that the stoploss rate indicated will get updated automatically whenever the asset price increases (for long positions) or decreases (for short position) effectively keeping the stoploss in a constant gap from the best price achieved so far.

IsNoStopLoss

boolean | null

True if no stop-loss is set for this order.

IsNoTakeProfit

boolean | null

True if no take-profit is set for this order.

Response

Successfully opened a market order.

orderForOpen

object

Show child attributes

token

string<uuid>

A unique confirmation token for the order.

⌘I

Getting started

Guides

Core API

Deprecated

WebSocket API

Vibe Code

AI Agents

Changelog

Open demo market order by units

Authorizations

Headers

Body

Response