Skip to main content

Documentation Index

Fetch the complete documentation index at: https://api-portal.etoro.com/llms.txt

Use this file to discover all available pages before exploring further.

Available cash represents the funds you have available to open new positions. It is calculated by taking your total credit and subtracting the sum of all pending order amounts.
Available cash only refers to your USD balance.
To retrieve the data needed for this calculation, use the P&L endpoint for either demo or real accounts.

​
The Calculation Process

Calculating available cash involves fetching your account data and performing a simple subtraction of all pending order amounts from your total credit.

​
1. Endpoints

Use the P&L endpoint to retrieve your account information. Demo Account: GET https://public-api.etoro.com/api/v1/trading/info/demo/pnl Real Account: GET https://public-api.etoro.com/api/v1/trading/info/real/pnl

​
2. Header Requirements

Remember to include your authentication headers with every request.
  • x-api-key
  • x-user-key
  • x-request-id

​
3. Calculation Formula

Available Cash = credit - (Σ(ordersForOpen[i].amount where mirrorID = 0) + Σ(orders[i].amount))
Where:
  • credit is the total credit balance in your account
  • ordersForOpen is an array of pending market orders (filtered to only include manual positions where mirrorID = 0)
  • orders is an array of pending Market-if-touched orders (similar to Limit orders)
  • mirrorID = 0 indicates a manual position; mirrorID ≠ 0 indicates a mirrored (copy) position
  • amount is the allocated amount for each order

​
Examples

curl -X GET "https://public-api.etoro.com/api/v1/trading/info/demo/pnl" \
  -H "x-api-key: <YOUR_PUBLIC_KEY>" \
  -H "x-user-key: <YOUR_USER_KEY>" \
  -H "x-request-id: <UUID>"

​
Example Calculation

If your account has:
  • credit: 1000
  • ordersForOpen: Two manual pending orders with amount values of 200 each (where mirrorID = 0), and one mirrored order with amount of 100 (where mirrorID ≠ 0)
  • orders: One existing order with amount value of 150
Then your available cash would be: 
1000 - ((200 + 200) + 150) = 450
Note: The mirrored order with amount 100 is excluded from the calculation because mirrorID ≠ 0.

​
Best Practices

  1. Check Before Trading: Always verify your available cash before attempting to open new positions to avoid insufficient funds errors.
  2. Account for Manual Orders Only: Only manual positions (where mirrorID = 0) from ordersForOpen are included in the calculation. Mirrored (copy) positions are excluded. All items in the orders array are included regardless of mirrorID.
  3. Use the Correct Environment: Make sure to use the demo endpoint when testing and the real endpoint for live trading.