.TH TICK "1" "May 2018" "Tick 1.14.1" "User Commands"

.SH NAME
Tick - Command line stock and cryptocurrency portfolio tracker.

.SH SYNOPSIS
tick COMMAND [ARGUMENTS]

.SH DESCRIPTION
Create your portfolio by adding your current holdings. You can see information about your holdings with the command "check".
You may also see information about securities that you may not own with commands "info" and "news".

.SS
Portfolio:

.TP
[add/rm/set] [symbol/crypto_id/USD$] [quantity of shares] [USD spent/SharePriceEA]
Either adds, removes, or sets the amount of the given stock with respect to the given values. The parameter "add" will add
your input to the current portfolio, "rm" will subtract from your current portfolio, and "set" will set your portfolio to
the input, discarding any existing data about that security. Trading fees should be factored into "USD SPENT". As an exception,
cryptocurrencies must be specified by their name (e.g. "ripple", instead of "xrp"), due to duplicate tickers in both the
US stock market and the cryptocurrency market. You may also input as "usd$" for US Dollars. This is helpful for keeping
track of how much money is unallocated in your brokerage account. Typically, your initial amount of USD can be added as
"tick add USD$ [amount] [amount]", where [amount] is the same number. When you are paid dividends or capital gains that
are not reinvested into a specific security, you should update your portfolio with "tick add USD$ [dividend/capital gain amount] 0".
You may also specify the share price instead of the total amount you spent by appending "ea" to the end of the share price.

.TP
[check] [symbol/crypto_id/sort_option]
Prints information about your current portfolio holdings. To print all of your holdings alphabetically as well as a
grand total, no additional arguments besides "check" need to be used. Optionally, you may use the options "-a" to print
alphabetically, "-v" to print by value, "-p" to print by profit, "-1" to print by one day profit, or "-7" to print by
seven day profit. To print information about a single security, use the ticker or crypto id as an argument after "check".

.TP
[encrypt/decrypt]
Encrypts or decrypts your portfolio using the RC4 algorithm. Password must be 32 characters or less.

.SS
Security Information:

.TP
[info] [symbol]
Prints information on the given security. This includes company name, current and historical price, dividends, market cap,
and volume.

.TP
[graph] [symbol]
Prints a graph of the historic price of the given security. Cryptocurrencies aren't supported yet, due to API constraints.
You may press the UP arrow key to zoom in, the DOWN arrow key to zoom out, the LEFT arrow to pan left, the RIGHT arrow
to pan right, or the letter "q" to quit.

.TP
[news] [symbol]
Prints information on the top three news articles in the past 14 days. The article titles, sources, authors, dates, and URLs
will be displayed. If you would like to use a space in your search, you must either use an underscore instead of the space or wrap
your phrase in double quotes. Technically, the input may be something completely unrelated to investing. This may be amended
in the future.

.SH EXAMPLES
To add 3 shares of Tesla bought for $918.12 total, run
.RS
$ tick add tsla 3 918.12

.RE
You can also specify the price per share instead of total spent:
.RS
$ tick add tsla 3 306.04ea

.RE
To get info about your current holdings in a Tesla, run
.RS
$ tick check tsla

.RE
Or to get info about all your holdings, run
.RS
$ tick check

.RE
or to sort by value
.RS
$ tick check -v

.RE
To get the top three news articles on Tesla in the past two weeks, run
.RS
$ tick news tesla

.RE
To get information on Tesla, run
.RS
$ tick info tesla

.SH FILES
.I ~/.tick_portfolio.json
.RS
Portfolio file.

.RE
.I ~/.tick_portfolio
.RS
Portfolio file (legacy).

.SH GITHUB
Please report any bugs using the GitHub issue tracker:

https://github.com/aokellermann/tick/issues

.SH AUTHORS
Antony Kellermann -- https://github.com/aokellermann

.SH LICENSE
MIT License

Stock information is taken from IEX's free API. Mutual fund and over-the-counter
information is taken from Morningstar's free API. Cryptocurrency information
is taken from Coinmarketcap's free API. News information is taken from News
API. Shortened links are provided by Google's URL Shortener API. Please do
not abuse the APIs by repeatedly requesting information. Read the provided
license for more information.