em-betfair 0.2

data/.gitignore

@@ -0,0 +1,3 @@
+.DS_Store
+Gemfile.lock
+.rvmrc

data/Gemfile

@@ -0,0 +1,8 @@
+# A sample Gemfile
+source "http://rubygems.org"
+
+gem "eventmachine"
+gem "em-http-request"
+gem "rspec"
+gem "haml"
+gem "nokogiri"

data/README.md

@@ -0,0 +1,47 @@
+# Betfair API client using Eventmachine and EM-Http
+
+em-betfair is a work in progress evented client for the Betfair API. The following API calls have been implemented :
+
+- login
+- getMarket
+- getAllMarkets
+- getMarketPricesCompressed
+- getMarketTradedVolumeCompressed
+
+# Usage
+
+	gem install em-betfair
+
+	gem "em-betfair", "~> 0.1"
+
+Create an instance of the client
+
+	config = {
+	  "username" => "<YOUR BETFAIR USERNAME>",
+	  "password" => "<YOUR BETFAIR PASSWORD>", 
+	  "product_id" => "<YOUR BETFAIR PRODUCTID>", 
+	  "exchange_endpoint" => "https://api.betfair.com/exchange/v5/BFExchangeService",
+	  "global_endpoint" => "https://api.betfair.com/global/v3/BFGlobalService"
+	}
+	bf_client = Betfair::Client.new(config)
+
+Making a call to the API:
+
+	EM::run {
+	  bf_client.get_all_markets do |rsp|
+
+	    rsp.raw_response # access the raw response body
+	    rsp.parsed_response # access the Nokogiri XML object of the raw response
+	    rsp.hash_response # access a hash of the response data
+
+	    rsp.successfull # boolean for success
+	    rsp.error # API error messge if not successfull
+
+	  end
+	}
+
+Note, logging in to the API is handled internally by the client.
+
+# Ruby versions
+
+Tested on 1.9.2 but should work on 1.8.7 too.

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/em-betfair.gemspec

@@ -0,0 +1,25 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name        = "em-betfair"
+  s.version     = "0.2"
+  s.authors     = ["George Sheppard"]
+  s.email       = ["george@fuzzmonkey.co.uk"]
+  s.homepage    = "https://github.com/fuzzmonkey/em-betfair"
+  s.summary     = %q{Betfair API client using Eventmachine and EM-Http}
+  s.description = %q{em-betfair is a work in progress evented client for the Betfair API}
+
+  s.rubyforge_project = "em-betfair"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_development_dependency "rspec"
+  s.add_runtime_dependency "eventmachine"
+  s.add_runtime_dependency "em-http-request"
+  s.add_runtime_dependency "haml"
+  s.add_runtime_dependency "nokogiri"
+
+end

data/examples/scrape_betfair.rb

@@ -0,0 +1,88 @@
+# Example script to scrape the Betfair API for prices and store them in redis as json strings.
+
+# WARNING - Beware of the Betfair data usage limits!!!
+
+require 'eventmachine'
+require 'em-betfair'
+require 'date'
+require 'time'
+require 'redis'
+require 'json'
+
+# Not requiring activesupport just to get ordanalize
+class Fixnum
+  def ordinalize
+    if (11..13).include?(self % 100)
+      "#{self}th"
+    else
+      case self % 10
+      when 1; "#{self}st"
+      when 2; "#{self}nd"
+      when 3; "#{self}rd"
+      else    "#{self}th"
+      end
+    end
+  end
+end
+
+EM::run {
+
+  config = {
+    "username" => "<YOUR BETFAIR USERNAME>",
+    "password" => "<YOUR BETFAIR PASSWORD>", 
+    "product_id" => "<YOUR BETFAIR PRODUCTID>", 
+    "exchange_endpoint" => "https://api.betfair.com/exchange/v5/BFExchangeService",
+    "global_endpoint" => "https://api.betfair.com/global/v3/BFGlobalService"
+  }
+
+  bf_client = Betfair::Client.new(config)
+  redis_client = Redis.new
+  timers = {}
+  num_timers = 0
+
+  # Fetch all the horse racing markets in the UK for today
+  bf_client.get_all_markets ["GBR"], [7], "#{Date.today} 00:00:00", "#{Date.today} 23:59:00" do |response|
+
+    response.hash_response["market_data"].each do |market_id,market_hash|
+
+      menu_path = market_hash["menu_path"]
+      track_name = menu_path.match(/\\.+\\.+\\(\w+\s{0,1}\w*)/)[1]
+
+      # Lets just fetch the 'real' markets rather than AvB, Antepost, Place etc
+      next unless track_name && !market_hash["name"].match(/To Be Placed/) && !menu_path.match(/ANTEPOST/) && !menu_path.match(/Forecast/) && track_name.match(/#{Date.today.day.ordinalize}/)
+
+      # Fetch the runners
+      bf_client.get_market market_id do |market_response|
+        market_details = market_response.hash_response
+        puts "Got market #{market_id} #{track_name} #{market_hash["name"]} #{Time.parse(market_details["market_time"])}"
+        runners = market_details["runners"]
+
+        # If the market is active, setup some periodical timers 
+        next unless market_details["status"] == "ACTIVE"
+
+        # would be nice to get the data from getSilks here
+        redis_client.hset track_name, market_hash["name"], {"market_details" => market_details, "prices" => nil}.to_json
+
+        next if num_timers > 59 # free API restriction
+
+        # Update the odds every 60 seconds
+        timers[market_id] = EventMachine::PeriodicTimer.new(60) do
+          num_timers += 1
+          bf_client.get_market_prices_compressed market_id do |prices_response|
+            puts "Fetching prices for #{market_id}"
+            price_data = prices_response.hash_response
+            timers[market_id].cancel if timers[market_id] && price_data["status"] != "ACTIVE"
+            race = redis_client.hget track_name, market_hash["name"]
+            race_hash = JSON.parse(race)
+            race_hash["prices"] = price_data
+            redis_client.hset track_name, market_hash["name"], race_hash.to_json
+          end
+        end
+
+      end
+
+    end
+
+  end
+
+}

data/lib/em-betfair/betfair_client.rb

@@ -0,0 +1,126 @@
+require 'uri'
+require 'em-http'
+require 'nokogiri'
+#require 'tzinfo'
+
+module Betfair
+
+  BETFAIR_TIME_ZONES = {"RSA"=>"Africa/Johannesburg", "AST"=>"US/Arizona", "MST"=>"US/Mountain", "JPT"=>"Japan", "HK"=>"Hongkong", "GMT"=>"GMT", "PKT"=>"Etc/GMT-5", "UAE"=>"Asia/Dubai", "CST"=>"US/Central", "AKST"=>"US/Alaska", "BRT"=>"Brazil/East", "INT"=>"Asia/Calcutta", "SMT"=>"America/Santiago", "MSK"=>"Europe/Moscow", "AWST"=>"Australia/Perth", "PST"=>"US/Pacific", "EST"=>"US/Eastern", "KMT"=>"Jamaica", "CET"=>"CET", "ANST"=>"Australia/Darwin", "ACST"=>"Australia/Adelaide", "NZT"=>"NZ", "UKT"=>"Europe/London", "AMT"=>"Brazil/West", "THAI"=>"Asia/Bangkok", "SJMT"=>"America/Costa_Rica", "HST"=>"US/Hawaii", "EET"=>"EET", "AEST"=>"Australia/Sydney", "IEST"=>"America/Indiana/Indianapolis", "AQST"=>"Australia/Queensland"}
+
+  class Client
+
+    attr_accessor :session_token
+
+    # config -          hash of betfair credentials & API endpoints
+    #                   { "username" => "<YOUR BETFAIR USERNAME>", "password" => "<YOUR BETFAIR PASSWORD>", "product_id" => "<YOUR BETFAIR PRODUCTID>", "exchange_endpoint" => "https://api.betfair.com/exchange/v5/BFExchangeService", "global_endpoint" => "https://api.betfair.com/global/v3/BFGlobalService" }
+    def initialize config
+      @config = config
+      @session_token = nil
+    end
+
+    # Creates a session on the Betfair API, used by Betfair::Client internally to maintain session.
+    def login &block
+      build_request "global", "login", {"username" => @config["username"], "password" => @config["password"], "product_id" => @config["product_id"]}, block
+    end
+
+    # Returns all the available markets on Betfair.
+    #
+    # countries -       array of ISO 3166-1 country codes
+    # event_type_ids -  array of Betfair event ids
+    # to_date -         DateTime
+    # from_date -       DateTime
+    def get_all_markets countries=nil, event_type_ids=nil, to_date=nil, from_date=nil, &block
+      with_session do
+        build_request "exchange", "get_all_markets", {"countries" => countries, "event_type_ids" => event_type_ids, "to_date" => to_date, "from_date" => from_date}, block
+      end
+    end
+
+    # Returns the details of a specifc market
+    # 
+    # market_id -       Betfair market ID
+    def get_market market_id, &block
+      with_session do
+        build_request "exchange", "get_market", {"market_id" => market_id }, block
+      end
+    end
+
+    # Returns the compressed market prices
+    # 
+    # market_id -       Betfair market ID
+    # currency_code -   three letter ISO 4217 country code
+    def get_market_prices_compressed market_id, currency_code=nil, &block
+      with_session do
+        build_request "exchange", "get_market_prices_compressed", {"market_id" => market_id, "currency_code" => currency_code}, block
+      end
+    end
+
+    # Returns the compressed traded volumes
+    # 
+    # market_id -       Betfair market ID
+    # currency_code -   three letter ISO 4217 country code
+    def get_market_traded_volume_compressed market_id, currency_code=nil, &block
+      with_session do
+        build_request "exchange", "get_market_traded_volume_compressed", {"market_id" => market_id, "currency_code" => currency_code}, block
+      end
+    end
+
+    private
+
+    # Builds the EM::Http request object
+    # 
+    # service_name -    the endpoint to use (exchange or global)
+    # action -          the API method to call on the API
+    # data -            hash of parameters to populate the SOAP request
+    # block -           the ballback for this request
+    def build_request service_name, action, data={}, block
+      request_data = { :data => data.merge!({"session_token" => @session_token}) }
+      soap_req = Betfair::SOAPRenderer.new( service_name, action ).render( request_data )
+      url = get_endpoint service_name
+      headers = { 'SOAPAction' => action, 'Accept-Encoding' => 'gzip,deflate', 'Content-type' => 'text/xml;charset=UTF-8' }
+      req = EventMachine::HttpRequest.new(url).post :body => soap_req, :head => headers
+      req.errback { block.call(Response.new(nil,nil,false,"Error connecting to the API"))  }
+      req.callback { parse_response(req.response,block) }
+    end
+
+    # Parses the API response, building a response object
+    # 
+    # raw_rsp -         response body from EM:Http request
+    # block -           callback for this request
+    def parse_response raw_rsp, block
+      parsed_response = Nokogiri::XML raw_rsp
+
+      soap_fault = parsed_response.xpath("//faultstring").first
+      if soap_fault
+        block.call(Response.new(raw_rsp,parsed_response,false,soap_fault.text))
+        return
+      end
+
+      api_error = parsed_response.xpath("//header/errorCode").text
+      method_error = parsed_response.xpath("//errorCode").last.text
+
+      error_rsp = api_error == "OK" ? method_error : api_error
+      unless api_error == "OK" && method_error == "OK"
+        @session_token = nil if [api_error,method_error].include?("NO_SESSION") # so we try and login on the next request
+        block.call(Response.new(raw_rsp,parsed_response,false,error_rsp))
+        return
+      end
+
+      @session_token = parsed_response.xpath("//sessionToken").text
+
+      block.call Response.new(raw_rsp,parsed_response,true)
+    end
+
+    def with_session
+      yield unless @session_token.nil?
+      login do |response|
+        yield
+      end
+    end
+
+    def get_endpoint service_name
+      return @config["#{service_name}_endpoint"]
+    end
+
+  end
+
+end

data/lib/em-betfair/response.rb

@@ -0,0 +1,41 @@
+# Stolen from Rails 3
+def underscore(camel_cased_word)
+  camel_cased_word.to_s.gsub(/::/, '/').
+  gsub(/([A-Z]+)([A-Z][a-z])/,'\1_\2').
+  gsub(/([a-z\d])([A-Z])/,'\1_\2').
+  tr("-", "_").
+  downcase
+end
+
+module Betfair
+
+  class Response
+    include ResponseParser
+
+    attr_accessor :raw_response # response string
+    attr_accessor :parsed_response # response xml
+    attr_accessor :successfull
+    attr_accessor :error
+
+    def initialize raw, parsed, successfull, error=""
+      @raw_response = raw
+      @parsed_response = parsed
+      @successfull = successfull
+      @error = error
+    end
+
+    # lazy loaded
+    def hash_response
+      method = get_response_type
+      self.send method.to_sym, self.parsed_response if method && self.respond_to?(method)
+    end
+
+    def get_response_type
+      return nil unless self.parsed_response.respond_to?(:xpath)
+      response_type = self.parsed_response.xpath("//ns:Envelope/ns:Body", "ns" => "http://schemas.xmlsoap.org/soap/envelope/").first.elements.first.name
+      underscore(response_type.gsub("Response",""))
+    end
+
+  end
+
+end

data/lib/em-betfair/response_parser.rb

@@ -0,0 +1,135 @@
+module Betfair
+
+  # TODO - version this to handle changes in the API
+  # TODO - this might be nicer as a structs style setup. e.g
+  # markets_rsp = GetAllMarkets.new(parsed_response)
+  module ResponseParser
+
+    # TODO - handle timezones, return local & utc time
+    # tz = TZInfo::Timezone.get(new_time_zone)
+    # race_time = tz.utc_to_local(race_time)
+
+    # TODO - return values as proper types rather than strings
+
+    def login xml
+      {"currency" => xml.xpath("//currency").text}
+    end
+
+    def get_all_markets xml
+      market_data = xml.xpath("//marketData").text
+      all_markets_hash = {"market_data" => {}}
+      market_data.split(":").each do |market|
+        market_fields = market.split("~")
+        next unless market_fields.size >= 16 #incase they append more fields
+        market_hash = {}
+        market_hash["id"] = market_fields[0]
+        market_hash["name"] = market_fields[1]
+        market_hash["type"] = market_fields[2]
+        market_hash["status"] = market_fields[3]
+        market_hash["date"] = Time.at(market_fields[4].to_i/1000).utc #Epoc time
+        market_hash["menu_path"] = market_fields[5]
+        market_hash["event_hierarchy"] = market_fields[6]
+        market_hash["bet_delay"] = market_fields[7]
+        market_hash["exchange_id"] = market_fields[8]
+        market_hash["country_code"] = market_fields[9]
+        market_hash["last_refresh"] = Time.at(market_fields[10].to_i/1000).utc #Epoc time
+        market_hash["num_runners"] = market_fields[11]
+        market_hash["num_winners"] = market_fields[12]
+        market_hash["total_amount_matched"] = market_fields[13]
+        market_hash["bsp_market"] = market_fields[14] == "Y"
+        market_hash["turning_in_play"] = market_fields[15] == "Y"
+
+        all_markets_hash["market_data"][market_fields[0]] = market_hash
+      end
+      all_markets_hash
+    end
+
+    def get_market xml
+      market_hash = {}
+      market_hash["id"] = xml.xpath("//market/marketId").text
+      market_hash["status"] = xml.xpath("//market/marketStatus").text
+      market_hash["parent_id"] = xml.xpath("//market/parentEventId").text
+      market_hash["country_code"] = xml.xpath("//market/countryISO3").text
+      market_hash["event_type"] = xml.xpath("//market/eventTypeId").text
+      market_hash["base_rate"] = xml.xpath("//market/marketBaseRate").text
+      market_hash["market_name"] = xml.xpath("//market/name").text
+      market_hash["num_winners"] = xml.xpath("//market/numberOfWinners").text
+      market_hash["market_time"] = xml.xpath("//market/marketTime").text
+
+      market_hash["runners"] = []
+
+      xml.xpath("//runners").children.each do |xml_runner|
+        name = xml_runner.xpath("name").text
+        selection_id = xml_runner.xpath("selectionId").text
+        market_hash["runners"].push({"selection_id" => selection_id, "name" => name})
+      end
+
+      market_hash
+    end
+
+    def get_market_prices_compressed xml
+      prices_hash = {}
+      prices = xml.xpath("//marketPrices").text
+      # Betfair uses colons as a seperator and escaped colons as a different seperator, grr.
+      # [1..-1] removes the first empty string
+      prices_data = prices.gsub('\:', 'ECSCOLON')[1..-1].split(":")
+
+      header_data = prices_data.slice!(0).gsub("ECSCOLON",":").split("~")
+
+      # TODO - parse removed runners properly
+      ["market_id","currency","status","in_play_delay","num_winners","market_info","discount_allowed","market_base_rate","refresh_time","removed_runners","bsp_market"].each_with_index do |field,index|
+        prices_hash[field] = header_data.at(index)
+      end
+
+      prices_data.each do |runner|
+        runner_hash = {}
+        runner_info, lay_prices, back_prices = runner.split("|")
+        runner_data = runner_info.split("~")
+
+        ["selection_id","order_index","total_matched","last_price_matched","handicap","reduction_factor","vacant","asian_line_id","far_sp_price","near_sp_price","actual_sp_price"].each_with_index do |field,index|
+          runner_hash[field] = runner_data.at(index)
+        end
+
+        runner_hash["lay_prices"] = []
+        lay_prices.split("~").each_slice(4) do |prices|
+          runner_hash["lay_prices"].push({"odds" => prices[0], "amount" => prices[1], "type" => prices[2], "depth" => prices[3]})
+        end
+
+        runner_hash["back_prices"] = []
+        back_prices.split("~").each_slice(4) do |prices|
+          runner_hash["back_prices"].push({"odds" => prices[0], "amount" => prices[1], "type" => prices[2], "depth" => prices[3]})
+        end
+
+        prices_hash[runner_hash["selection_id"]] = runner_hash
+      end
+      prices_hash
+    end
+
+    def get_market_traded_volume_compressed xml
+      traded_volumne_hash = {}
+      traded = xml.xpath("//tradedVolume").text
+      market_id = xml.xpath("//marketId").text
+      currency = xml.xpath("//currencyCode").text
+      # Betfair uses colons as a seperator and escaped colons as a different seperator, grr.
+      # [1..-1] removes the first empty string
+      traded_data = traded.gsub(/\\:/, "ECSCOLON")[1..-1].split(":")
+      traded_data.each do |runner|
+        # TODO - replace ECSCOLON with : 
+        runner_hash = {"traded_amounts" => []}
+        runner_data = runner.split("|")
+        header_data = runner_data.slice!(0).split("~")
+        ["selection_id", "asian_line_id", "bsp", "total_bsp_back_matched", "total_bsp_liability_matched"].each_with_index do |field,index|
+          runner_hash[field] = header_data.at(index)
+        end
+        runner_data.each do |traded_amount|
+          odds, total_matched = traded_amount.split("~")
+          runner_hash["traded_amounts"].push({"odds" => odds, "total_matched" => total_matched})
+        end
+        traded_volumne_hash[runner_hash["selection_id"]] = runner_hash
+      end
+      traded_volumne_hash
+    end
+
+  end
+
+end

data/lib/em-betfair/soap_renderer.rb

@@ -0,0 +1,29 @@
+require 'haml'
+require 'pathname'
+
+module Betfair
+
+  # Utility class to render a SOAP request from a haml file, embedding data
+  # elements as necessary
+  class SOAPRenderer
+
+    def initialize service, soap_name
+      base = Pathname.new(__FILE__).realpath.parent
+      file = "#{base}/views/#{service}/#{soap_name}.haml"
+      unless File.exists?( file )
+        $log.error "Cannot find HAML: #{file}" unless $log.nil?
+        raise "Cannot find HAML: #{file}"
+      end
+      @engine = Haml::Engine.new( File.read( file ) ) # this is quite expensive, might be better to keep a hash of renderers
+    end
+
+    def render content
+      content.each do |key,value|
+        self.instance_variable_set( "@#{key}", value )
+      end
+      @engine.render( self )
+    end
+
+  end
+
+end

data/lib/em-betfair/views/exchange/get_all_markets.haml

@@ -0,0 +1,23 @@
+%soapenv:Envelope{ "xmlns:soapenv"=> "http://schemas.xmlsoap.org/soap/envelope/", "xmlns:bfex"=>"http://www.betfair.com/publicapi/v5/BFExchangeService/", "xmlns:v5" => 'http://www.betfair.com/publicapi/types/exchange/v5/' }
+  %soapenv:Header
+  %soapenv:Body
+    %bfex:getAllMarkets
+      %bfex:request
+        %header
+          - if @data["client_stamp"]
+            %clientStamp= @data["client_stamp"]
+          %sessionToken= @data["session_token"]
+        - if @data["locale"]
+          %locale= @data["locale"]
+        - if @data["event_type_ids"]
+          %eventTypeIds
+            - @data["event_type_ids"].each do |event_id|
+              %int=event_id
+        - if @data["countries"]
+          %countries
+            - @data["countries"].each do |cc|
+              %Country= cc
+        - if @data["from_date"]
+          %fromDate= @data["from_date"]
+        - if @data["to_date"]
+          %toDate= @data["to_date"]

data/lib/em-betfair/views/exchange/get_market.haml

@@ -0,0 +1,12 @@
+%soapenv:Envelope{"xmlns:soapenv" => "http://schemas.xmlsoap.org/soap/envelope/", "xmlns:bfex" => "http://www.betfair.com/publicapi/v5/BFExchangeService/" }
+  %soapenv:Header
+  %soapenv:Body
+    %bfex:getMarket
+      %bfex:request
+        %header
+          - if @data["client_stamp"]
+            %clientStamp= @data["client_stamp"]
+          %sessionToken= @data["session_token"]
+        - if @data["locale"]
+          %locale= @data["locale"]
+        %marketId= @data["market_id"]

data/lib/em-betfair/views/exchange/get_market_prices_compressed.haml

@@ -0,0 +1,12 @@
+%Envelope{ "xmlns:bfex" => 'http://www.betfair.com/publicapi/v5/BFExchangeService/', "xmlns:soapenv" => 'http://schemas.xmlsoap.org/soap/envelope/'} 
+  %soapenv:Header
+  %soapenv:Body
+    %bfex:getMarketPricesCompressed
+      %bfex:request
+        %header
+          - if @data["client_stamp"]
+            %clientStamp= @data["client_stamp"]
+          %sessionToken= @data["session_token"]
+        - if @data["currency_code"]
+          %currencyCode= @data["currency_code"]
+        %marketId= @data["market_id"]

data/lib/em-betfair/views/exchange/get_market_traded_volume_compressed.haml

@@ -0,0 +1,12 @@
+%Envelope{ "xmlns:bfex" => 'http://www.betfair.com/publicapi/v5/BFExchangeService/', "xmlns:soapenv" => 'http://schemas.xmlsoap.org/soap/envelope/'} 
+  %soapenv:Header
+  %soapenv:Body
+    %bfex:getMarketTradedVolumeCompressed
+      %bfex:request
+        %header
+          - if @data["client_stamp"]
+            %clientStamp= @data["client_stamp"]
+          %sessionToken= @data["session_token"]
+        - if @data["currency_code"]
+          %currencyCode= @data["currency_code"]
+        %marketId= @data["market_id"]

data/lib/em-betfair/views/global/get_all_event_types.haml

@@ -0,0 +1,12 @@
+%soapenv:Envelope{"xmlns:soapenv"=>"http://schemas.xmlsoap.org/soap/envelope/", "xmlns:bfg"=> "http://www.betfair.com/publicapi/v3/BFGlobalService/" }
+  %soapenv:Header/
+  %soapenv:Body
+    %bfg:getAllEventTypes
+      %bfg:request
+        %header
+          - if @data["client_stamp"]
+            %clientStamp= @data["client_stamp"]
+          %sessionToken= @data["session_token"]
+        - if @data["locale"]
+          %locale= @data["locale"]
+ 

data/lib/em-betfair/views/global/login.haml

@@ -0,0 +1,11 @@
+%soapenv:Envelope{ "xmlns:soapenv"=> "http://schemas.xmlsoap.org/soap/envelope/", "xmlns:bfg"=> "http://www.betfair.com/publicapi/v3/BFGlobalService/" }
+   %soapenv:Header
+   %soapenv:Body
+      %bfg:login
+         %bfg:request
+            %ipAddress= @data['ip_address']||0
+            %locationId= @data['location_id']||0
+            %password= @data['password']
+            %productId= @data['product_id']
+            %username= @data['username']
+            %vendorSoftwareId= @data['vender_software_id']||0

data/lib/em-betfair/views/global/retrieve_limb_message.haml

@@ -0,0 +1,9 @@
+%soapenv:Envelope{ "xmlns:soapenv"=> "http://schemas.xmlsoap.org/soap/envelope/", "xmlns:bfg"=> "http://www.betfair.com/publicapi/v3/BFGlobalService/" }
+  %soapenv:Header
+  %soapenv:Body
+    %bfg:retrieveLIMBMessage
+      %bfg:request
+        %header
+          - if @data["client_stamp"]
+            %clientStamp= @data["client_stamp"]
+          %sessionToken= @data["session_token"]

data/lib/em-betfair/views/global/submit_limb_message.haml

@@ -0,0 +1,14 @@
+%soapenv:Envelope{ "xmlns:soapenv"=> "http://schemas.xmlsoap.org/soap/envelope/", "xmlns:bfg"=> "http://www.betfair.com/publicapi/v3/BFGlobalService/", "xmlns:v3" => "http://www.betfair.com/publicapi/types/global/v3/" }
+  %soapenv:Header
+  %soapenv:Body
+    %bfg:submitLIMBMessage>
+      %bfg:request
+        %header
+          - if @data["client_stamp"]
+            %clientStamp= @data["client_stamp"]
+          %sessionToken= @data["session_token"]
+        %password= @data["password"]
+        %submitPasswordChangeMessage
+          %messageId= @data["message_id"]
+          %newPassword= @data["new_password"]
+          %newPasswordRepeat= @data["new_password"]

data/lib/em-betfair.rb

@@ -0,0 +1,4 @@
+require 'em-betfair/soap_renderer'
+require 'em-betfair/response_parser'
+require 'em-betfair/response'
+require 'em-betfair/betfair_client'