bitex_bot 0.3.7 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c1bcc53a7b4d8a6382173bdd864dd306b3a2bdc5
-  data.tar.gz: e4254d0ffe025a95c5eba3429814b2b60405abb7
+  metadata.gz: '027380d0b5310a8656d1e4ea0357617f1c750c1a'
+  data.tar.gz: 66974805bb9b7b130181e737f688512d8f234d17
 SHA512:
-  metadata.gz: 0b64dae4070f6fb5ce595bfb0d5cac5c88d9d853264b948ae62241e812a1946ed83e9f3af344b4fa8fb7a215d61f9cc8c2b960c388b820d2b880f3dc72cc32b7
-  data.tar.gz: a8ac2e4ace3edaa00b529d6aafd1808d4bb8cfb8139b6588789a80e8455b38505be31afb6a813048905d9f8c32f3738b979c23c45a1ab1340a49454180347ecc
+  metadata.gz: d70e171eb1bae487ab0866d441c7c7ac3711d129976a4bf0351d1a1848834dbb9b4f2cb9227af7d2f73df7a3aa200052dc48028b8a8b0c0fa753d775ba21070a
+  data.tar.gz: 4bc5ae223b7ddde9b07b8397ce2c5fcbc25b89b289084b57bc357448c8d6c822e301a0814f657ccf89a9d12a57f6d56d5cabdd1d2d88f7393a36b00e18c1480b

data/.circleci/config.yml

@@ -0,0 +1,63 @@
+# Ruby CircleCI 2.0 configuration file
+#
+# Check https://circleci.com/docs/2.0/language-ruby/ for more details
+#
+version: 2
+jobs:
+  build:
+    docker:
+      # specify the version you desire here
+       - image: circleci/ruby:2.4.1-node-browsers
+
+      # Specify service dependencies here if necessary
+      # CircleCI maintains a library of pre-built images
+      # documented at https://circleci.com/docs/2.0/circleci-images/
+      # - image: circleci/postgres:9.4
+
+    working_directory: ~/repo
+
+    steps:
+      - checkout
+
+      # Download and cache dependencies
+      - restore_cache:
+          keys:
+          - v1-dependencies-{{ checksum "bitex_bot.gemspec" }}-{{ checksum "Gemfile" }}
+          # fallback to using the latest cache if no exact match is found
+          - v1-dependencies-
+
+      - run:
+          name: install dependencies
+          command: |
+            bundle install --jobs=4 --retry=3 --path vendor/bundle
+
+      - save_cache:
+          paths:
+            - ./vendor/bundle
+          key: v1-dependencies-{{ checksum "bitex_bot.gemspec" }}-{{ checksum "Gemfile" }}
+
+      # run tests!
+      - run:
+          name: run tests
+          command: |
+            mkdir /tmp/test-results
+            TEST_FILES="$(circleci tests glob "spec/**/*_spec.rb" | circleci tests split --split-by=timings)"
+
+            bundle exec rspec --format progress \
+                            --format RspecJunitFormatter \
+                            --out /tmp/test-results/rspec.xml \
+                            --format progress \
+                            $TEST_FILES
+
+      # run lints
+      - run:
+          name: run lints
+          command: |
+            bundle exec rubocop
+
+      # collect reports
+      - store_test_results:
+          path: /tmp/test-results
+      - store_artifacts:
+          path: /tmp/test-results
+          destination: test-results

data/.rubocop.yml

@@ -0,0 +1,33 @@
+Style/FrozenStringLiteralComment:
+  EnforcedStyle: never
+
+Metrics/AbcSize:
+  Max: 16
+
+Metrics/ClassLength:
+  Max: 130
+
+Metrics/LineLength:
+  Max: 130
+
+Metrics/MethodLength:
+  Max: 25
+
+Metrics/ParameterLists:
+  Max: 7
+
+AllCops:
+  TargetRubyVersion: 2.4
+  Exclude:
+    - 'Gemfile'
+    - 'Gemfile.lock'
+    - 'LICENSE.txt'
+    - 'README.md'
+    - 'Rakefile'
+    - 'bin/*'
+    - 'bitex_bot.gemspec'
+    - 'settings.rb.sample'
+    - 'spec/**/*'
+    - 'vendor/**/*'
+    - 'lib/bitex_bot/database.rb'
+    - 'lib/bitex_bot/version.rb'

data/Gemfile

@@ -2,4 +2,4 @@ source 'https://rubygems.org'
 
 # Specify your gem's dependencies in bitex_bot.gemspec
 gemspec
-gem 'bitstamp', git: 'https://github.com/bitex-la/bitstamp.git'
+gem 'bitstamp', github: 'bitex-la/bitstamp'

data/Rakefile

@@ -1 +1 @@
-require "bundler/gem_tasks"
+require 'bundler/gem_tasks'

data/bin/bitex_bot

@@ -1,6 +1,6 @@
 #!/usr/bin/env ruby
 
-require "bitex_bot/settings"
+require 'bitex_bot/settings'
 BitexBot::Settings.load_default
 
 require 'bitex_bot'

data/bitex_bot.gemspec

@@ -1,44 +1,44 @@
-# coding: utf-8
-lib = File.expand_path('../lib', __FILE__)
+lib = File.expand_path('lib', __dir__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 require 'bitex_bot/version'
 
 Gem::Specification.new do |spec|
-  spec.name          = "bitex_bot"
+  spec.name          = 'bitex_bot'
   spec.version       = BitexBot::VERSION
-  spec.authors       = ["Nubis", "Eromirou"]
-  spec.email         = ["nb@bitex.la", "tr@bitex.la"]
-  spec.description   = %q{Both a trading robot and a library to build trading
-                        robots. The bitex-bot lets you buy cheap on bitex and
-                        sell on another exchange and vice versa.}
-  spec.summary       = %q{A trading robot to do arbitrage between bitex.la and
-                        other exchanges!}
-  spec.homepage      = ""
-  spec.license       = "MIT"
+  spec.authors       = %w[Nubis Eromirou]
+  spec.email         = %w[nb@bitex.la tr@bitex.la]
+  spec.description   = %(Both a trading robot and a library to build trading robots. The bitex-bot lets you buy cheap on bitex
+                         and sell on another exchange and vice versa.)
+  spec.summary       = %(A trading robot to do arbitrage between bitex.la and other exchanges!)
+  spec.homepage      = ''
+  spec.license       = 'MIT'
 
-  spec.files         = `git ls-files`.split($/)
+  spec.files         = `git ls-files`.split($RS)
   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 "activerecord", "~> 4.2"
-  spec.add_dependency "sqlite3"
-  spec.add_dependency "bitstamp"
-  spec.add_dependency "bitex", "0.3"
-  spec.add_dependency "itbit", "0.0.6"
-  spec.add_dependency "bitfinex-rb", "0.0.6"
-  spec.add_dependency "kraken_client", "~> 1.2.1"
-  spec.add_dependency "mail"
-  spec.add_dependency "hashie", "~> 3.5.4"
+  spec.require_paths = %w[lib]
 
-  spec.add_development_dependency "bundler"
-  spec.add_development_dependency "byebug"
-  spec.add_development_dependency "rake"
-  spec.add_development_dependency "rspec"
-  spec.add_development_dependency "rspec-mocks"
-  spec.add_development_dependency "database_cleaner"
-  spec.add_development_dependency "factory_girl"
-  spec.add_development_dependency "timecop"
-  spec.add_development_dependency "shoulda-matchers"
-  spec.add_development_dependency "webmock"
+  spec.add_dependency 'activerecord', '~> 4.2'
+  spec.add_dependency 'hashie', '~> 3.5.4'
+  spec.add_dependency 'mail'
+  spec.add_dependency 'sqlite3'
+
+  spec.add_dependency 'bitex', '0.5'
+  spec.add_dependency 'bitstamp'
+  spec.add_dependency 'itbit', '0.0.6'
+  spec.add_dependency 'kraken_client', '~> 1.2.1'
+
+  spec.add_development_dependency 'bundler'
+  spec.add_development_dependency 'rake'
+
+  spec.add_development_dependency 'byebug'
+  spec.add_development_dependency 'database_cleaner'
+  spec.add_development_dependency 'factory_bot'
+  spec.add_development_dependency 'rspec'
+  spec.add_development_dependency 'rspec-mocks'
+  spec.add_development_dependency 'rspec_junit_formatter'
+  spec.add_development_dependency 'rubocop'
+  spec.add_development_dependency 'shoulda-matchers'
+  spec.add_development_dependency 'timecop'
+  spec.add_development_dependency 'webmock'
 end

data/lib/bitex_bot/database.rb

@@ -1,113 +1,113 @@
 module BitexBot
   module Database
-    #ActiveRecord::Base.logger = Logger.new(File.open('database.log', 'w'))
     ActiveRecord::Base.establish_connection(Settings.database)
 
     ActiveRecord::Schema.define(version: 1) do
       if ActiveRecord::Base.connection.tables.empty?
         create_table :buy_opening_flows do |t|
-          t.decimal :price, precision: 30, scale: 15
-          t.decimal :value_to_use, precision: 30, scale: 15
-          t.decimal :suggested_closing_price, precision: 30, scale: 15
-          t.integer :order_id
-          t.string :status, null: false, default: 'executing'
-          t.index :status
-          t.timestamps
+          t.decimal    :price,                   precision: 30, scale: 15
+          t.decimal    :value_to_use,            precision: 30, scale: 15
+          t.decimal    :suggested_closing_price, precision: 30, scale: 15
+          t.integer    :order_id
+          t.string     :status,                  null: false,   default: 'executing'
+          t.index      :status
+          t.timestamps null: true
         end
         add_index :buy_opening_flows, :order_id
 
         create_table :sell_opening_flows do |t|
-          t.decimal :price, precision: 30, scale: 15
-          t.decimal :value_to_use, precision: 30, scale: 15
-          t.decimal :suggested_closing_price, precision: 30, scale: 15
-          t.integer :order_id
-          t.string :status, null: false, default: 'executing'
-          t.index :status
-          t.timestamps
+          t.decimal    :price,                   precision: 30, scale: 15
+          t.decimal    :value_to_use,            precision: 30, scale: 15
+          t.decimal    :suggested_closing_price, precision: 30, scale: 15
+          t.integer    :order_id
+          t.string     :status,                  null: false,   default: 'executing'
+          t.index      :status
+          t.timestamps null: true
         end
         add_index :sell_opening_flows, :order_id
-        
+
         create_table :open_buys do |t|
           t.belongs_to :opening_flow
           t.belongs_to :closing_flow
-          t.decimal :price, precision: 30, scale: 15
-          t.decimal :amount, precision: 30, scale: 15
-          t.decimal :quantity, precision: 30, scale: 15
-          t.integer :transaction_id
-          t.timestamps
+          t.decimal    :price,         precision: 30, scale: 15
+          t.decimal    :amount,        precision: 30, scale: 15
+          t.decimal    :quantity,      precision: 30, scale: 15
+          t.integer    :transaction_id
+          t.timestamps null: true
         end
         add_index :open_buys, :transaction_id
 
         create_table :open_sells do |t|
           t.belongs_to :opening_flow
           t.belongs_to :closing_flow
-          t.decimal :price, precision: 30, scale: 15
-          t.decimal :quantity, precision: 30, scale: 15
-          t.decimal :amount, precision: 30, scale: 15
-          t.integer :transaction_id
-          t.timestamps
+          t.decimal    :price,         precision: 30, scale: 15
+          t.decimal    :quantity,      precision: 30, scale: 15
+          t.decimal    :amount,        precision: 30, scale: 15
+          t.integer    :transaction_id
+          t.timestamps null: true
         end
         add_index :open_sells, :transaction_id
-        
+
         create_table :buy_closing_flows do |t|
-          t.decimal :desired_price, precision: 30, scale: 15
-          t.decimal :quantity, precision: 30, scale: 15
-          t.decimal :amount, precision: 30, scale: 15
-          t.boolean :done, null: false, default: false
-          t.decimal :btc_profit, precision: 30, scale: 15
-          t.decimal :usd_profit, precision: 30, scale: 15
-          t.timestamps
+          t.decimal    :desired_price, precision: 30, scale: 15
+          t.decimal    :quantity,      precision: 30, scale: 15
+          t.decimal    :amount,        precision: 30, scale: 15
+          t.boolean    :done,          null: false,   default: false
+          t.decimal    :btc_profit,    precision: 30, scale: 15
+          t.decimal    :fiat_profit,   precision: 30, scale: 15
+          t.decimal    :fx_rate,       precision: 20, scale: 8
+          t.timestamps null: true
         end
 
         create_table :sell_closing_flows do |t|
-          t.decimal :desired_price, precision: 30, scale: 15
-          t.decimal :quantity, precision: 30, scale: 15
-          t.decimal :amount, precision: 30, scale: 15
-          t.boolean :done, null: false, default: false
-          t.decimal :btc_profit, precision: 30, scale: 15
-          t.decimal :usd_profit, precision: 30, scale: 15
-          t.timestamps
+          t.decimal    :desired_price, precision: 30, scale: 15
+          t.decimal    :quantity,      precision: 30, scale: 15
+          t.decimal    :amount,        precision: 30, scale: 15
+          t.boolean    :done,          null: false,   default: false
+          t.decimal    :btc_profit,    precision: 30, scale: 15
+          t.decimal    :fiat_profit,   precision: 30, scale: 15
+          t.decimal    :fx_rate,       precision: 20, scale: 8
+          t.timestamps null: true
         end
-        
+
         create_table :close_buys do |t|
           t.belongs_to :closing_flow
-          t.decimal :amount, precision: 30, scale: 15
-          t.decimal :quantity, precision: 30, scale: 15
-          t.string :order_id
-          t.timestamps
+          t.decimal    :amount,      precision: 30, scale: 15
+          t.decimal    :quantity,    precision: 30, scale: 15
+          t.string     :order_id
+          t.timestamps null: true
         end
         add_index :close_buys, :order_id
 
         create_table :close_sells do |t|
           t.belongs_to :closing_flow
-          t.decimal :amount, precision: 30, scale: 15
-          t.decimal :quantity, precision: 30, scale: 15
-          t.string :order_id
-          t.timestamps
+          t.decimal    :amount,   precision: 30, scale: 15
+          t.decimal    :quantity, precision: 30, scale: 15
+          t.string     :order_id
+          t.timestamps null: true
         end
         add_index :close_sells, :order_id
       end
 
       unless ActiveRecord::Base.connection.table_exists?('stores')
-        create_table "stores", force: true do |t|
-          t.decimal  "taker_usd",                precision: 20, scale: 8
-          t.decimal  "taker_btc",                precision: 20, scale: 8
-          t.boolean  "hold", default: false
-          t.text     "log"
-          t.decimal  "usd_stop",  precision: 20, scale: 8
-          t.decimal  "usd_warning",  precision: 20, scale: 8
-          t.decimal  "btc_stop",  precision: 20, scale: 8
-          t.decimal  "btc_warning",         precision: 20, scale: 8
-          t.datetime "last_warning"
-          t.decimal "buying_profit", precision: 20, scale: 8
-          t.decimal "selling_profit", precision: 20, scale: 8
-          t.decimal "buying_amount_to_spend_per_order", precision: 20, scale: 8
-          t.decimal "selling_quantity_to_sell_per_order", precision: 20, scale: 8
-          t.timestamps
+        create_table   :stores, force: true do |t|
+          t.decimal    :taker_fiat,                         precision: 20,   scale: 8
+          t.decimal    :taker_btc,                          precision: 20,   scale: 8
+          t.boolean    :hold,                               default:   false
+          t.text       :log
+          t.decimal    :fiat_stop,                          precision: 20,   scale: 8
+          t.decimal    :fiat_warning,                       precision: 20,   scale: 8
+          t.decimal    :btc_stop,                           precision: 20,   scale: 8
+          t.decimal    :btc_warning,                        precision: 20,   scale: 8
+          t.datetime   :last_warning
+          t.decimal    :buying_profit,                      precision: 20,   scale: 8
+          t.decimal    :selling_profit,                     precision: 20,   scale: 8
+          t.decimal    :buying_amount_to_spend_per_order,   precision: 20,   scale: 8
+          t.decimal    :selling_quantity_to_sell_per_order, precision: 20,   scale: 8
+          t.decimal    :fx_rate,                            precision: 20,   scale: 8
+          t.timestamps null: true
         end
       end
     end
-
   end
 end
-

data/lib/bitex_bot/models/api_wrappers/api_wrapper.rb

@@ -0,0 +1,142 @@
+# This class represents the general behaviour for trading platform wrappers.
+class ApiWrapper
+  MIN_AMOUNT = 5
+
+  Transaction = Struct.new(
+    :id,       # Integer
+    :price,    # Decimal
+    :amount,   # Decimal
+    :timestamp # Epoch Integer
+  )
+
+  Order = Struct.new(
+    :id,        # String
+    :type,      # Symbol
+    :price,     # Decimal
+    :amount,    # Decimal
+    :timestamp, # Integer
+    :raw_order  # Actual order object
+  ) do
+    def method_missing(method_name, *args, &block)
+      raw_order.respond_to?(method_name) ? raw_order.send(method_name, *args, &block) : super
+    end
+
+    def respond_to_missing?(method_name, include_private = false)
+      raw_order.respond_to?(method_name) || super
+    end
+  end
+
+  OrderBook = Struct.new(
+    :timestamp, # Integer
+    :bids,      # [OrderSummary]
+    :asks       # [OrderSummary]
+  )
+
+  OrderSummary = Struct.new(
+    :price,   # Decimal
+    :quantity # Decimal
+  )
+
+  BalanceSummary = Struct.new(
+    :btc, # Balance
+    :usd, # Balance
+    :fee  # Decimal
+  )
+
+  Balance = Struct.new(
+    :total,    # Decimal
+    :reserved, # Decimal
+    :available # Decimal
+  )
+
+  UserTransaction = Struct.new(
+    :order_id, # Integer
+    :usd,      # Decimal
+    :btc,      # Decimal
+    :btc_usd,  # Decimal
+    :fee,      # Decimal
+    :type,     # Integer
+    :timestamp # Epoch Integer
+  )
+
+  # @return [Void]
+  def self.setup(_settings)
+    raise 'self subclass responsibility'
+  end
+
+  # @return [Array<Transaction>]
+  def self.transactions
+    raise 'self subclass responsibility'
+  end
+
+  # @return [OrderBook]
+  def self.order_book(_retries = 20)
+    raise 'self subclass responsibility'
+  end
+
+  # @return [BalanceSummary]
+  def self.balance
+    raise 'self subclass responsibility'
+  end
+
+  # @return [nil]
+  def self.cancel
+    raise 'self subclass responsibility'
+  end
+
+  # @return [Array<Order>]
+  def self.orders
+    raise 'self subclass responsibility'
+  end
+
+  # @return [UserTransaction]
+  def self.user_transacitions
+    raise 'self subclass responsibility'
+  end
+
+  # @param type
+  # @param price
+  # @param quantity
+  def self.place_order(type, price, quantity)
+    order = send_order(type, price, quantity)
+    return order unless order.nil? || order.id.nil?
+
+    BitexBot::Robot.log(:debug, "Captured error when placing order on #{self.class.name}")
+    # Order may have gone through and be stuck somewhere in Wrapper's pipeline.
+    # We just sleep for a bit and then look for the order.
+    20.times do
+      BitexBot::Robot.sleep_for(10)
+      order = find_lost(type, price, quantity)
+      return order if order.present?
+    end
+    raise OrderNotFound, "Closing: #{type} order not found for #{quantity} BTC @ $#{price}. #{order}"
+  end
+
+  # Hook Method - arguments could not be used in their entirety by the subclasses
+  def self.send_order(_type, _price, _quantity)
+    raise 'self subclass responsibility'
+  end
+
+  # @param order_method [String] buy|sell
+  # @param price [Decimal]
+  #
+  # Hook Method - arguments could not be used in their entirety by the subclasses
+  def self.find_lost(_type, _price, _quantity)
+    raise 'self subclass responsibility'
+  end
+
+  # @param order_id
+  # @param transactions
+  #
+  # @return [Array<Decimal, Decimal>]
+  def self.amount_and_quantity(_order_id, _transactions)
+    raise 'self subclass responsibility'
+  end
+
+  def self.enough_order_size?(quantity, price)
+    (quantity * price) > MIN_AMOUNT
+  end
+end
+
+class OrderNotFound < StandardError; end
+class ApiWrapperError < StandardError; end

data/lib/bitex_bot/models/api_wrappers/bitstamp/bitstamp_api_wrapper.rb

@@ -0,0 +1,137 @@
+# Wrapper implementation for Bitstamp API.
+# https://www.bitstamp.net/api/
+class BitstampApiWrapper < ApiWrapper
+  def self.setup(settings)
+    Bitstamp.setup do |config|
+      config.key = settings.api_key
+      config.secret = settings.secret
+      config.client_id = settings.client_id
+    end
+  end
+
+  def self.amount_and_quantity(order_id, transactions)
+    closes = transactions.select { |t| t.order_id.to_s == order_id }
+    amount = closes.map { |c| c.usd.to_d }.sum.abs
+    quantity = closes.map { |c| c.btc.to_d }.sum.abs
+
+    [amount, quantity]
+  end
+
+  def self.balance
+    balance_summary_parser(Bitstamp.balance.symbolize_keys)
+  rescue StandardError => e
+    raise ApiWrapperError, "Bitstamp balance failed: #{e.message}"
+  end
+
+  def self.cancel(order)
+    Bitstamp::Order.new(id: order.id).cancel!
+  rescue StandardError => e
+    raise ApiWrapperError, "Bitstamp cancel! failed: #{e.message}"
+  end
+
+  def self.find_lost(type, price, _quantity)
+    orders.find { |o| o.type == type && o.price == price && o.timestamp >= 5.minutes.ago.to_i }
+  end
+
+  # rubocop:disable Metrics/AbcSize
+  def self.order_book(retries = 20)
+    book = Bitstamp.order_book.deep_symbolize_keys
+    age = Time.now.to_i - book[:timestamp].to_i
+    return order_book_parser(book) if age <= 300
+
+    BitexBot::Robot.log(:info, "Refusing to continue as orderbook is #{age} seconds old")
+    order_book(retries)
+  rescue StandardError
+    raise if retries.zero?
+
+    BitexBot::Robot.log(:info, "Bitstamp order book failed, retrying #{retries} more times")
+    BitexBot::Robot.sleep_for 1
+    order_book(retries - 1)
+  end
+  # rubocop:enable Metrics/AbcSize
+
+  def self.orders
+    Bitstamp.orders.all.map { |o| order_parser(o) }
+  rescue StandardError => e
+    raise ApiWrapperError, "Bitstamp orders failed: #{e.message}"
+  end
+
+  def self.send_order(type, price, quantity)
+    Bitstamp.orders.send(type, amount: quantity.round(4), price: price.round(2))
+  end
+
+  def self.transactions
+    Bitstamp.transactions.map { |t| transaction_parser(t) }
+  rescue StandardError => e
+    raise ApiWrapperError, "Bitstamp transactions failed: #{e.message}"
+  end
+
+  def self.user_transactions
+    Bitstamp.user_transactions.all.map { |ut| user_transaction_parser(ut) }
+  rescue StandardError => e
+    raise ApiWrapperError, "Bitstamp user_transactions failed: #{e.message}"
+  end
+
+  private_class_method
+
+  # {
+  #   btc_reserved: '0', btc_available: '0', btc_balance: '0',
+  #   usd_reserved: '1.02, usd_available: '6952.05', usd_balance: '6953.07',
+  #   fee: '0.4000'
+  # }
+  def self.balance_summary_parser(balances)
+    BalanceSummary.new(balance_parser(balances, :btc), balance_parser(balances, :usd), balances[:fee].to_d)
+  end
+
+  def self.balance_parser(balances, currency)
+    Balance.new(
+      balances["#{currency}_balance".to_sym].to_d,
+      balances["#{currency}_reserved".to_sym].to_d,
+      balances["#{currency}_available".to_sym].to_d
+    )
+  end
+
+  # {
+  #   timestamp: '1380237884',
+  #   bids: [['124.55', '1.58057006'], ['124.40', '14.91779125']],
+  #   asks: [['124.56', '0.81888247'], ['124.57', '0.81078911']]
+  # }
+  def self.order_book_parser(book)
+    OrderBook.new(book[:timestamp].to_i, order_summary_parser(book[:bids]), order_summary_parser(book[:asks]))
+  end
+
+  def self.order_is_done?(order)
+    order.nil?
+  end
+
+  # <Bitstamp::Order @id=76, @type=0, @price='1.1', @amount='1.0', @datetime='2013-09-26 23:15:04'>
+  def self.order_parser(order)
+    type = order.type.zero? ? :buy : :sell
+    Order.new(order.id.to_s, type, order.price.to_d, order.amount.to_d, order.datetime.to_datetime.to_i, order)
+  end
+
+  def self.order_summary_parser(orders)
+    orders.map { |order| OrderSummary.new(order[0].to_d, order[1].to_d) }
+  end
+
+  # <Bitstamp::Transactions: @tid=1469074, @price='126.95', @amount='1.10000000', @date='1380648951'>
+  def self.transaction_parser(transaction)
+    Transaction.new(transaction.tid, transaction.price.to_d, transaction.amount.to_d, transaction.date.to_i)
+  end
+
+  # <Bitstamp::UserTransaction:
+  #   @usd='-373.51', @btc='3.00781124', @btc_usd='124.18', @order_id=7623942, @fee='1.50', @type=2, @id=1444404,
+  #   @datetime='2013-09-26 13:28:55'
+  # >
+  def self.user_transaction_parser(user_transaction)
+    UserTransaction.new(
+      user_transaction.order_id,
+      user_transaction.usd.to_d,
+      user_transaction.btc.to_d,
+      user_transaction.btc_usd.to_d,
+      user_transaction.fee.to_d,
+      user_transaction.type,
+      Time.new(user_transaction.datetime).to_i
+    )
+  end
+end