REQUIREMENTS:
Ruby 1.9.2
http://www.ruby-lang.org/en/downloads/

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


INSTALLATION:

Unpack the tarball.
'cd' into the new btctrade directory.
Run the command './install'.


USAGE:

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

This program requires the file 'trades.csv' to be in the working directory. To
obtain this file, go to <http://www.bitcoinwatch.com/> and click on "historical
data" at the bottom of the page. Save the file and run the following command:

$ unzip trades.zip

'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.


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. I am also undecided as to
whether or not to support JSON data from
<http://91.194.85.252/about/markets-api/>.

* Error handling.
* 'info' page.
* Accept an 'e' argument followed by a second date. This would indicate the end
of the period.
* Automatically unzip 'trades.zip'. Check timestamps before unzipping, if
applicable.

Future options:
-h/--help
-v/--version
-c/--csv: Suppress normal output. Standard output will be a CSV file which
includes all trades for the period with the datetime converted to a human-
readable date. (This would restore the behavior of version 0.1.0.)
-d/--directory: Location of 'trades.csv' or 'trades.zip'.
-s/--separate: Separate currencies by looking at the entire 'currency' field,
instead of just the last 3 letters.
