TradeSearcher CLI

Query TradeSearcher strategies and backtests from your terminal or scripts.

Install

npm install -g @tradesearcher/cli

Authenticate

Create a key on your account page, then:

tradesearcher auth login
tradesearcher auth status

The key is stored at ~/.tradesearcher/config.json (mode 0600). You can also pass --api-key per command or set the TRADESEARCHER_API_KEY environment variable.

Common commands

tradesearcher search BTCUSD
tradesearcher best AAPL
tradesearcher backtest 12345 --details --trades --trade-limit 20
tradesearcher strategy 6789 --source
tradesearcher export 12345 --pine --out strategy.pine
tradesearcher compare 12345 67890

Sorting search results

tradesearcher search BTCUSD --sort sharpe
tradesearcher search BTCUSD --sort profitFactor
tradesearcher search BTCUSD --sort roi
tradesearcher search BTCUSD --sort latestTradeDate
tradesearcher search BTCUSD --sort robustness

tip

--equity can return large JSON arrays — use it only after narrowing to your final candidates.

Machine-readable schemas

For agents and scripts, print JSON command schemas:

tradesearcher schema
tradesearcher schema backtest
tradesearcher schema strategy

Source availability

search, best, and compare rows show source available, source no, or source private when TradeSearcher knows whether Pine source text is available. available means source text exists for this account — it does not guarantee the text is a complete standalone Pine strategy.

Export Pine source for a backtest's strategy:

tradesearcher export 12345 --pine --out strategy.pine

Free vs Premium

Free accounts hide high-performance backtests (profit factor above 3). Premium shows these stronger backtests, more results, recent trades, and full strategy details.

Upgrade to Premium