Skip to main content
POST
/
api
/
v2
/
trading
/
info
/
costs
curl --request POST \
  --url https://public-api.etoro.com/api/v2/trading/info/costs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-request-id: <x-request-id>' \
  --header 'x-user-key: <x-user-key>' \
  --data '
{
  "action": "open",
  "transaction": "buy",
  "instrumentId": 101,
  "settlementType": "cfd",
  "orderType": "mkt",
  "leverage": 2,
  "amount": 1000,
  "orderCurrency": "usd"
}
'
{
  "instrumentId": 101,
  "symbol": "AAPL",
  "costs": [
    {
      "costType": "markup",
      "amount": 0.15,
      "currency": "USD"
    },
    {
      "costType": "marketSpread",
      "amount": 0.03,
      "currency": "USD"
    },
    {
      "costType": "transactionFee",
      "amount": 1,
      "currency": "USD"
    },
    {
      "costType": "overnightFee",
      "amount": 0.25,
      "currency": "USD"
    },
    {
      "costType": "overWeekendFee",
      "amount": 0.75,
      "currency": "USD"
    },
    {
      "costType": "sdrt",
      "amount": 0.5,
      "currency": "USD"
    }
  ],
  "lastUpdated": "2026-05-25T08:30:00Z"
}

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:

"bd64d775-81fe-41f6-9e0f-e3960d256b65"

​
x-api-key
string<password>
required

API key for authentication.

Example:

"lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663"

​
x-user-key
string<password>
required

User-specific authentication key.

Example:

"eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_"

Body

application/json

Request payload for creating an order to open or close a position.

​
action
enum<string>
required

The order action type. Possible values: open, close.

Available options:
open,
close
Example:

"open"

​
transaction
enum<string>
required

The transaction direction. Possible values: buy, sell, sellShort, buyToCover.

Available options:
buy,
sell,
sellShort,
buyToCover
Example:

"buy"

​
symbol
string | null

The asset ticker symbol. For open orders provide exactly one of symbol or instrumentId - providing both is rejected.

Example:

"AAPL"

​
instrumentId
integer<int32> | null

The eToro instrument identifier. For open orders provide exactly one of symbol or instrumentId - providing both is rejected.

Example:

101

​
settlementType
enum<string> | null

The settlement type. Possible values: cfd, real, realFutures, marginTrade. Required for open orders.

Available options:
cfd,
real,
realFutures,
marginTrade
Example:

"cfd"

​
orderType
enum<string>

The order execution type. Possible values: mkt (market), mit (market if touched).

Available options:
mkt,
mit
Example:

"mkt"

​
triggerRate
number<double> | null

The trigger rate for mit orders. Required for mit orders.

​
leverage
integer<int32> | null

The leverage multiplier to apply. Required for open orders.

Example:

2

​
amount
number<double> | null

The monetary amount to invest in the order currency. Mutually exclusive with units and contracts.

Example:

1000

​
orderCurrency
string | null

The currency for the order amount. Typically usd.

Example:

"usd"

​
units
number<double> | null

The number of units to trade. Mutually exclusive with amount and contracts.

​
contracts
number<double> | null

The number of contracts to trade. Mutually exclusive with amount and units.

​
stopLossRate
number<double> | null

The stop-loss rate at which the position will automatically close.

Example:

1.2

​
takeProfitRate
number<double> | null

The take-profit rate at which the position will automatically close.

Example:

1.5

​
stopLossType
enum<string> | null

The stop-loss type. Possible values: fixed, trailing.

Available options:
fixed,
trailing
Example:

"fixed"

​
additionalMargin
number<double> | null

Additional margin to allocate to the position.

​
positionIds
integer<int64>[] | null

List of position IDs to close. Required for close orders.

Response

Cost breakdown resolved successfully.

Cost breakdown for a hypothetical open or close order.

​
instrumentId
integer<int32>

Identifier of the instrument the cost breakdown applies to.

​
symbol
string | null

Symbol of the instrument

​
costs
object[]

Cost components that would apply to the proposed order.

​
lastUpdated
string<date-time>

Timestamp (ISO 8601) at which the cost figures were generated.