betfair_api_ng_rails 1.1.0 → 2.1.0

data/lib/betfair_api_ng_rails/api/data/statement_item.rb

@@ -0,0 +1,30 @@
+module BetfairApiNgRails
+  module Api
+    module Data
+      #
+      # Summary of a cleared order.
+      #
+      class StatementItem < Api::Data::Base
+        include Api::Data::Concerns::Hashable
+
+        STATEMENT_ITEM_ATTRS = [
+          :ref_id,
+          :item_date,
+          :amount,
+          :balance,
+          :item_class,
+          :item_class_data,
+          { legacy_data: { type: BetfairApiNgRails::StatementLegacyData } }
+        ]
+
+        attributes STATEMENT_ITEM_ATTRS
+
+        def self.to_hash_attrs
+          STATEMENT_ITEM_ATTRS
+        end
+      end
+    end
+  end
+end
+
+

data/lib/betfair_api_ng_rails/api/data/statement_legacy_data.rb

@@ -0,0 +1,40 @@
+module BetfairApiNgRails
+  module Api
+    module Data
+      #
+      # Summary of a cleared order.
+      #
+      class StatementLegacyData < Api::Data::Base
+        include Api::Data::Concerns::Hashable
+
+        STATEMENT_LEGACY_DATA_ATTRS = [
+          :avg_price,
+          :bet_size,
+          :bet_type,
+          :bet_category_type,
+          :comission_rate,
+          :event_id,
+          :event_type_id,
+          :full_market_name,
+          :gross_bet_amount,
+          :market_name,
+          :market_type,
+          :placed_date,
+          :selection_id,
+          :selection_name,
+          :start_date,
+          :transaction_type,
+          :transaction_id,
+          :win_lose
+        ]
+
+        attributes STATEMENT_LEGACY_DATA_ATTRS
+
+        def self.to_hash_attrs
+          STATEMENT_LEGACY_DATA_ATTRS
+        end
+      end
+    end
+  end
+end
+

data/lib/betfair_api_ng_rails/api/endpoint_factory.rb

@@ -0,0 +1,21 @@
+require 'active_support/core_ext/object'
+
+module BetfairApiNgRails
+  module Api
+    class EndpointFactory
+      class << self
+        def call(name)
+          name.is_a?(Symbol) ? init_by_name(name) : name.try(:new)
+        end
+
+        private
+
+        def init_by_name(name)
+          "BetfairApiNgRails::Api::Endpoints::#{name.to_s.camelize}".constantize.new
+        rescue NameError
+          raise Api::InvalidEndpointError, "Could not found endpoint `#{name}`!"
+        end
+      end
+    end
+  end
+end

data/lib/betfair_api_ng_rails/api/endpoints/australian.rb

@@ -0,0 +1,17 @@
+module BetfairApiNgRails
+  module Api
+    module Endpoints
+      class Australian < Base
+        protected
+
+        def api_domain
+          "api-au.betfair.com"
+        end
+
+        def login_domain
+          "identitysso.betfair.com"
+        end
+      end
+    end
+  end
+end

data/lib/betfair_api_ng_rails/api/endpoints/base.rb

@@ -0,0 +1,42 @@
+module BetfairApiNgRails
+  module Api
+    module Endpoints
+      #
+      # Template class for defining endpoints.
+      # Api endpoint provides URL building methods.
+      # In derived classes (endpoints) you must to reimplement next protected methods:
+      # - `#api_domain`
+      # - `#login_domain`
+      #
+      class Base
+        #
+        # Provides api url for specified api type
+        #
+        # Parameters:
+        # api_type - one of the :betting or :account
+        #
+        def api_url(api_type)
+          "https://#{api_domain}/exchange/#{api_type}/json-rpc/v1"
+        end
+
+        def login_url
+          "https://#{login_domain}/api/certlogin"
+        end
+
+        def keep_alive_url
+          "https://#{login_domain}/api/keepAlive"
+        end
+
+        protected
+
+        def api_domain
+          raise NotImplementedError
+        end
+
+        def login_domain
+          raise NotImplementedError
+        end
+      end
+    end
+  end
+end

data/lib/betfair_api_ng_rails/api/endpoints/italian.rb

@@ -0,0 +1,17 @@
+module BetfairApiNgRails
+  module Api
+    module Endpoints
+      class Italian < Base
+        protected
+
+        def api_domain
+          "api.betfair.com"
+        end
+
+        def login_domain
+          "identitysso.betfair.it"
+        end
+      end
+    end
+  end
+end

data/lib/betfair_api_ng_rails/api/endpoints/spanish.rb

@@ -0,0 +1,17 @@
+module BetfairApiNgRails
+  module Api
+    module Endpoints
+      class Spanish < Base
+        protected
+
+        def api_domain
+          "api.betfair.com"
+        end
+
+        def login_domain
+          "identitysso.betfair.es"
+        end
+      end
+    end
+  end
+end

data/lib/betfair_api_ng_rails/api/endpoints/uk.rb

@@ -0,0 +1,17 @@
+module BetfairApiNgRails
+  module Api
+    module Endpoints
+      class Uk < Base
+        protected
+
+        def api_domain
+          "api.betfair.com"
+        end
+
+        def login_domain
+          "identitysso.betfair.com"
+        end
+      end
+    end
+  end
+end

data/lib/betfair_api_ng_rails/api/enums/execution_report_error_code.rb

@@ -1,6 +1,27 @@
 module BetfairApiNgRails
   module Api
     module Enums
+      #
+      # Error code of execution report
+      #
+      # Includes:
+      # ERROR_IN_MATCHER - The matcher is not healthy
+      # PROCESSED_WITH_ERRORS - The order itself has been accepted, but at least one (possibly all) actions have generated errors
+      # BET_ACTION_ERROR - There is an error with an action that has caused the entire order to be rejected
+      # INVALID_ACCOUNT_STATE - Order rejected due to the account's status (suspended, inactive, dup cards)
+      # INVALID_WALLET_STATUS - Order rejected due to the account's wallet's status
+      # INSUFFICIENT_FUNDS - Account has exceeded its exposure limit or available to bet limit
+      # LOSS_LIMIT_EXCEEDED - The account has exceed the self imposed loss limit
+      # MARKET_SUSPENDED - Market is suspended
+      # MARKET_NOT_OPEN_FOR_BETTING - Market is not open for betting. It is either not yet active, suspended or closed awaiting settlement.
+      # DUPLICATE_TRANSACTION - duplicate customer referece data submitted
+      # INVALID_ORDER - Order cannot be accepted by the matcher due to the combination of actions. For example, bets being edited are not on the same market, or order includes both edits and placement
+      # INVALID_MARKET_ID - Market doesn't exist
+      # PERMISSION_DENIED - Business rules do not allow order to be placed
+      # DUPLICATE_BETIDS - duplicate bet ids found
+      # NO_ACTION_REQUIRED - Order hasn't been passed to matcher as system detected there will be no state change
+      # SERVICE_UNAVAILABLE - The requested service is unavailable
+      # REJECTED_BY_REGULATOR - The regulator rejected the order. On the Italian Exchange this error will occur if more than 50 bets are sent in a single placeOrders request.
       class ExecutionReportErrorCode
         extend Api::Enums::Concerns::Enumable
 
@@ -25,4 +46,4 @@ module BetfairApiNgRails
       end
     end
   end
-end
+end

data/lib/betfair_api_ng_rails/api/enums/execution_report_status.rb

@@ -1,6 +1,17 @@
 module BetfairApiNgRails
   module Api
     module Enums
+      #
+      # Status of execution report
+      #
+      # Includes:
+      # SUCCESS               - Order processed successfully
+      # FAILURE               - Order failed.
+      # PROCESSED_WITH_ERRORS - The order itself has been accepted, but at least one (possibly all)
+      #                         actions have generated errors. This error only occurs for replaceOrders,
+      #                         cancelOrders and updateOrders operations. The placeOrders operation will not return
+      #                         PROCESSED_WITH_ERRORS status as it is an atomic operation.
+      # TIMEOUT               - Order timed out.
       class ExecutionReportStatus
         extend Api::Enums::Concerns::Enumable
 
@@ -12,4 +23,4 @@ module BetfairApiNgRails
       end
     end
   end
-end
+end

data/lib/betfair_api_ng_rails/api/enums/include_item.rb

@@ -0,0 +1,23 @@
+module BetfairApiNgRails
+  module Api
+    module Enums
+      # Specifies item type to include for account statement report
+      #
+      # Includes:
+      # ALL                  - Include all items
+      # DEPOSITS_WITHDRAWALS - Include payments only
+      # EXCHANGE             - Include exchange bets only
+      # POKER_ROOM           - Include poker transactions only
+      #
+      class IncludeItem
+        extend Api::Enums::Concerns::Enumable
+
+        enumify "ALL",
+                "DEPOSITS_WITHDRAWALS",
+                "EXCHANGE",
+                "POKER_ROOM"
+      end
+    end
+  end
+end
+

data/lib/betfair_api_ng_rails/api/enums/instruction_report_error_code.rb

@@ -1,6 +1,30 @@
 module BetfairApiNgRails
   module Api
     module Enums
+      #
+      # Indicates cause of failure
+      #
+      # Includes:
+      # INVALID_BET_SIZE - bet size is invalid for your currency or your regulator
+      # INVALID_RUNNER - Runner does not exist, includes vacant traps in greyhound racing
+      # BET_TAKEN_OR_LAPSED - Bet cannot be cancelled or modified as it has already been taken or has lapsed Includes attempts to cancel/modify market on close BSP bets and cancelling limit on close BSP bets
+      # BET_IN_PROGRESS - No result was received from the matcher in a timeout configured for the system
+      # RUNNER_REMOVED - Runner has been removed from the event
+      # MARKET_NOT_OPEN_FOR_BETTING - Attempt to edit a bet on a market that has closed.
+      # LOSS_LIMIT_EXCEEDED - The action has caused the account to exceed the self imposed loss limit
+      # MARKET_NOT_OPEN_FOR_BSP_BETTING - Market now closed to bsp betting. Turned in-play or has been reconciled
+      # INVALID_PRICE_EDIT - Attempt to edit down the price of a bsp limit on close lay bet, or edit up the price of a limit on close back bet
+      # INVALID_ODDS - Odds not on price ladder - either edit or placement
+      # INSUFFICIENT_FUNDS - Insufficient funds available to cover the bet action. Either the exposure limit or available to bet limit would be exceeded
+      # INVALID_PERSISTENCE_TYPE - Invalid persistence type for this market, e.g. KEEP for a non bsp market
+      # ERROR_IN_MATCHER - A problem with the matcher prevented this action completing successfully
+      # INVALID_BACK_LAY_COMBINATION - The order contains a back and a lay for the same runner at overlapping prices. This would guarantee a self match. This also applies to BSP limit on close bets
+      # ERROR_IN_ORDER - The action failed because the parent order failed
+      # INVALID_BID_TYPE - Bid type is mandatory
+      # INVALID_BET_ID - Bet for id supplied has not been found
+      # CANCELLED_NOT_PLACED - Bet cancelled but replacement bet was not placed
+      # RELATED_ACTION_FAILED - Action failed due to the failure of a action on which this action is dependent
+      # NO_ACTION_REQUIRED - the action does not result in any state change. eg changing a persistence to it's current value
       class InstructionReportErrorCode
         extend Api::Enums::Concerns::Enumable
 
@@ -28,4 +52,4 @@ module BetfairApiNgRails
       end
     end
   end
-end
+end

data/lib/betfair_api_ng_rails/api/enums/instruction_report_status.rb

@@ -1,6 +1,13 @@
 module BetfairApiNgRails
   module Api
     module Enums
+      #
+      # Indicates whether the command succeeded or failed
+      #
+      # Includes:
+      # SUCCESS
+      # FAILURE
+      # TIMEOUT
       class InstructionReportStatus
         extend Api::Enums::Concerns::Enumable
 
@@ -11,4 +18,4 @@ module BetfairApiNgRails
       end
     end
   end
-end
+end

data/lib/betfair_api_ng_rails/api/enums/item_class.rb

@@ -0,0 +1,19 @@
+module BetfairApiNgRails
+  module Api
+    module Enums
+      # Class of statement item
+      #
+      # Includes:
+      # UNKNOWN - Statement item not mapped to a specific class.
+      #
+      class ItemClass
+        extend Api::Enums::Concerns::Enumable
+
+        enumify "UNKNOWN"
+      end
+    end
+  end
+end
+
+
+

data/lib/betfair_api_ng_rails/api/enums/order_status.rb

@@ -1,6 +1,12 @@
 module BetfairApiNgRails
   module Api
     module Enums
+      #
+      # Either EXECUTABLE (an unmatched amount remains) or EXECUTION_COMPLETE (no unmatched amount remains).
+      #
+      # Includes:
+      # EXECUTION_COMPLETE - An order that does not have any remaining unmatched portion.
+      # EXECUTABLE         - An order that has a remaining unmatched portion.
       class OrderStatus
         extend Api::Enums::Concerns::Enumable
 
@@ -10,4 +16,4 @@ module BetfairApiNgRails
       end
     end
   end
-end
+end

data/lib/betfair_api_ng_rails/api/enums/order_type.rb

@@ -1,14 +1,23 @@
 module BetfairApiNgRails
   module Api
     module Enums
+      #
+      # The type of bet (e.g standard limited-liability Exchange bet (LIMIT), a standard BSP bet (MARKET_ON_CLOSE), or
+      # a minimum-accepted-price BSP bet (LIMIT_ON_CLOSE)). If the bet has a OrderType of MARKET_ON_CLOSE and
+      # a persistenceType of MARKET_ON_CLOSE then it is a bet which has transitioned from LIMIT to MARKET_ON_CLOSE.
+      # Only available at BET groupBy level
+      #
+      # Includes:
+      # LIMIT           - A normal exchange limit order for immediate execution
+      # LIMIT_ON_CLOSE  - Limit order for the auction (SP)
+      # MARKET_ON_CLOSE - Market order for the auction (SP)
       class OrderType
         extend Api::Enums::Concerns::Enumable
 
         enumify "LIMIT",
                 "LIMIT_ON_CLOSE",
                 "MARKET_ON_CLOSE"
-
       end
     end
   end
-end
+end

data/lib/betfair_api_ng_rails/api/enums/persistence_type.rb

@@ -1,6 +1,13 @@
 module BetfairApiNgRails
   module Api
     module Enums
+      #
+      # The turn in play persistence state of the order at bet placement time.
+      #
+      # Includes:
+      # LAPSE           - Lapse the order when the market is turned in-play
+      # PERSIST         - Persist the order to in-play. The bet will be place automatically into the in-play market at the start of the event.
+      # MARKET_ON_CLOSE - Put the order into the auction (SP) at turn-in-play
       class PersistenceType
         extend Api::Enums::Concerns::Enumable
 
@@ -11,4 +18,4 @@ module BetfairApiNgRails
       end
     end
   end
-end
+end

data/lib/betfair_api_ng_rails/api/enums/side.rb

@@ -1,13 +1,18 @@
 module BetfairApiNgRails
   module Api
     module Enums
+      #
+      # Indicates if the bet is a Back or a LAY
+      #
+      # Includes:
+      # BACK - To back a team, horse or outcome is to bet on the selection to win.
+      # LAY  - To lay a team, horse, or outcome is to bet on the selection to lose.
       class Side
         extend Api::Enums::Concerns::Enumable
 
         enumify "BACK",
                 "LAY"
-
       end
     end
   end
-end
+end