Etoro-cli

bun link
etoro help

Global CLI Usage

After running bun link, the etoro command is available outside this project folder.

The CLI reads configuration from environment variables. If you run etoro globally, make sure those variables are available in your shell.

Temporary exports for the current terminal session:

export ETORO_PUBLIC_KEY="your_public_key"
export ETORO_API_PRIVATE_KEY="your_user_key"
export ETORO_ENVIRONMENT="real"
export ETORO_DEFAULT_RESOLUTION="D"
export ETORO_DEFAULT_LOOKBACK_DAYS="250"
export ETORO_ENABLE_REAL_TRADING="false"

Then validate:

etoro health

Permanent exports for zsh:

nano ~/.zshrc

Add:

export ETORO_PUBLIC_KEY="your_public_key"
export ETORO_API_PRIVATE_KEY="your_user_key"
export ETORO_ENVIRONMENT="real"
export ETORO_DEFAULT_RESOLUTION="D"
export ETORO_DEFAULT_LOOKBACK_DAYS="250"
export ETORO_ENABLE_REAL_TRADING="false"

Reload your shell:

source ~/.zshrc
etoro health

Recommended safety practice: keep ETORO_ENABLE_REAL_TRADING=false globally. For a single real trading command, enable it inline:

ETORO_ENABLE_REAL_TRADING=true etoro buy TSLA \
  --amount 10 \
  --limit-price 420 \
  --stop-loss-rate 350 \
  --take-profit-rate 500 \
  --confirm-real \
  --i-understand-real-money

Recommended Command Flow

1. Check configuration and API connectivity:

bun run index.ts health

1. Validate the authenticated eToro session:

bun run index.ts whoami

1. Check account balance:

bun run index.ts balance

1. Inspect current portfolio:

bun run index.ts portfolio

1. List active or pending orders:

bun run index.ts orders

1. Analyze all open portfolio positions:

bun run index.ts analyze

1. Analyze one portfolio position:

bun run index.ts symbol TSLA

1. Scan symbols even if they are not in your portfolio:

bun run index.ts watchlist --symbols TSLA,AAPL,NVDA --provider etoro

1. Generate a daily report:

bun run index.ts daily

If you ran bun link, replace bun run index.ts with etoro.

Commands

Useful options:

etoro analyze --resolution D --candles 250
etoro symbol NVDA --resolution D --candles 250
etoro watchlist --symbols TSLA,NVDA,AMZN --provider etoro --resolution D --candles 250
etoro daily --candles 250

Technical Analysis

The analysis is calculated locally in TypeScript. eToro provides market data and historical candles; the CLI calculates indicators and applies local scoring rules.

Indicators:

The interpretation logic lives in:

src/domain/scoring.ts

Active Orders

Use:

etoro orders

This command only performs a GET request. It reads active order collections returned by:

GET /api/v1/trading/info/real/pnl
GET /api/v1/trading/info/demo/pnl

Collections inspected:

orders
stockOrders
entryOrders
exitOrders
ordersForOpen
ordersForClose
ordersForCloseMultiple

Trading Safety

Real trading is disabled by default.

To execute a real buy order, all of these must be true:

ETORO_ENABLE_REAL_TRADING=true
--confirm-real
--i-understand-real-money

Without those conditions, buy only prints a dry-run preview and the planned eToro payload.

Limit Buy Order Example

Dry-run, no real order:

ETORO_ENABLE_REAL_TRADING=false etoro buy TSLA \
  --amount 10 \
  --limit-price 420 \
  --stop-loss-rate 350 \
  --take-profit-rate 500 \
  --confirm-real \
  --i-understand-real-money

Real order, only if you intentionally enabled real trading:

etoro buy TSLA \
  --amount 10 \
  --limit-price 420 \
  --stop-loss-rate 350 \
  --take-profit-rate 500 \
  --confirm-real \
  --i-understand-real-money

The CLI will build a payload like:

{
  "InstrumentID": 1111,
  "IsBuy": true,
  "Leverage": 1,
  "Rate": 420,
  "Amount": 10,
  "StopLossRate": 350,
  "IsNoStopLoss": false,
  "TakeProfitRate": 500,
  "IsNoTakeProfit": false
}

Trading Endpoints

Implemented in the infrastructure layer:

sell remains dry-run in the CLI because safe selling should close by positionId, not only by symbol.

Development

Type-check:

bun run typecheck

Run a command locally:

bun run index.ts portfolio

Check Git status:

git status --short

Security Notes

• Never commit .env.
• Use read-only eToro keys for portfolio analysis.
• Use write-enabled eToro keys only if you intentionally need order execution.
• Test with ETORO_ENVIRONMENT=demo when possible.
• Treat every real trading command as real-money execution.