Plnxr NPM | npm.io

plnxr

Command line interface for trading on poloniex.

Features

plnxr accepts percentages for buy/sell amounts and for buy/sell prices. This way, you don't have to type in an exact decimal value for anything.
The rates that plnxr uses for the calculations are refreshed on every command. If you make a buy, it uses the lowest ask price in that instant of time. If you make a sell, it uses the highest bid price.
The list, balance, and order commands display in nice colored and formatted tables with several sorting options
This command saves alot of time. If you add your api keys to the environmental variables, you will rarely have to login to poloniex.
There is a --dryRun option for both buying and selling. This means you can use it for estimations and calculations as well as testing the commands before you run them.

Installation

Prerequisite

Have Node.js installed

npm install -g plnxr
plnxr --help

Configuration

plnxr looks for your api key and secret in the environmental variables On Windows it's easiest to create an environmental variable for POLONIEX_API_KEY and POLONIEX_API_SECRET under your current user. You will have to restart your computer to have the environmental variables work in Windows.

in linux, add the following lines to the end of your .bashrc or .zshrc

export POLONIEX_API_KEY=your-api-key
export POLONIEX_API_SECRET=myreallylongsecret

Commands

plnxr balance args

lists your balances
alias: bal
example: plnxr bal

plnxr list currency

lists all markets for a currency
alias: ls
example: plnxr ls (defaults to BTC)
list eth markets: plnxr ls eth

plnxr buy args

buy some coins
example plnxr buy btc-eth -p 10 use 10% of your bitcoin reserves to buy ethereum
example plnxr buy btc-eth -t 0.5 -r 0.09518962 buy 0.5 btc worth of ethereum at a rate of 0.09518962
example plnxr buy btc-eth -a 4.2 -r 0.09518962 -d buy 4.2 ethereum a rate of 0.09518962 as a dry run
example plnxr buy btc-eth -t 0.5 -l 10 -d buy 0.5 btc worth of ethereum a rate of 10% lower than the current ask price
example plnxr buy --help get help for the buy command

plnxr sell args

sell some coins
example plnxr sell btc-eth -p 10 sell 10% of your etherium back to bitcoin at highest bid
example plnxr sell btc-eth -p 10 -l 20 sell 10% of your etherium back to bitcoin at 20% higher than highest bid

plnxr orders args

list open orders
alias: ord
example plnxr ord

plnxr cancel args

cancel open orders
alias: rm
example plnxr rm 45234523

plnxr --help

show the help menu

Disclaimer

This is a dangerous command! Use it at your own risk! I am not responsible for the trades this program makes!
You should always run it with the --dryRun argument first to get an estimate on your trade.
I have thouroughly tested these commands with all their options and everything seems fine to me, but if you find an issue, feel free to submit it =)
If you have any suggestions, feel free to submit them too!