binance-ruby 0.2 → 0.6.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 590acab5cf686ad0c4fa8947e18d8d79fcd78a40
-  data.tar.gz: 7a1a0ff15880ee257ee99b25822e90bd313d476c
+SHA256:
+  metadata.gz: 6d71494bbe1c0bd851ad2da5dd0e1d5835bc8ca46929e7b02acb0212d419db05
+  data.tar.gz: d843c4b5e0e87c62107221a36dcc3d1dac5e12799e503ddde86e366a0e10b06d
 SHA512:
-  metadata.gz: 53244d7dd72226826c260833e6eb57f560ca35fb1b25c717f27b0d309480aa2dc08b57cf65da9a8565f16d36f098588d5bc050930ca27c9eefcf40d886dbd7de
-  data.tar.gz: d618b151472626dc7d6df8f06eb48809807be7cfdd23b91f49e2de929cd27d368d35c6f39e8557b6e8181fb252b677365a0fdc49910e66c3bcbbc2a88f20f7f6
+  metadata.gz: 6b390a772ad52d2d4156f285e170750b72509cd8073a5a59e0bffcbd860e0898cfcc8a3351562590a7a4ae7e8c2a851891745d2433ffddf0bbc04737a3593add
+  data.tar.gz: 1fb3555d422881f2b6272679952edd9a49c849e8d1142f58933d6ec4c6b03429d57a96825dec09c2327ed783ef7162bee0668e4fa1eee938d0d8aa943d155df4

data/lib/binance-ruby.rb

@@ -1,12 +1,13 @@
-require 'active_support/core_ext/string'
-require 'awrence'
-require 'httparty'
+require "active_support/core_ext/string"
+require "awrence"
+require "httparty"
 
-require 'binance/api'
-require 'binance/api/account'
-require 'binance/api/configuration'
-require 'binance/api/data_stream'
-require 'binance/api/error'
-require 'binance/api/order'
-require 'binance/api/request'
+require "binance/api"
+require "binance/api/account"
+require "binance/api/configuration"
+require "binance/api/data_stream"
+require "binance/api/error"
+require "binance/api/margin/order"
+require "binance/api/order"
+require "binance/api/request"
 require "binance/api/version"

data/lib/binance/api.rb

@@ -3,49 +3,49 @@ module Binance
     class << self
       # Valid limits:[5, 10, 20, 50, 100, 500, 1000]
       def candlesticks!(endTime: nil, interval: nil, limit: 500, startTime: nil, symbol: nil)
-        raise Error.new(message: 'interval is required') unless interval
-        raise Error.new(message: 'symbol is required') unless symbol
+        raise Error.new(message: "interval is required") unless interval
+        raise Error.new(message: "symbol is required") unless symbol
         params = { endTime: endTime, interval: interval, limit: limit, startTime: startTime, symbol: symbol }
-        Request.send!(api_key_type: :read_info, path: '/api/v1/klines', params: params)
+        Request.send!(api_key_type: :read_info, path: "/api/v1/klines", params: params)
       end
 
       def compressed_aggregate_trades!(endTime: nil, fromId: nil, limit: 500, startTime: nil, symbol: nil)
         raise Error.new(message: "symbol is required") unless symbol
         params = {
-          endTime: endTime, fromId: fromId, limit: limit, startTime: startTime, symbol: symbol
+          endTime: endTime, fromId: fromId, limit: limit, startTime: startTime, symbol: symbol,
         }.delete_if { |key, value| value.nil? }
-        Request.send!(api_key_type: :read_info, path: '/api/v1/aggTrades', params: params)
+        Request.send!(api_key_type: :read_info, path: "/api/v1/aggTrades", params: params)
       end
 
       def depth!(symbol: nil, limit: 100)
         raise Error.new(message: "symbol is required") unless symbol
         params = { limit: limit, symbol: symbol }
-        Request.send!(api_key_type: :read_info, path: '/api/v1/depth', params: params)
+        Request.send!(api_key_type: :read_info, path: "/api/v1/depth", params: params)
       end
 
       def exchange_info!
-        Request.send!(api_key_type: :read_info, path: '/api/v1/exchangeInfo')
+        Request.send!(api_key_type: :read_info, path: "/api/v1/exchangeInfo")
       end
 
       def historical_trades!(symbol: nil, limit: 500, fromId: nil)
         raise Error.new(message: "symbol is required") unless symbol
         params = { fromId: fromId, limit: limit, symbol: symbol }
-        Request.send!(api_key_type: :read_info, path: '/api/v1/historicalTrades', params: params, security_type: :market_data)
+        Request.send!(api_key_type: :read_info, path: "/api/v1/historicalTrades", params: params, security_type: :market_data)
       end
 
       def info!(recvWindow: nil)
         timestamp = Configuration.timestamp
         params = { recvWindow: recvWindow, timestamp: timestamp }.delete_if { |key, value| value.nil? }
-        Request.send!(api_key_type: :read_info, path: '/api/v3/account', params: params, security_type: :user_data)
+        Request.send!(api_key_type: :read_info, path: "/api/v3/account", params: params, security_type: :user_data)
       end
 
       def ping!
-        Request.send!(path: '/api/v1/ping')
+        Request.send!(path: "/api/v1/ping")
       end
 
       def ticker!(symbol: nil, type: nil)
         ticker_type = type&.to_sym
-        error_message = "type must be one of: #{ticker_types.join(', ')}. #{type} was provided."
+        error_message = "type must be one of: #{ticker_types.join(", ")}. #{type} was provided."
         raise Error.new(message: error_message) unless ticker_types.include? ticker_type
         path = ticker_path(type: ticker_type)
         params = symbol ? { symbol: symbol } : {}
@@ -53,13 +53,13 @@ module Binance
       end
 
       def time!
-        Request.send!(path: '/api/v1/time')
+        Request.send!(path: "/api/v1/time")
       end
 
       def trades!(symbol: nil, limit: 500)
         raise Error.new(message: "symbol is required") unless symbol
         params = { limit: limit, symbol: symbol }
-        Request.send!(api_key_type: :read_info, path: '/api/v1/trades', params: params)
+        Request.send!(api_key_type: :read_info, path: "/api/v1/trades", params: params)
       end
 
       private
@@ -67,8 +67,8 @@ module Binance
       def ticker_path(type:)
         case type
         when :daily
-          '/api/v1/ticker/24hr'
-        when :price, :bookTicker
+          "/api/v1/ticker/24hr"
+        when :price, :bookTicker, :avgPrice
           "/api/v3/ticker/#{type.to_s.camelize(:lower)}"
         end
       end

data/lib/binance/api/account.rb

@@ -2,6 +2,14 @@ module Binance
   module Api
     class Account
       class << self
+        def fees!(recvWindow: 5000)
+          timestamp = Configuration.timestamp
+          params = { recvWindow: recvWindow, timestamp: timestamp }
+          Request.send!(api_key_type: :read_info, path: "/wapi/v3/assetDetail.html",
+                        params: params.delete_if { |key, value| value.nil? },
+            security_type: :user_data)
+        end
+
         def info!(recvWindow: 5000)
           timestamp = Configuration.timestamp
           params = { recvWindow: recvWindow, timestamp: timestamp }

data/lib/binance/api/configuration.rb

@@ -1,43 +1,58 @@
-require 'openssl'
-require 'base64'
+require "openssl"
+require "base64"
 
 module Binance
   module Api
     class Configuration
       class << self
-        attr_writer :api_key, :read_info_api_key, :trading_api_key, :withdrawals_api_key
-        attr_writer :secret_key
-        
+        attr_writer :api_key, :locale, :read_info_api_key, :secret_key,
+          :trading_api_key, :withdrawals_api_key
+
         def api_key(type: nil)
           raise Error.new(message: "invalid security_type type: #{type}.") unless type.nil? || api_key_types.include?(type)
           instance_api_key(type: type) || ENV["BINANCE_#{type.to_s.humanize.upcase}_API_KEY"] ||
-          instance_api_key             || ENV["BINANCE_API_KEY"]
+          instance_api_key || ENV["BINANCE_API_KEY"]
+        end
+
+        def tld
+          tld = ENV["BINANCE_TLD"]&.downcase&.to_sym || :com
+          validate_tld!(tld)
+          tld
         end
-        
+
         def secret_key
-          instance_variable_get("@secret_key") || ENV['BINANCE_SECRET_KEY']
+          instance_variable_get("@secret_key") || ENV["BINANCE_SECRET_KEY"]
         end
 
         def signed_request_signature(payload:)
           raise Error.new(message: "environment variable 'BINANCE_SECRET_KEY' is required " \
-            "for signed requests.") unless secret_key
+                          "for signed requests.") unless secret_key
           digest = OpenSSL::Digest::SHA256.new
           OpenSSL::HMAC.hexdigest(digest, secret_key, payload)
         end
 
         def timestamp
-          Time.now.utc.strftime('%s%3N')
+          Time.now.utc.strftime("%s%3N")
+        end
+
+        def validate_tld!(tld)
+          error_message = "Invalid tld (top-level-domain): #{tld}. Use one of: #{allowed_tlds.join(", ")}."
+          raise Error.new(message: error_message) unless allowed_tlds.include?(tld&.to_sym)
         end
 
         private
 
+        def allowed_tlds
+          [:com, :us]
+        end
+
         def api_key_types
           [:none, :read_info, :trading, :withdrawals].freeze
         end
 
         def instance_api_key(type: nil)
-          var = "#{type.to_s.downcase}_api_key".sub(/^\_/, '')
-          instance_variable_get('@' + var)
+          var = "#{type.to_s.downcase}_api_key".sub(/^\_/, "")
+          instance_variable_get("@" + var)
         end
       end
     end

data/lib/binance/api/error.rb

@@ -1,7 +1,7 @@
 module Binance
   module Api
     class Error < StandardError
-      attr_reader :code, :msg
+      attr_reader :code, :msg, :symbol
 
       class << self
         # https://github.com/binance-exchange/binance-official-api-docs/blob/master/errors.md
@@ -10,9 +10,10 @@ module Binance
         end
       end
 
-      def initialize(code: nil, json: {}, message: nil)
+      def initialize(code: nil, json: {}, message: nil, symbol: nil)
         @code = code || json[:code]
         @msg = message || json[:msg]
+        @symbol = message || json[:symbol]
       end
 
       def inspect

data/lib/binance/api/margin/order.rb

@@ -0,0 +1,54 @@
+module Binance
+  module Api
+    module Margin
+      class Order
+        class << self
+          def create!(symbol: nil, isIsolated: false, side: nil, type: nil, quantity: nil,
+                      quoteOrderQty: nil, price: nil, stopPrice: nil, newClientOrderId: nil,
+                      icebergQty: nil, newOrderRespType: nil, sideEffectType: nil, timeInForce: nil,
+                      recvWindow: nil)
+            timestamp = Configuration.timestamp
+            params = {
+              symbol: symbol, isIsolated: isIsolated, side: side, type: type,
+              quantity: quantity, quoteOrderQty: quoteOrderQty, price: price,
+              stopPrice: stopPrice, newClientOrderId: newClientOrderId, icebergQty: icebergQty,
+              newOrderRespType: newOrderRespType, sideEffectType: sideEffectType,
+              timeInForce: timeInForce, recvWindow: recvWindow, timestamp: timestamp,
+            }.delete_if { |_, value| value.nil? }
+            ensure_required_create_keys!(params: params)
+            path = "/sapi/v1/margin/order"
+            Request.send!(api_key_type: :trading, method: :post, path: path,
+                          params: params, security_type: :trade, tld: Configuration.tld)
+          end
+
+          private
+
+          def additional_required_create_keys(type:)
+            case type
+            when :limit
+              [:price, :timeInForce].freeze
+            when :stop_loss, :take_profit
+              [:stopPrice].freeze
+            when :stop_loss_limit, :take_profit_limit
+              [:price, :stopPrice, :timeInForce].freeze
+            when :limit_maker
+              [:price].freeze
+            else
+              [].freeze
+            end
+          end
+
+          def ensure_required_create_keys!(params:)
+            keys = required_create_keys.dup.concat(additional_required_create_keys(type: params[:type]))
+            missing_keys = keys.select { |key| params[key].nil? }
+            raise Error.new(message: "required keys are missing: #{missing_keys.join(", ")}") unless missing_keys.empty?
+          end
+
+          def required_create_keys
+            [:symbol, :side, :type, :timestamp].freeze
+          end
+        end
+      end
+    end
+  end
+end

data/lib/binance/api/order.rb

@@ -9,56 +9,56 @@ module Binance
           params = { limit: limit, orderId: orderId, recvWindow: recvWindow, symbol: symbol, timestamp: timestamp }
           Request.send!(api_key_type: :read_info, path: "/api/v3/allOrders",
                         params: params.delete_if { |key, value| value.nil? },
-                        security_type: :user_data)
+                        security_type: :user_data, tld: Configuration.tld)
         end
 
         # Be careful when accessing without a symbol!
         def all_open!(recvWindow: 5000, symbol: nil)
           timestamp = Configuration.timestamp
           params = { recvWindow: recvWindow, symbol: symbol, timestamp: timestamp }
-          Request.send!(api_key_type: :read_info, path: '/api/v3/openOrders',
-                        params: params, security_type: :user_data)
+          Request.send!(api_key_type: :read_info, path: "/api/v3/openOrders",
+                        params: params, security_type: :user_data, tld: Configuration.tld)
         end
 
         def cancel!(orderId: nil, originalClientOrderId: nil, newClientOrderId: nil, recvWindow: nil, symbol: nil)
           raise Error.new(message: "symbol is required") if symbol.nil?
           raise Error.new(message: "either orderid or originalclientorderid " \
-            "is required") if orderId.nil? && originalClientOrderId.nil?
+                          "is required") if orderId.nil? && originalClientOrderId.nil?
           timestamp = Configuration.timestamp
           params = { orderId: orderId, origClientOrderId: originalClientOrderId,
                      newClientOrderId: newClientOrderId, recvWindow: recvWindow,
                      symbol: symbol, timestamp: timestamp }.delete_if { |key, value| value.nil? }
           Request.send!(api_key_type: :trading, method: :delete, path: "/api/v3/order",
-                        params: params, security_type: :trade)
+                        params: params, security_type: :trade, tld: Configuration.tld)
         end
 
         def create!(icebergQuantity: nil, newClientOrderId: nil, newOrderResponseType: nil,
                     price: nil, quantity: nil, recvWindow: nil, stopPrice: nil, symbol: nil,
                     side: nil, type: nil, timeInForce: nil, test: false)
           timestamp = Configuration.timestamp
-          params = { 
+          params = {
             icebergQty: icebergQuantity, newClientOrderId: newClientOrderId,
             newOrderRespType: newOrderResponseType, price: price, quantity: quantity,
             recvWindow: recvWindow, stopPrice: stopPrice, symbol: symbol, side: side,
-            type: type, timeInForce: timeInForce, timestamp: timestamp
+            type: type, timeInForce: timeInForce, timestamp: timestamp,
           }.delete_if { |key, value| value.nil? }
           ensure_required_create_keys!(params: params)
-          path = "/api/v3/order#{'/test' if test}"
+          path = "/api/v3/order#{"/test" if test}"
           Request.send!(api_key_type: :trading, method: :post, path: path,
-                        params: params, security_type: :trade)
+                        params: params, security_type: :trade, tld: Configuration.tld)
         end
 
         def status!(orderId: nil, originalClientOrderId: nil, recvWindow: nil, symbol: nil)
           raise Error.new(message: "symbol is required") if symbol.nil?
           raise Error.new(message: "either orderid or originalclientorderid " \
-            "is required") if orderId.nil? && originalClientOrderId.nil?
+                          "is required") if orderId.nil? && originalClientOrderId.nil?
           timestamp = Configuration.timestamp
           params = {
             orderId: orderId, origClientOrderId: originalClientOrderId, recvWindow: recvWindow,
-            symbol: symbol, timestamp: timestamp
+            symbol: symbol, timestamp: timestamp,
           }.delete_if { |key, value| value.nil? }
           Request.send!(api_key_type: :trading, path: "/api/v3/order",
-                        params: params, security_type: :user_data)
+                        params: params, security_type: :user_data, tld: Configuration.tld)
         end
 
         private
@@ -81,7 +81,7 @@ module Binance
         def ensure_required_create_keys!(params:)
           keys = required_create_keys.dup.concat(additional_required_create_keys(type: params[:type]))
           missing_keys = keys.select { |key| params[key].nil? }
-          raise Error.new(message: "required keys are missing: #{missing_keys.join(', ')}") unless missing_keys.empty?
+          raise Error.new(message: "required keys are missing: #{missing_keys.join(", ")}") unless missing_keys.empty?
         end
 
         def required_create_keys

data/lib/binance/api/request.rb

@@ -2,16 +2,15 @@ module Binance
   module Api
     class Request
       include HTTParty
-
-      base_uri 'https://api.binance.com'
-
       class << self
-        def send!(api_key_type: :none, headers: {}, method: :get, path: '/', params: {}, security_type: :none)
+        def send!(api_key_type: :none, headers: {}, method: :get, path: "/", params: {}, security_type: :none, tld: :com)
+          Configuration.validate_tld!(tld)
+          self.base_uri "https://api.binance.#{tld}"
+
           raise Error.new(message: "invalid security type #{security_type}") unless security_types.include?(security_type)
           all_headers = default_headers(api_key_type: api_key_type, security_type: security_type)
           params.delete_if { |k, v| v.nil? }
-          params.merge!(signature: signed_request_signature(params: params)) \
-            if [:trade, :user_data].include?(security_type)
+          params.merge!(signature: signed_request_signature(params: params)) if [:trade, :user_data].include?(security_type)
           # send() is insecure so don't use it.
           case method
           when :get
@@ -25,15 +24,15 @@ module Binance
           else
             raise Error.new(message: "invalid http method used: #{method}")
           end
-          process!(response: response || '{}')
+          process!(response: response || "{}")
         end
 
         private
 
         def default_headers(api_key_type:, security_type:)
           headers = {}
-          headers['Content-Type'] = 'application/json; charset=utf-8'
-          headers['X-MBX-APIKEY'] = Configuration.api_key(type: api_key_type) unless security_type == :none
+          headers["Content-Type"] = "application/json; charset=utf-8"
+          headers["X-MBX-APIKEY"] = Configuration.api_key(type: api_key_type) unless security_type == :none
           headers
         end
 
@@ -48,7 +47,7 @@ module Binance
         end
 
         def signed_request_signature(params:)
-          payload = params.map { |key, value| "#{key}=#{value}" }.join('&')
+          payload = params.map { |key, value| "#{key}=#{value}" }.join("&")
           Configuration.signed_request_signature(payload: payload)
         end
       end

data/lib/binance/api/version.rb

@@ -1,5 +1,5 @@
 module Binance
   module Api
-    VERSION = "0.2"
+    VERSION = "0.6.1"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: binance-ruby
 version: !ruby/object:Gem::Version
-  version: '0.2'
+  version: 0.6.1
 platform: ruby
 authors:
 - Jake Peterson
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2018-04-07 00:00:00.000000000 Z
+date: 2021-01-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: codecov
@@ -109,19 +109,33 @@ dependencies:
       - !ruby/object:Gem::Version
         version: 0.11.3
 - !ruby/object:Gem::Dependency
-  name: activesupport
+  name: simplecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.1'
-  type: :runtime
+        version: 0.20.0
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.1'
+        version: 0.20.0
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.1.0
 - !ruby/object:Gem::Dependency
   name: awrence
   requirement: !ruby/object:Gem::Requirement
@@ -163,6 +177,7 @@ files:
 - lib/binance/api/configuration.rb
 - lib/binance/api/data_stream.rb
 - lib/binance/api/error.rb
+- lib/binance/api/margin/order.rb
 - lib/binance/api/order.rb
 - lib/binance/api/request.rb
 - lib/binance/api/version.rb
@@ -171,7 +186,7 @@ licenses:
 - MIT
 metadata:
   allowed_push_host: https://rubygems.org
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -186,9 +201,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.5.2
-signing_key: 
+rubygems_version: 3.0.8
+signing_key:
 specification_version: 4
-summary: binance-ruby-0.2
+summary: binance-ruby-0.6.1
 test_files: []