trading212-cli

name	trading212-cli
description	Manage Trading 212 portfolio via CLI - account summary, cash, positions, orders, historical orders, dividends, transactions, instruments search, CSV reports, and investment pies. Use when the user mentions Trading 212, portfolio, positions, P&L, dividends, trading orders, or investment pies.
category	finance

trading212-cli

CLI for the Trading 212 Public API. Manage portfolio, orders, positions, and history.

Auth is pre-configured. Always use --json when calling programmatically.

Resources

account

Action	Command	Key Flags
Get summary	trading212-cli account summary	--json, --format

Returns: account ID, currency (USD), totalValue, cash (availableToTrade, reservedForOrders, inPies), investments (currentValue, totalCost, realizedProfitLoss, unrealizedProfitLoss).

positions

Action	Command	Key Flags
List all	trading212-cli positions list	--json, --ticker <t>, --sort <field>, --fields

Sort options: ticker, quantity, pnl, value. Each position includes instrument info, quantity, averagePricePaid, currentPrice, and walletImpact (totalCost, currentValue, unrealizedProfitLoss, fxImpact).

orders

Action	Command	Key Flags
List pending	trading212-cli orders list	--json, --fields
Get by ID	trading212-cli orders get <id>	--json
Place market	trading212-cli orders market	--ticker, --quantity, --extended-hours, --json
Place limit	trading212-cli orders limit	--ticker, --quantity, --limit-price, --time-validity, --json
Place stop	trading212-cli orders stop	--ticker, --quantity, --stop-price, --time-validity, --json
Place stop-limit	trading212-cli orders stop-limit	--ticker, --quantity, --stop-price, --limit-price, --time-validity, --json
Cancel	trading212-cli orders cancel <id>	--json

Important: Quantity is positive for BUY, negative for SELL. Time validity: DAY or GOOD_TILL_CANCEL. Tickers use Trading 212 format (e.g. AAPL_US_EQ). Use instruments list --search to find tickers.

instruments

Action	Command	Key Flags
List all	trading212-cli instruments list	--json, --type <STOCK|ETF|...>, --search <query>, --fields
List exchanges	trading212-cli instruments exchanges	--json

history

Action	Command	Key Flags
Historical orders	trading212-cli history orders	--json, --limit, --cursor, --ticker, --all
Dividends	trading212-cli history dividends	--json, --limit, --cursor, --ticker, --all
Transactions	trading212-cli history transactions	--json, --limit, --cursor, --time <ISO>, --all
Request CSV	trading212-cli history request-report	--from <ISO>, --to <ISO>, --include-orders, --include-dividends, --include-transactions, --include-interest
List reports	trading212-cli history reports	--json

Use --all to auto-paginate and fetch everything. Max 50 items per page.

pies

Action	Command	Key Flags
List all	trading212-cli pies list	--json
Get details	trading212-cli pies get <id>	--json
Create	trading212-cli pies create	--name, --instruments <json>, --goal, --dividend-action, --json
Update	trading212-cli pies update <id>	--name, --instruments <json>, --goal, --json
Delete	trading212-cli pies delete <id>	--json
Duplicate	trading212-cli pies duplicate <id>	--name, --json

Instruments JSON format: '{"AAPL_US_EQ":0.5,"MSFT_US_EQ":0.5}' (ticker: share weight).

Quick Reference

trading212-cli --help
trading212-cli <resource> --help
trading212-cli <resource> <action> --help

Output Format

With --json: { "ok": true, "data": ..., "meta": { "total": N } }

Other formats: --format text (default tables), --format csv, --format yaml

Rate Limits

• Account summary: 1 req / 5s
• Positions: 1 req / 1s
• Pending orders: 1 req / 5s
• Market order: 50 req / 1min
• Limit/stop/stop-limit: 1 req / 2s
• Cancel order: 50 req / 1min
• Historical data: 6 req / 1min
• Instruments: 1 req / 50s
• Exchanges: 1 req / 30s
• Reports: 1 req / 1min (list), 1 req / 30s (request)
• Pies: 1 req / 5s (CRUD), 1 req / 30s (list)

The CLI has built-in retry on 429 (rate limit) with backoff.

Auth

Pre-configured. To re-set: trading212-cli auth set "API_KEY:API_SECRET"

Token stored at ~/.config/tokens/trading212-cli.txt (chmod 600). Uses HTTP Basic auth.