Whales Market is proud to announce the launch of the Whales Market CLI, a command-line interface that gives traders and developers direct access to the platform from their own terminal environment. With this release, users can interact with pre-market tokens, order books, wallet management, portfolio tracking, and more without opening a browser, switching tabs, or relying on a graphical interface of any kind. The only requirement is a machine with Node.js installed.
This is not a peripheral quality-of-life addition. The Whales Market CLI is a new interface layer built from scratch for users who operate with a higher degree of precision and automation, and its release reflects the platform's ongoing commitment to expanding access beyond the standard web trading experience.
The problem with browser-only trading
The web interface serves the majority of users well. However, a growing segment of the Whales Market community operates under conditions where a browser-based workflow introduces meaningful friction.
- These are traders who monitor multiple pre-TGE opportunities simultaneously and need fast data retrieval without navigating across tabs.
- These are developers who want to pipe order book data directly into their own scripts and automation pipelines.
- These are power users who require JSON output rather than rendered HTML, and who build workflows that depend on consistent, predictable data access.
For all of them, the browser creates overhead that accumulates with every session.
Every market lookup requires manual navigation through the interface. Every data pull is a discrete action with no straightforward path to integration or automation. Building a custom API client to work around these limitations is possible, but it is a significant investment for something that should be readily available.
The Whales Market CLI addresses this gap directly.
Introducing the Whales Market CLI
The Whales Market CLI is an open-source tool built in TypeScript that connects directly to the Whales Market API. After a single installation via npm, running whales setup provides full platform access from any terminal environment.
The tool supports both Solana and EVM chains, including Ethereum, BSC, and Polygon. Output defaults to clean, readable tables with all relevant data fields visible at a glance. Every command also accepts a --format json flag, making it straightforward to pipe output into tools like jq or integrate it into downstream automation. The design follows standard Unix philosophy: focused commands, predictable stdout, and an interface that does not interfere with scripting.
The repository is public at github.com/whalemarketdev/whale-market-cli. Node.js 18 or higher is the only dependency.
What the Whales Market CLI can do
Wallet Management without leaving the Terminal
Users can generate a new Solana or EVM wallet, import an existing one using a private key, and link multiple wallet addresses within a single session. Configuration is written to a local file at a platform-specific path, ensuring that wallet settings and API preferences persist across sessions without requiring repeated setup.
Pre-Market token discovery
Running whales tokens list returns a live table of active pre-market tokens, each displaying Implied FDV and 24-hour volume. Results can be filtered by status, sorted by price, volume, or creation date, and narrowed by name or symbol.
For traders monitoring several pre-TGE opportunities at once, this command consolidates what would otherwise require multiple browser interactions into a single, scriptable operation.
The --no-fdv and --no-volume flags allow further simplification of the output when only symbols and prices are needed.
Order Book per Token
whales book MEGA retrieves the live order book for a given token, including buy and sell orders, spread, fill status, and match type. Depth is configurable via --depth, chain can be specified with --chain-id, and output can be exported to JSON for any downstream processing.
Traders looking to assess liquidity before entering an offer will find this command a more efficient alternative to navigating the web interface, as it surfaces the same information in a single terminal call.
Offer and Order Management
All open offers across the platform are accessible with filtering by buy or sell side. Users can review their own active offers and orders through dedicated commands, retrieve full detail records for any specific offer via whales offers get <offer-id>, and pull order history associated with their active offers using whales orders by-offer <address>.
This provides a complete and auditable view of trading activity, accessible entirely from the terminal.
Portfolio Tracking
whales portfolio show returns a summary of current holdings and open positions.
- Users can drill into specific position states with whales portfolio positions, or check balances at the token level with whales portfolio balance.
- The --address flag allows any wallet address to be inspected, which is particularly useful for users managing activity across multiple wallets.
Referral System from the Terminal
Referral campaign data, earnings summaries, and transaction history are all accessible directly through the CLI. For users running active referral programs, this removes the need to log into the web interface for routine reporting and reconciliation tasks.
Getting Started with the Whales Market CLI
The setup process is designed to be completed in under two minutes. Node.js 18 or higher is the only prerequisite. To verify the installed version, run node --version in the terminal before proceeding.
Step 1: Install
The recommended installation path is npm:
npm install -g whale-market-cli
Alternatively, a shell installer is available for users who prefer to bypass npm:
curl -fsSL https://raw.githubusercontent.com/whalemarketdev/whale-market-cli/main/install.sh | bash
Step 2: Run the Setup Wizard
Once installed, the interactive setup wizard handles initial configuration in a single flow:
whales setup
The wizard covers three steps:
- Wallet creation or import using an existing private key
- API endpoint configuration, which defaults to api.whales.market
- Local configuration file creation for session persistence
Configuration is saved to:
- ~/Library/Preferences/whales-market-cli/config.json on macOS.
- ~/.config/whales-market-cli/config.json on Linux.
- %APPDATA%\whales-market-cli\config.json on Windows.
Step 3: Run Your First Commands
With configuration in place, the full platform is accessible from the terminal. The following commands cover the most common use cases:
# Browse active pre-market tokens
whales tokens list --status active --sort vol
# View the order book for a token
whales book MEGA --depth 10
# Check your open offers
whales offers my --status open
# View your portfolio summary
whales portfolio show
For developers integrating Whales Market data into external tools or automated workflows, JSON output is available across all commands:
whales tokens list --format json | jq '.[0].name'
whales book MEGA --format json | jq '.sell_orders'
Built for power users, Open to everyone
The Whales Market CLI is designed as an extension of the platform, not a replacement for the web interface. Users who prefer browser-based trading can continue using the web app exactly as before, with no changes to their existing workflow.
For traders who prioritize speed and precision, developers who need composable and scriptable data access, and power users who want to build automation around the Whales Market platform, the CLI provides the tooling to do so. It is open-source, actively maintained, and open to community contributions through the public GitHub repository. The team will continue expanding the capabilities of the Whales Market CLI as the platform evolves.
The Whales Market CLI is available now. To get started, run the following command and follow the setup wizard:
npm install -g whale-market-cli