bitstampede 0.0.1

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format=documentation

data/.rvmrc

@@ -0,0 +1 @@
+rvm 1.9.3@bitstampede --create

data/.travis.yml

@@ -0,0 +1,3 @@
+language: ruby
+rvm:
+  - 1.9.3

data/Gemfile

@@ -0,0 +1,8 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in bitstampede.gemspec
+gemspec
+
+group :test do
+  gem 'coveralls', require: false
+end

data/LICENSE.md

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Josh Adams
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,77 @@
+# Bitstampede
+[![Build Status](https://travis-ci.org/isotope11/bitstampede.png?branch=master)](https://travis-ci.org/isotope11/bitstampede) [![Coverage Status](https://coveralls.io/repos/isotope11/bitstampede/badge.png?branch=master)](https://coveralls.io/r/isotope11/bitstampede?branch=master) [![Code Climate](https://codeclimate.com/github/isotope11/bitstampede.png)](https://codeclimate.com/github/isotope11/bitstampede)
+
+
+Bitstampede is a gem for accessing the Bitstamp API
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'bitstampede'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install bitstampede
+
+## Usage
+
+First, look at this picture:
+
+![Legitimate Concern](./doc/legitimate_concern.png)
+
+Second, stop writing api clients that are configured with class ivars ಠ_ಠ
+
+Third, this stuff:
+
+## Actual Usage Without Silly Pictures
+
+```ruby
+client = Bitstampede::Client.new
+
+# I am sad for the following, but such is Bitstamp at present :-\
+client.key = 'YOUR_USER_ID'
+client.secret = 'YOUR_PASSWORD'
+
+# Fetch your balance
+client.balance
+# => #<Bitstampede::Entities::Balance:0x0000000259f338 @usd_balance=#<BigDecimal:259e898,'0.0',9(9)>, @btc_balance=#<BigDecimal:2726698,'0.0',9(9)>, @usd_reserved=#<BigDecimal:2726328,'0.0',9(9)>, @btc_reserved=#<BigDecimal:2725fb8,'0.0',9(9)>, @usd_available=#<BigDecimal:2725c48,'0.0',9(9)>, @btc_available=#<BigDecimal:27258b0,'0.0',9(9)>, @fee=#<BigDecimal:2725540,'0.0',9(9)>>
+
+client.orders
+#=> [
+  #<Bitstampede::Entities::Order:0x000000027302d8 @id=0, @datetime=0, @type=:buy, @price=#<BigDecimal:272f428,'0.0',9(9)>, @amount=#<BigDecimal:272f130,'0.0',9(9)>>
+]
+
+# Place a limit order to buy one bitcoin for $100.00 USD
+client.buy!(BigDecimal('1'), BigDecimal('100'))
+
+# Place a limit order to sell one bitcoin for $101.00 USD
+client.sell!(BigDecimal('1'), BigDecimal('101'))
+
+# Cancel order #1234
+client.cancel 1234
+```
+
+## Examples
+
+You can run any of the examples in the `example` dir by just executing the script (except `example/example.rb`, which is the base example class).  For instance, to see your balance, do the following:
+
+```ruby
+ruby example/balance.rb
+```
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+## License
+
+This software is licensed under [the MIT License.](./LICENSE.md)

data/Rakefile

@@ -0,0 +1,13 @@
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+
+Bundler::GemHelper.install_tasks
+
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bitstampede.gemspec

@@ -0,0 +1,30 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'bitstampede/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "bitstampede"
+  spec.version       = Bitstampede::VERSION
+  spec.authors       = ["Josh Adams"]
+  spec.email         = ["josh@isotope11.com"]
+  spec.description   = %q{This is a client library for the Bitstamp API that supports instantiating multiple clients in the same process.}
+  spec.summary       = %q{Fantastic bitstamp library.}
+  spec.homepage      = "http://github.com/isotope11/bitstampede"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency 'httparty'
+  spec.add_dependency 'multi_json'
+  spec.add_dependency 'yajl-ruby'
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec", '2.14.0.rc1'
+  spec.add_development_dependency "fakeweb"
+  spec.add_development_dependency "pry"
+end

data/example/balance.rb

@@ -0,0 +1,5 @@
+require_relative './example'
+
+Example.new do |client|
+  client.balance
+end

data/example/example.rb

@@ -0,0 +1,48 @@
+require_relative '../lib/bitstampede'
+require 'pry'
+
+class Example
+  def initialize &block
+    validate_env_vars
+    client = Bitstampede::Client.new
+    client.key = key
+    client.secret = secret
+    output block.call(client).inspect
+  end
+
+  private
+  def validate_env_vars
+    print_env_var_message if missing_either_var?
+  end
+
+  def missing_either_var?
+    key.nil? || secret.nil?
+  end
+
+  def key
+    ENV["BITSTAMP_KEY"]
+  end
+
+  def secret
+    ENV["BITSTAMP_SECRET"]
+  end
+
+  def print_env_var_message
+    output <<-MSG
+      These examples assume that you have two env vars defined:
+
+      BITSTAMP_KEY (which would be your user id)
+
+      and
+
+      BITSTAMP_SECRET (which would be your password)
+
+      You don't appear to.  Rectify that, mnkay?
+    MSG
+    exit(1)
+  end
+
+  def output(message)
+    STDOUT.puts message
+  end
+end

data/example/query_orders.rb

@@ -0,0 +1,5 @@
+require_relative './example'
+
+Example.new do |client|
+  client.orders
+end

data/lib/bitstampede/client.rb

@@ -0,0 +1,46 @@
+require_relative 'net'
+require_relative 'mapper'
+require 'bigdecimal/util'
+
+module Bitstampede
+  class Client
+    attr_accessor :key
+    attr_accessor :secret
+
+    def initialize
+    end
+
+    def balance
+      mapper.map_balance(net.post("balance"))
+    end
+
+    def orders
+      mapper.map_orders(net.post("open_orders"))
+    end
+
+    def buy!(price, amount)
+      trade!("buy", price, amount)
+    end
+
+    def sell!(price, amount)
+      trade!("sell", price, amount)
+    end
+
+    def cancel(id)
+      mapper.map_cancel(net.post("cancel_order", { id: id.to_s }))
+    end
+
+    private
+    def net
+      @net ||= Net.new(self)
+    end
+
+    def mapper
+      @mapper ||= Mapper.new
+    end
+
+    def trade!(type, price, amount)
+      mapper.map_order(net.post(type, { price: price.to_digits, amount: amount.to_digits }))
+    end
+  end
+end

data/lib/bitstampede/entities/balance.rb

@@ -0,0 +1,21 @@
+require_relative './base'
+
+module Bitstampede
+  module Entities
+    class Balance < Base
+      def self.mappings
+        {
+          usd_balance: map_decimal,
+          btc_balance: map_decimal,
+          usd_reserved: map_decimal,
+          btc_reserved: map_decimal,
+          usd_available: map_decimal,
+          btc_available: map_decimal,
+          fee: map_decimal
+        }
+      end
+
+      setup_readers
+    end
+  end
+end

data/lib/bitstampede/entities/base.rb

@@ -0,0 +1,36 @@
+module Bitstampede
+  module Entities
+    class Base
+      def self.setup_readers
+        keys.each {|k| attr_reader k.to_sym }
+      end
+
+      def self.keys
+        self.mappings.keys
+      end
+
+      def initialize(balance_hash)
+        self.class.keys.each do |key|
+          instance_variable_set("@#{key}", self.class.mappings[key].call(balance_hash[key.to_s].to_s))
+        end
+      end
+
+      def inspect
+        inspect_string = "#<#{self.class}:#{self.object_id} "
+        self.class.keys.each do |key|
+          inspect_string << "#{key}: #{send(key).inspect} "
+        end
+        inspect_string << " >"
+        inspect_string
+      end
+
+      def self.map_int
+        ->(val) { val.to_i }
+      end
+
+      def self.map_decimal
+        ->(val) { BigDecimal(val) }
+      end
+    end
+  end
+end

data/lib/bitstampede/entities/order.rb

@@ -0,0 +1,34 @@
+require_relative './base'
+
+module Bitstampede
+  module Entities
+    class Order < Base
+      class InvalidTypeError < StandardError; end
+
+      def self.map_type
+        ->(val) do
+          case val.to_s
+          when '0'
+            :buy
+          when '1'
+            :sell
+          else
+            raise InvalidTypeError
+          end
+        end
+      end
+
+      def self.mappings
+        {
+          id: map_int,
+          datetime: map_int,
+          type: map_type,
+          price: map_decimal,
+          amount: map_decimal
+        }
+      end
+
+      setup_readers
+    end
+  end
+end

data/lib/bitstampede/mapper.rb

@@ -0,0 +1,37 @@
+require_relative './entities/balance'
+require_relative './entities/order'
+
+module Bitstampede
+  class Mapper
+    def initialize
+    end
+
+    def map_balance(json)
+      Entities::Balance.new(parsed(json))
+    end
+
+    def map_orders(json)
+      parsed(json).map{|o| map_order(o) }
+    end
+
+    def map_order(order)
+      Entities::Order.new(parsed(order))
+    end
+
+    def map_cancel(result)
+      parsed(result) == 'true'
+    end
+
+    private
+    # Allow passing either a String or anything else in.  If it's not a string,
+    # we assume we've already parsed it and just give it back to you.  This
+    # allows us to handle things like collections more easily.
+    def parsed(json)
+      if(json.is_a?(String))
+        Bitstampede::Helpers.json_parse(json)
+      else
+        json
+      end
+    end
+  end
+end

data/lib/bitstampede/net.rb

@@ -0,0 +1,51 @@
+require 'httparty'
+
+module Bitstampede
+  class Net
+    attr_reader :client
+
+    def initialize(client)
+      @client = client
+    end
+
+    def secret
+      client.secret
+    end
+
+    def key
+      client.key
+    end
+
+    def post(endpoint, options={})
+      map_response(raw_post(endpoint, options))
+    end
+
+    private
+    def url_for(endpoint)
+      base_url + endpoint + '/'
+    end
+
+    def base_url
+      'https://www.bitstamp.net/api/'
+    end
+
+    def auth_options
+      {
+        user: key,
+        password: secret
+      }
+    end
+
+    # For some crazy reason, bitstamp is returning ruby hash strings rather than
+    # JSON objects right now ಠ_ಠ  I'm just going to gsub '=>' to ':' to 'solve'
+    # it for now.  Not thrilled with this.
+    def map_response(wish_this_were_reliably_json)
+      wish_this_were_reliably_json.gsub('=>', ':')
+    end
+
+    def raw_post(endpoint, options)
+      HTTParty.post(url_for(endpoint), body: options.merge(auth_options)).to_s
+    end
+  end
+end
+

data/lib/bitstampede/version.rb

@@ -0,0 +1,3 @@
+module Bitstampede
+  VERSION = "0.0.1"
+end

data/lib/bitstampede.rb

@@ -0,0 +1,12 @@
+require_relative './bitstampede/version'
+require_relative './bitstampede/client'
+require 'multi_json'
+require 'yajl'
+
+module Bitstampede
+  module Helpers
+    def self.json_parse(string)
+      MultiJson.load(string)
+    end
+  end
+end

data/spec/integration/client_spec.rb

@@ -0,0 +1,93 @@
+require_relative '../spec_helper'
+
+describe "Integrating a client" do
+  subject{ Client.new }
+
+  before do
+    subject.secret = '1'
+    subject.key = '2'
+  end
+
+  it "handles #balance" do
+    example_balance = <<-JSON
+      {
+        "usd_balance": "12.34",
+        "btc_balance": "23.45",
+        "usd_reserved": "1.11",
+        "btc_reserved": "2.22",
+        "usd_available": "11.23",
+        "btc_available": "21.23",
+        "fee": "0.5"
+      }
+    JSON
+
+    FakeWeb.register_uri(:post, "https://www.bitstamp.net/api/balance/", body: example_balance)
+
+    bal = subject.balance
+    expect(bal.usd_balance).to eq(BigDecimal('12.34'))
+  end
+
+  it "handles #orders" do
+    example_orders = <<-JSON
+      [
+        {
+          "id": "1",
+          "datetime": "1234567",
+          "type": 0,
+          "price": "12.34",
+          "amount": "100"
+        }
+      ]
+    JSON
+
+    FakeWeb.register_uri(:post, "https://www.bitstamp.net/api/open_orders/", body: example_orders)
+
+    orders = subject.orders
+    expect(orders[0].type).to eq(:buy)
+  end
+
+  it "handles #buy!" do
+    example_buy_response = <<-JSON
+      {
+        "id": "1",
+        "datetime": "1234567",
+        "type": 0,
+        "price": "12.34",
+        "amount": "100"
+      }
+    JSON
+
+    FakeWeb.register_uri(:post, "https://www.bitstamp.net/api/buy/", body: example_buy_response)
+
+    buy = subject.buy!(BigDecimal('1'), BigDecimal('100'))
+    expect(buy.type).to eq(:buy)
+  end
+
+  it "handles #sell!" do
+    example_sell_response = <<-JSON
+      {
+        "id": "1",
+        "datetime": "1234567",
+        "type": 1,
+        "price": "12.34",
+        "amount": "100"
+      }
+    JSON
+
+    FakeWeb.register_uri(:post, "https://www.bitstamp.net/api/sell/", body: example_sell_response)
+
+    sell = subject.sell!(BigDecimal('1'), BigDecimal('100'))
+    expect(sell.type).to eq(:sell)
+  end
+
+  it "handles #cancel" do
+    example_cancel_response = <<-JSON
+      "true"
+    JSON
+
+    FakeWeb.register_uri(:post, "https://www.bitstamp.net/api/cancel_order/", body: example_cancel_response)
+
+    cancel = subject.cancel(12345)
+    expect(cancel).to eq(true)
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,20 @@
+require 'coveralls'
+Coveralls.wear!
+
+require 'rspec'
+require 'rspec/autorun'
+require 'bundler'
+Bundler.setup
+
+require 'fakeweb'
+FakeWeb.allow_net_connect = %r[coveralls\.io] # Only allow the coveralls api call through
+
+require 'multi_json'
+def json_parse(string)
+  MultiJson.load(string)
+end
+
+require 'pry'
+
+require_relative '../lib/bitstampede'
+include Bitstampede

data/spec/unit/bitstampede/client_spec.rb

@@ -0,0 +1,110 @@
+require_relative '../../spec_helper'
+
+describe Bitstampede::Client do
+  subject { described_class.new }
+  let(:net){ subject.send(:net) }
+  let(:mapper){ subject.send(:mapper) }
+
+  before do
+    subject.key = '1'
+    subject.secret = '2'
+  end
+
+  describe '#balance' do
+    let(:api_balance_response){ double }
+    let(:balance_object){ double }
+
+    before do
+      net.stub(:post).and_return(api_balance_response)
+      mapper.stub(:map_balance).and_return(balance_object)
+      subject.balance
+    end
+
+    it 'requests the balance from the API' do
+      expect(net).to have_received(:post).with('balance')
+    end
+
+    it 'maps the API response to a Balance object' do
+      expect(mapper).to have_received(:map_balance).with(api_balance_response)
+    end
+
+    it 'returns the mapped object' do
+      expect(subject.balance).to eq(balance_object)
+    end
+  end
+
+  describe '#orders' do
+    let(:api_orders_response){ double }
+    let(:order_object){ double }
+
+    before do
+      net.stub(:post).and_return(api_orders_response)
+      mapper.stub(:map_orders).and_return([order_object])
+      subject.orders
+    end
+
+    it 'requests open orders from the API' do
+      expect(net).to have_received(:post).with('open_orders')
+    end
+
+    it 'maps the API response to an array of Order objects' do
+      expect(mapper).to have_received(:map_orders).with(api_orders_response)
+    end
+  end
+
+  describe 'buy!' do
+    let(:api_buy_response){ double }
+    let(:order_object){ double }
+
+    before do
+      net.stub(:post).and_return(api_buy_response)
+      mapper.stub(:map_order).and_return(order_object)
+      subject.buy!(BigDecimal('1'), BigDecimal('100'))
+    end
+
+    it 'submits a buy order to the API' do
+      expect(net).to have_received(:post).with('buy', { amount: '100.0', price: '1.0' })
+    end
+
+    it 'maps the API response to an Order object' do
+      expect(mapper).to have_received(:map_order).with(api_buy_response)
+    end
+  end
+
+  describe 'sell!' do
+    let(:api_sell_response){ double }
+    let(:order_object){ double }
+
+    before do
+      net.stub(:post).and_return(api_sell_response)
+      mapper.stub(:map_order).and_return(order_object)
+      subject.sell!(BigDecimal('1'), BigDecimal('100'))
+    end
+
+    it 'submits a sell order to the API' do
+      expect(net).to have_received(:post).with('sell', { amount: '100.0', price: '1.0' })
+    end
+
+    it 'maps the API response to an Order object' do
+      expect(mapper).to have_received(:map_order).with(api_sell_response)
+    end
+  end
+
+  describe 'cancel' do
+    let(:api_cancel_response){ double }
+
+    before do
+      net.stub(:post).and_return(api_cancel_response)
+      mapper.stub(:map_cancel).and_return(true)
+      subject.cancel(1234)
+    end
+
+    it 'submits a cancel order to the API' do
+      expect(net).to have_received(:post).with('cancel_order', { id: '1234' })
+    end
+
+    it 'maps the API response to a boolean' do
+      expect(mapper).to have_received(:map_cancel).with(api_cancel_response)
+    end
+  end
+end

data/spec/unit/bitstampede/entities/balance_spec.rb

@@ -0,0 +1,48 @@
+require_relative '../../../spec_helper'
+
+describe Bitstampede::Entities::Balance do
+  let(:balance_hash){
+    {
+      "usd_balance" => "111.12",
+      "btc_balance" => "211.23",
+      "usd_reserved" => "1.20",
+      "btc_reserved" => "2.30",
+      "usd_available" => "5.50",
+      "btc_available" => "6.60",
+      "fee" => "1.11"
+    }
+  }
+  subject{ described_class.new(balance_hash) }
+
+  it "has a usd_balance" do
+    expect(subject.usd_balance).to eq(BigDecimal('111.12'))
+  end
+
+  it "has a btc_balance" do
+    expect(subject.btc_balance).to eq(BigDecimal('211.23'))
+  end
+
+  it "has a usd_reserved" do
+    expect(subject.usd_reserved).to eq(BigDecimal('1.20'))
+  end
+
+  it "has a btc_reserved" do
+    expect(subject.btc_reserved).to eq(BigDecimal('2.30'))
+  end
+
+  it "has a usd_available" do
+    expect(subject.usd_available).to eq(BigDecimal('5.50'))
+  end
+
+  it "has a btc_available" do
+    expect(subject.btc_available).to eq(BigDecimal('6.60'))
+  end
+
+  it "has a fee" do
+    expect(subject.fee).to eq(BigDecimal('1.11'))
+  end
+
+  it "can be inspected" do
+    expect { subject.inspect }.to_not raise_error
+  end
+end

data/spec/unit/bitstampede/entities/order_spec.rb

@@ -0,0 +1,33 @@
+require_relative '../../../spec_helper'
+
+describe Bitstampede::Entities::Order do
+  let(:order_hash){
+    {
+      "id" => "1",
+      "datetime" => 1234567,
+      "type" => 0,
+      "price" => "1.23",
+      "amount" => "10"
+    }
+  }
+  subject{ described_class.new(order_hash) }
+
+  it "has an id" do
+    expect(subject.id).to eq(1)
+  end
+
+  describe "type" do
+    it "maps 0 to :buy" do
+      expect(subject.type).to eq(:buy)
+    end
+
+    it "maps 1 to :sell" do
+      order = described_class.new(order_hash.merge({"type" => 1}))
+      expect(order.type).to eq(:sell)
+    end
+
+    it "raises InvalidTypeError for other values" do
+      expect { described_class.new(order_hash.merge({"type" => 2})) }.to raise_error(Bitstampede::Entities::Order::InvalidTypeError)
+    end
+  end
+end

data/spec/unit/bitstampede/mapper_spec.rb

@@ -0,0 +1,44 @@
+require_relative '../../spec_helper'
+
+describe Bitstampede::Mapper do
+  subject { described_class.new }
+  let(:json_object){ '{"foo": "bar"}' }
+  let(:json_array){ '[{"foo": "bar"}]' }
+
+  describe '#map_balance' do
+    let(:balance) { double }
+
+    before do
+      Entities::Balance.stub(:new).and_return(balance)
+    end
+
+    it "maps a balance API response into a Balance entity" do
+      subject.map_balance(json_object)
+      expect(Entities::Balance).to have_received(:new).with(json_parse(json_object))
+    end
+
+    it "returns the mapped Balance entity" do
+      expect(subject.map_balance(json_object)).to eq(balance)
+    end
+  end
+
+  describe '#map_orders' do
+    let(:order) { double }
+
+    before do
+      Entities::Order.stub(:new).and_return(order)
+    end
+
+    it "maps an open_orders API response into an array of Order entities" do
+      subject.map_orders(json_array)
+      expect(Entities::Order).to have_received(:new).with(json_parse(json_array)[0])
+    end
+  end
+
+  describe '#map_cancel' do
+    it "maps a cancel API response to a boolean" do
+      expect(subject.map_cancel('"true"')).to eq(true)
+      expect(subject.map_cancel('"false"')).to eq(false)
+    end
+  end
+end

data/spec/unit/bitstampede/net_spec.rb

@@ -0,0 +1,43 @@
+require_relative '../../spec_helper'
+
+describe Bitstampede::Net do
+  let(:client){ double }
+  subject { described_class.new(client) }
+
+  before do
+    client.stub(:secret).and_return(1)
+    client.stub(:key).and_return(2)
+  end
+
+  it 'gets instantiated with a client' do
+    expect(subject.client).to eq(client)
+  end
+
+  it 'defers to its client for secret' do
+    expect(subject.secret).to eq(1)
+  end
+
+  it 'defers to its client for key' do
+    expect(subject.key).to eq(2)
+  end
+
+  describe '#post' do
+    describe 'any_endpoint' do
+      let(:example_balance) do
+        <<-JSON
+          {
+            "foo": "bar"
+          }
+        JSON
+      end
+
+      before do
+        FakeWeb.register_uri(:post, "https://www.bitstamp.net/api/balance/", body: example_balance)
+      end
+
+      it "queries the appropriate endpoint and returns its body as a string" do
+        expect(json_parse(subject.post('balance'))).to eq(json_parse(example_balance))
+      end
+    end
+  end
+end

data/spec/unit/bitstampede_spec.rb

@@ -0,0 +1,13 @@
+require_relative '../spec_helper'
+
+describe Bitstampede do
+  it "ought to be an instance rather than a retarded singleton like every freaking btc-related gem in existence apparently" do
+    client = Bitstampede::Client.new
+    expect(client.key).to eq(nil)
+    expect(client.secret).to eq(nil)
+    client.key = '1'
+    client.secret = '2'
+    expect(client.key).to eq('1')
+    expect(client.secret).to eq('2')
+  end
+end

metadata

@@ -0,0 +1,218 @@
+--- !ruby/object:Gem::Specification
+name: bitstampede
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Josh Adams
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-06-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: yajl-ruby
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.14.0.rc1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.14.0.rc1
+- !ruby/object:Gem::Dependency
+  name: fakeweb
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: This is a client library for the Bitstamp API that supports instantiating
+  multiple clients in the same process.
+email:
+- josh@isotope11.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- .rvmrc
+- .travis.yml
+- Gemfile
+- LICENSE.md
+- README.md
+- Rakefile
+- bitstampede.gemspec
+- doc/legitimate_concern.png
+- example/balance.rb
+- example/example.rb
+- example/query_orders.rb
+- lib/bitstampede.rb
+- lib/bitstampede/client.rb
+- lib/bitstampede/entities/balance.rb
+- lib/bitstampede/entities/base.rb
+- lib/bitstampede/entities/order.rb
+- lib/bitstampede/mapper.rb
+- lib/bitstampede/net.rb
+- lib/bitstampede/version.rb
+- spec/integration/client_spec.rb
+- spec/spec_helper.rb
+- spec/unit/bitstampede/client_spec.rb
+- spec/unit/bitstampede/entities/balance_spec.rb
+- spec/unit/bitstampede/entities/order_spec.rb
+- spec/unit/bitstampede/mapper_spec.rb
+- spec/unit/bitstampede/net_spec.rb
+- spec/unit/bitstampede_spec.rb
+homepage: http://github.com/isotope11/bitstampede
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 4285444086114394616
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 4285444086114394616
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.25
+signing_key: 
+specification_version: 3
+summary: Fantastic bitstamp library.
+test_files:
+- spec/integration/client_spec.rb
+- spec/spec_helper.rb
+- spec/unit/bitstampede/client_spec.rb
+- spec/unit/bitstampede/entities/balance_spec.rb
+- spec/unit/bitstampede/entities/order_spec.rb
+- spec/unit/bitstampede/mapper_spec.rb
+- spec/unit/bitstampede/net_spec.rb
+- spec/unit/bitstampede_spec.rb