Practical overview
When it fits
Use Coinx when a terminal workflow for comparing prices or checking configured exchange balances is useful, or when placing a confirmed purchase through a supported exchange. Its purchase workflow assumes BTC is available for spending.
Who it is for
- CLI users who want to compare prices across Coinx's named exchanges.
- Crypto holders who need to check balances across configured exchange accounts.
- Users who want to make confirmed coin purchases from the terminal or automate a multi-coin buying action.
Documented uses
- Compare a coin's quoted prices across exchanges and view an average.
- Check exchange balances, optionally filtering by exchange or coin.
- Buy a coin using a chosen exchange or the best rate Coinx finds.
- Set up a bulk-buy action with a per-coin spend amount, coin count and exclusions.
- Encrypt or decrypt the local exchange API-key file.
Requirements & limits
Coinx is distributed as a public GitHub repository under the MIT license. The README documents global installation through npm.
- Exchange API keys must be obtained separately and configured in Coinx.
- The README places the JSON credentials file in the operating-system home directory and provides commands to encrypt and unlock it.
- Purchases spend BTC, even when the requested amount is expressed in dollars.
- The README names five supported exchanges.
- The README's sell section says selling is coming soon, so it does not document a sell workflow.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Install and configure Coinx for an exchange
Install the CLI and save API credentials for a supported exchange.
Before you start
- npm
- API key and secret obtained directly from a supported exchange
Steps
Install Coinx globally with the command below.
npm install -g coinxRun
coinx configwith the exchange name, then enter its API key and secret.
Expected outcome
Coinx saves the exchange configuration as a JSON file in a coinx directory under the operating-system home folder.
Guide limitations
- The README says users must obtain exchange API keys manually.
- The documented configuration file contains API keys and secrets; encryption and decryption commands are provided separately.
Compare prices and make a confirmed coin purchase
Review exchange prices and submit a purchase through a configured exchange.
Before you start
- Coinx installed and an exchange configured with API keys
- Sufficient BTC available on the exchange used for the purchase
Steps
Use
coinx pricewith a coin symbol to view prices across exchanges.Run
coinx buywith the coin symbol and dollar amount; specify an exchange if you do not want Coinx to select the best rate.Review the proposed order and confirm it when prompted.
Expected outcome
Coinx submits the confirmed purchase and records purchase results in `{home folder}/coinx/log.csv`.
Guide limitations
- The README says BTC is what is actually spent, so the exchange account needs sufficient BTC.
- The number of coins may change slightly as the market fluctuates.
- Selling is listed as coming soon in the README.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 17 October 2026
- Original website title
- johntitus/coinx · Official homepage title · retained in its source language

