etoro-cli

The command-line Swiss Army knife for eToro trading automation

About

etoro-cli is a production-quality command-line interface for eToro trading automation. Built with safety-first principles and designed to be both human-friendly and agent-friendly (AI agents love the --json flag!).

Why etoro-cli?

Full Trading Capabilities: View account, place orders, manage positions, track portfolio
Agent-Friendly: JSON output mode for seamless integration with AI agents and scripts
Safety First: Kill switch, execution toggles, trade limits, and symbol allowlists
Comprehensive: 13 commands covering everything from price checks to risk analysis
Clean Output: Beautiful tables for humans, structured JSON for machines

Installation

Works on Linux, macOS, and Windows.

Pre-built Binaries (Fastest)

Download the latest release for your platform from the Releases page.

Linux / macOS:

# Linux (amd64)
curl -L https://github.com/lijinlar/etoro-cli/releases/latest/download/etoro-cli-linux-amd64.tar.gz | tar xz
sudo mv etoro-cli /usr/local/bin/

# macOS (Apple Silicon)
curl -L https://github.com/lijinlar/etoro-cli/releases/latest/download/etoro-cli-darwin-arm64.tar.gz | tar xz
sudo mv etoro-cli /usr/local/bin/

# macOS (Intel)
curl -L https://github.com/lijinlar/etoro-cli/releases/latest/download/etoro-cli-darwin-amd64.tar.gz | tar xz
sudo mv etoro-cli /usr/local/bin/

Windows (PowerShell):

# Download and extract
Invoke-WebRequest -Uri "https://github.com/lijinlar/etoro-cli/releases/latest/download/etoro-cli-windows-amd64.zip" -OutFile etoro-cli.zip
Expand-Archive etoro-cli.zip -DestinationPath .

Using Go Install

go install github.com/lijinlar/etoro-cli@latest

Building from Source

git clone https://github.com/lijinlar/etoro-cli.git
cd etoro-cli

# Current platform
make build

# All platforms (outputs to ./dist/)
make build-all

Quick Start

1. Create Configuration

cp config.example.yaml etoro.yaml

2. Add Your API Keys

Edit etoro.yaml:

etoro:
  public_key: "your-public-key"
  user_key: "your-user-key"

3. Check Your Account

etoro account

4. Ready to Trade?

First, disable the safety guards:

trading:
  execution_enabled: true
  kill_switch: false

Then execute with --confirm:

etoro buy AAPL --amount 100 --confirm

Command Reference

Command	Description	Example
`account`	Show account summary	`etoro account`
`price`	Get live prices	`etoro price AAPL TSLA`
`positions`	List open positions	`etoro positions --symbol AAPL`
`orders`	List pending orders	`etoro orders`
`buy`	Place buy order	`etoro buy AAPL --amount 100 --confirm`
`sell`	Place sell (short) order	`etoro sell TSLA --amount 200 --confirm`
`close`	Close position	`etoro close 12345 --confirm`
`cancel`	Cancel pending order	`etoro cancel 67890 --confirm`
`portfolio`	Portfolio snapshot	`etoro portfolio`
`watchlist`	Manage watchlist	`etoro watchlist --add GOOGL`
`history`	Trade history	`etoro history --from 2024-01-01`
`risk`	Risk dashboard	`etoro risk`
`search`	Search instruments	`etoro search bitcoin`

Global Flags

Flag	Description
`--config`	Path to config file
`--json`	Output as JSON (for agents/scripts)
`--dry-run`	Simulate without executing
`--verbose`	Show HTTP requests/responses

Agent Usage

etoro-cli is designed for seamless integration with AI agents and automation scripts. Use the --json flag for structured output.

JSON Output Examples

# Account info as JSON
etoro account --json

# Price data for parsing
etoro price AAPL TSLA --json | jq '.[] | {symbol, bid, ask}'

# Position data
etoro positions --json | jq '.[] | select(.pl > 0)'

Scripting Patterns

Check Position P&L

#!/bin/bash
PL=$(etoro positions --json | jq '[.[] | .pl] | add')
echo "Total unrealized P&L: $PL"

Automated Risk Check

#!/bin/bash
MARGIN=$(etoro risk --json | jq '.marginUtilization')
if (( $(echo "$MARGIN > 70" | bc -l) )); then
    echo "WARNING: High margin utilization!"
fi

Place Order with Confirmation

# Dry-run first
etoro buy AAPL --amount 100 --json

# If looks good, execute
ETORO_CONFIRM=1 etoro buy AAPL --amount 100

Exit Codes

Code	Meaning
0	Success
1	API error
2	Configuration error
3	Validation error

Configuration Reference

Configuration is loaded from:

Path specified by --config flag
./etoro.yaml (current directory)
~/.etoro/config.yaml (home directory)

Environment variables override config file values.

Full Configuration

Key	Env Variable	Description	Default
`etoro.public_key`	`ETORO_PUBLIC_KEY`	eToro public API key	(required)
`etoro.user_key`	`ETORO_USER_KEY`	eToro user API key	(required)
`etoro.base_url`	`ETORO_BASE_URL`	API base URL	`https://api.etoro.com`
`trading.execution_enabled`	`ETORO_EXECUTION_ENABLED`	Allow trade execution	`false`
`trading.kill_switch`	`ETORO_KILL_SWITCH`	Emergency stop all trading	`true`
`trading.max_trade_usd`	`ETORO_MAX_TRADE_USD`	Max USD per trade	`500`
`trading.max_positions`	-	Max concurrent positions	`10`
`trading.symbol_allowlist`	-	Allowed symbols (empty=all)	`[]`
`trading.default_leverage`	-	Default leverage	`1`
`output.format`	-	Output format (table/json)	`table`
`output.timezone`	-	Timestamp timezone	`local`

Safety Guardrails

etoro-cli implements multiple safety layers to prevent accidental trades:

1. Kill Switch

The nuclear option. When enabled, ALL trading operations fail immediately.

trading:
  kill_switch: true  # Default: ON

Error: Kill switch is active. Set kill_switch: false in config to enable trading.

2. Execution Toggle

Global toggle for actual trade execution.

trading:
  execution_enabled: false  # Default: OFF

When disabled, trading commands show dry-run previews only.

3. Maximum Trade Amount

Prevents accidentally large orders.

trading:
  max_trade_usd: 500  # Reject orders > $500

Error: order amount $1000.00 exceeds max_trade_usd limit of $500.00

4. Symbol Allowlist

Restrict trading to specific instruments.

trading:
  symbol_allowlist: ["AAPL", "GOOGL", "MSFT"]

Error: Symbol TSLA is not in the allowed list.

5. Confirmation Requirement

Trading commands require explicit confirmation:

# Dry-run (no --confirm)
etoro buy AAPL --amount 100

# Execute (with --confirm)
etoro buy AAPL --amount 100 --confirm

# Or via environment variable
ETORO_CONFIRM=1 etoro buy AAPL --amount 100

Examples

View Account Status

$ etoro account

+-------------------+------------+
| FIELD             | VALUE      |
+-------------------+------------+
| Login ID          | user123    |
| Balance           | $10,000.00 |
| Equity            | $12,500.00 |
| Margin            | $2,500.00  |
| Available Margin  | $10,000.00 |
| Unrealized P&L    | +$2,500.00 |
| Realized P&L Today| +$150.00   |
+-------------------+------------+

Check Prices

$ etoro price AAPL TSLA GOOGL

+--------+---------+---------+--------+--------------+----------+----------+
| SYMBOL | BID     | ASK     | SPREAD | DAILY CHANGE | HIGH     | LOW      |
+--------+---------+---------+--------+--------------+----------+----------+
| AAPL   | $178.50 | $178.55 | $0.05  | +1.25%       | $180.00  | $175.00  |
| TSLA   | $245.00 | $245.10 | $0.10  | -0.50%       | $250.00  | $242.00  |
| GOOGL  | $142.30 | $142.35 | $0.05  | +0.75%       | $143.00  | $141.00  |
+--------+---------+---------+--------+--------------+----------+----------+

Place a Buy Order

$ etoro buy AAPL --amount 500 --sl 170 --tp 190 --confirm

=== ORDER EXECUTED ===
Order ID:    12345
Position ID: 67890
Status:      FILLED

Risk Analysis

$ etoro risk

=== RISK DASHBOARD ===
! WARNING: Margin utilization above 70% !

Margin Utilization: 72.50%
Total Exposure:     $25,000.00
Available Margin:   $3,437.50

--- Exposure by Symbol ---
  TSLA     $10,000.00 (40.0%)
  AAPL     $8,000.00 (32.0%)
  GOOGL    $7,000.00 (28.0%)

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Disclaimer

This software is provided as-is. Trading involves risk of loss. The authors are not responsible for any financial losses incurred through the use of this software. Always test with small amounts first and use the safety guardrails appropriately.

Built with Go and caffeineee by LIJIN AR

Name		Name	Last commit message	Last commit date
Latest commit History 4 Commits
.github		.github
cmd		cmd
internal		internal
.gitignore		.gitignore
.goreleaser.yml		.goreleaser.yml
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
Makefile		Makefile
README.md		README.md
config.example.yaml		config.example.yaml
etoro-cli.exe		etoro-cli.exe
go.mod		go.mod
go.sum		go.sum
main.go		main.go

Folders and files

Latest commit

History

Repository files navigation

etoro-cli

About

Why etoro-cli?

Installation

Pre-built Binaries (Fastest)

Using Go Install

Building from Source

Quick Start

1. Create Configuration

2. Add Your API Keys

3. Check Your Account

4. Ready to Trade?

Command Reference

Global Flags

Agent Usage

JSON Output Examples

Scripting Patterns

Check Position P&L

Automated Risk Check

Place Order with Confirmation

Exit Codes

Configuration Reference

Full Configuration

Safety Guardrails

1. Kill Switch

2. Execution Toggle

3. Maximum Trade Amount

4. Symbol Allowlist

5. Confirmation Requirement

Examples

View Account Status

Check Prices

Place a Buy Order

Risk Analysis

Contributing

License

Disclaimer

About

Topics

Resources

License

Code of conduct

Contributing

Uh oh!

Stars

Watchers

Forks

Releases 1

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages