Skip to main content

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 can run searches without a search-count limit, with limited result sets and details. Premium expands the returned results and unlocks the full details available to the account.

Upgrade to Premium