h1. WebService::MtGox - a Perl interface to MtGox's BitCoin trading API h2. What is BitCoin? Bitcoin is a peer-to-peer currency. Peer-to-peer means that no central authority issues new money or tracks transactions. These tasks are managed collectively by the network. I have a feeling that this might be a real game changer, and it will be very interesting to see how governments and banks react to this new liberatory technology. h2. What is MtGox? "MtGox":https://mtgox.com/ is currently (as of June 2011) the most heavily traded BitCoin market. They have been kind enough to provide an API that lets you automate your trading. h2. Some Sample Code This is a fairly straight-forward expression of "MtGox's Trading API":https://mtgox.com/support/tradeAPI . use common::sense; use WebService::MtGox; my $m = WebService::MtGox->new(user => 'me', password => 's3cr3t'); my $depth = $m->depth; my $buy = $m->buy(amount => 10, price => 30.9999); my $sell = $m->sell(amount => 10, price => 34.54321); h2. The Command Line Client This module comes with a command line client called *mg* that lets you get market data and initiate trades. If you're a command line junky, you'll find it quite convenient. Usage: mg [OPTION]... Options: ticker Get ticker. depth Get trading depth. trades Get recent trades. balance Get your balance. buy Buy some bitcoins. --amount=NUMBER --price=NUMBER sell Sell some bitcoins. --amount=NUMBER --price=NUMBER ls list List your orders. cancel Cancel an order. --oid=ID The order id. --type=NUMBER The type may be 1 for buy or 2 for sell. send Send bitcoins from your MtGox account to a bitcoin address. --amount=NUMBER --address=BITCOIN_ADDRESS usd [BITCOINS] Display the total value of your balance in US Dollars. You can also use this to find the value of an arbitrary amount of bitcoins in US Dollars. # How much is 1000 btc worth in US Dollars? mg usd 1000 btc [USD] Display the total value of your balance in bitcoins. You can also use this to find the value of an arbitrary amount of US Dollars in bitcoins. # How much is $400 worth in bitcoins? mg btc 400