REQUIREMENTS:
Python 3.2	http://www.python.org/download/releases/3.2/

'btctrade' was written on a GNU operating system, but it should be able to run
on any system that runs Python 3.2 or higher.


INSTALLATION:

Unpack the tarball.
'cd' into the new btctrade directory.
Run the command 'sudo ./setup.py install'. (You may need to specify the python
interpreter, i.e. 'sudo python3.2 setup.py install'.)


USAGE:

btctrade [year [month [day [hour [minute [second]]]]]]

This program requires an internet connection. If you don't have one, use the
'-o' option. However, the required data files are only available online.

'btctrade' analyzes the trade history for a given period and outputs the high,
low, and average prices, in bitcoins, for every known currency in that period.
The arguments are all integers and indicate the period to analyze. The length of
the period is determined by the number of arguments. With no arguments, look at
the entire history. With 1 argument, look at the entire year. With 2 arguments,
look at the entire month, and so on.


OPTIONS:

-V
--version
Show program's version number and exit.

-c CURRENCY
--currency CURRENCY
Only display data for the specified currencies. CURRENCY is a comma separated
list of currency codes. These codes are always in all caps and are usually ISO
codes. 'btctrade' displays a currency code as a header for each set of stats.

-h
--help
Auto-generated help message. Not finished, yet.

-m MARKET
--market MARKET
Like '-c', but for individual market symbols. To see all available markets, run
'btctrade -s'. It doesn't make much sense to use both '-c' and '-m', since each
market symbol only uses a single currency. If you do use both options, btctrade
will only include those specified markets that use one of the specified
currencies.

-o
--offline
Don't download anything. The data files for individual markets must have been
downloaded from previous usage of btctrade. Use this option if you don't
currently have an internet connection.

-s
--separate
Treat each market as a separate currency.


BACKGROUND INFO:

Bitcoin is an electronic currency which does not require the management of any
central authority. It relies on cryptography and a peer-to-peer network to
maintain scarcity. It is decentralized, yet stable, which makes it the ideal
replacement for common government currencies. See <http://www.bitcoin.org/> for
more information. It is my hope that 'btctrade' may do its part to help the
world migrate to this new currency.


TO SUPPORT THIS PROJECT:

To support development of 'btctrade', please send donations to this address:
15fC1t6t3zPVAWNEB3MPg8kyjBr8ZNENuT.

To submit patches or bug reports, go to
<https://savannah.nongnu.org/projects/btctrade>.


TODO:

I am currently undecided as to the final feature set of 'btctrade', therefore
future versions may not be backward compatible.

* More error checking.
* 'info' page.
* Accept an 'e' argument followed by a second date. This would indicate the end
of the period.

Future options:
-h/--help: Real help messages, instead of being auto-generated.
