binance-ruby 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: cc14abcbaf6d47284c2adfbb849b57251fe62b5d
+  data.tar.gz: d708faac09d2f3e6a9cebb23837233c2b7b7da5f
+SHA512:
+  metadata.gz: bd63b319fe53d0c3c60f840afd35daa408766d43390808f7080ca27dcaba147bbb4a87b270a6e02638a73c7b6d3a0e48339788f3e15e01696e36d14ca657a637
+  data.tar.gz: 47134301c56bd56d8a4d01feb1cd67190ca8d7ade700a4959c3440cffbc3b25fe3eb2ee768fae16161683fe53060a2a4efd25cb610e46005a7c18ff0f6714bf8

data/.circleci/config.yml

@@ -0,0 +1,51 @@
+# 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: ~/binance-ruby
+
+    steps:
+      - checkout
+
+      # Download and cache dependencies
+      - restore_cache:
+          keys:
+          - v1-dependencies-{{ checksum "binance-ruby.gemspec" }}
+          # 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 "binance-ruby.gemspec" }}
+
+      # run tests!
+      - run:
+          name: run tests
+          command: |
+            mkdir /tmp/test-results
+            bundle exec rspec --format progress
+
+      # collect reports
+      - store_test_results:
+          path: /tmp/test-results
+      - store_artifacts:
+          path: /tmp/test-results
+          destination: test-results

data/.env.example

@@ -0,0 +1,5 @@
+BINANCE_READ_INFO_API_KEY=example-read-info-key
+BINANCE_TRADING_API_KEY=example-trading-key
+BINANCE_WITHDRAWALS_API_KEY=example-withdrawals-key
+BINANCE_API_KEY=example-api-key
+BINANCE_SECRET_KEY=example-secret-key

data/.gitignore

@@ -0,0 +1,15 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+/coverage/
+
+# rspec failure tracking
+.rspec_status
+
+.env

data/.rspec

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

data/.travis.yml

@@ -0,0 +1,5 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.3.2
+before_install: gem install bundler -v 1.15.4

data/Gemfile

@@ -0,0 +1,6 @@
+source "https://rubygems.org"
+
+git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
+
+# Specify your gem's dependencies in binance-ruby.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2018 Jake Peterson
+
+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/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 Jake Peterson
+
+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,107 @@
+# Binance::Api [![Circle CI](https://circleci.com/gh/Jakenberg/binance-ruby.svg?style=shield)](https://circleci.com/gh/Jakenberg/binance-ruby) [![codecov](https://codecov.io/gh/Jakenberg/binance-ruby/branch/master/graph/badge.svg)](https://codecov.io/gh/Jakenberg/binance-ruby)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'binance-ruby'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install binance-ruby
+
+## Setup
+
+### Environment Variables
+
+At minimum, you must configure the following environment variables:
+
+```bash
+BINANCE_API_KEY
+BINANCE_SECRET_KEY
+```
+
+Additionally, Binance allows granular API key access based on the action being taken. For example, it is possible to use one API key for _only_ trade actions, while using another for withdrawal actions. You can configure this using any of the following keys:
+
+```bash
+BINANCE_READ_INFO_API_KEY
+BINANCE_TRADING_API_KEY
+BINANCE_WITHDRAWALS_API_KEY
+```
+
+If any one of these keys are not defined, `binance-ruby` will fallback to `BINANCE_API_KEY`.
+
+## Usage
+
+I highly recommend reading the [official Binance documentation](https://github.com/binance-exchange/binance-official-api-docs) before using this gem. Anything missed here is surely well explained there.
+
+### Binance::Api
+
+- [`candlesticks!`](https://github.com/binance-exchange/binance-official-api-docs/blob/master/rest-api.md#klinecandlestick-data): Kline/candlestick bars for a symbol. Klines are uniquely identified by their open time.
+- [`compressed_aggregate_trades!`](https://github.com/binance-exchange/binance-official-api-docs/blob/master/rest-api.md#compressedaggregate-trades-list): Get compressed, aggregate trades. Trades that fill at the time, from the same order, with the same price will have the quantity aggregated.
+- [`depth!`](https://github.com/binance-exchange/binance-official-api-docs/blob/master/rest-api.md#order-book): Get your order book.
+- [`exchange_info!`](https://github.com/binance-exchange/binance-official-api-docs/blob/master/rest-api.md#exchange-information): Current exchange trading rules and symbol information.
+- [`historical_trades!`](https://github.com/binance-exchange/binance-official-api-docs/blob/master/rest-api.md#old-trade-lookup-market_data): Get older trades.
+- [`ping!`](https://github.com/binance-exchange/binance-official-api-docs/blob/master/rest-api.md#test-connectivity): Test connectivity to the Rest API.
+- [`ticker!`](https://github.com/binance-exchange/binance-official-api-docs/blob/master/rest-api.md#24hr-ticker-price-change-statistics): Price change statistics. **Careful** when accessing this with no symbol.
+- [`time!`](https://github.com/binance-exchange/binance-official-api-docs/blob/master/rest-api.md#check-server-time): Test connectivity to the Rest API and get the current server time.
+- [`trades!`](https://github.com/binance-exchange/binance-official-api-docs/blob/master/rest-api.md#recent-trades-list): Get recent trades (up to last 500).
+
+### Binance::Api::Account
+
+- [`info!`](https://github.com/binance-exchange/binance-official-api-docs/blob/master/rest-api.md#account-information-user_data): Get current account information.
+- [`trades!`](https://github.com/binance-exchange/binance-official-api-docs/blob/master/rest-api.md#account-trade-list-user_data): Get trades for a specific account and symbol.
+
+### Binance::Api::DataStream
+
+- [`start!`](https://github.com/binance-exchange/binance-official-api-docs/blob/master/rest-api.md#start-user-data-stream-user_stream): Start a new user data stream. The stream will close after 60 minutes unless a keepalive is sent.
+- [`keepalive!`](https://github.com/binance-exchange/binance-official-api-docs/blob/master/rest-api.md#keepalive-user-data-stream-user_stream): Keepalive a user data stream to prevent a time out. User data streams will close after 60 minutes. It's recommended to send a ping about every 30 minutes.
+- [`stop!`](https://github.com/binance-exchange/binance-official-api-docs/blob/master/rest-api.md#close-user-data-stream-user_stream): Close out a user data stream.
+
+### Binance::Api::Order
+
+- [`all!`](https://github.com/binance-exchange/binance-official-api-docs/blob/master/rest-api.md#all-orders-user_data): Get all account orders; active, canceled, or filled.
+- [`all_open!`](https://github.com/binance-exchange/binance-official-api-docs/blob/master/rest-api.md#current-open-orders-user_data): Get all open orders on a symbol. **Careful** when accessing this with no symbol.
+- [`cancel!`](https://github.com/binance-exchange/binance-official-api-docs/blob/master/rest-api.md#cancel-order-trade): Cancel an active order.
+- [`create!`](https://github.com/binance-exchange/binance-official-api-docs/blob/master/rest-api.md#new-order--trade): Send in a new order. Use `test: true` for test orders.
+- [`status!`](https://github.com/binance-exchange/binance-official-api-docs/blob/master/rest-api.md#query-order-user_data): Check an order's status.
+
+For more information, please refer to the [official Rest API documentation](https://github.com/binance-exchange/binance-official-api-docs/blob/master/rest-api.md) written by the Binance team.
+
+## Author
+
+[Jake Peterson](https://jakenberg.io)
+
+I drink beer 😉
+
+**BTC**: `1EZTj5rEaKE9dEBjR1wiismwma4XpXtLBz`
+
+**ETH**: `0xf61195dcb1e89f139114e599cf1dd37dd8b7b96a`
+
+**LTC**: `LL3Nf7CmLoFeLENSKN6WhgPNVuxjzgh2eV`
+
+**BCH**: [Bcash. LOL](https://www.youtube.com/watch?v=oCOjCEth6xI)
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/jakenberg/binance-ruby.
+
+### TODO
+- Convert milliseconds to ruby DateTime.
+- CodeCov account & badge.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "binance/ruby"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/binance-ruby.gemspec

@@ -0,0 +1,47 @@
+# coding: utf-8
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "binance/api/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "binance-ruby"
+  spec.version       = Binance::Api::VERSION
+  spec.authors       = ["Jake Peterson"]
+  spec.email         = ["hello@jakenberg.io"]
+
+  spec.summary       = %q{Ruby gem for the Binance API.}
+  spec.description   = %q{
+    - Official Announcements regarding changes, downtime, etc. to the API and Streams will be reported here: https://t.me/binance_api_announcements
+    - Streams, endpoints, parameters, payloads, etc. decscribed in the documents in this repository are considered official and supported.
+  }
+  spec.homepage      = "https://github.com/jakenberg/binance-ruby"
+  spec.license       = "MIT"
+
+  # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
+  # to allow pushing to a single host or delete this section to allow pushing to any host.
+  if spec.respond_to?(:metadata)
+    spec.metadata["allowed_push_host"] = "https://rubygems.org"
+  else
+    raise "RubyGems 2.0 or newer is required to protect against " \
+      "public gem pushes."
+  end
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.15"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+  spec.add_development_dependency "webmock", '~> 3.0'
+  spec.add_development_dependency 'pry', '~> 0.11.0'
+  spec.add_development_dependency 'dotenv-rails', '~> 2.2.0'
+  spec.add_development_dependency 'codecov', '~> 0.1'
+
+  spec.add_dependency 'awrence', '~> 1.0'
+  spec.add_dependency 'httparty', '~> 0.15'
+  spec.add_dependency 'activesupport-core-ext', '~> 4.0.0'
+end

data/lib/binance/api.rb

@@ -0,0 +1,74 @@
+require 'active_support/core_ext/string'
+require 'awrence'
+require 'httparty'
+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/version"
+
+module Binance
+  module Api
+    class << self
+      # Valid limits:[5, 10, 20, 50, 100, 500, 1000]
+      def candlesticks!(end_time: nil, interval: nil, limit: 500, start_time: nil, symbol: nil) 
+        raise Error.new(message: 'interval is required') unless interval
+        raise Error.new(message: 'symbol is required') unless symbol
+        params = { endTime: end_time, interval: interval, limit: limit, startTime: start_time, symbol: symbol }
+        Request.send!(api_key_type: :read_info, path: '/api/v1/klines', params: params)
+      end
+
+      def compressed_aggregate_trades!(end_time: nil, from_id: nil, limit: 500, start_time: nil, symbol: nil) 
+        raise Error.new(message: "symbol is required") unless symbol
+        params = { endTime: end_time, fromId: from_id, limit: limit, startTime: start_time, symbol: symbol }
+        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)
+      end
+
+      def exchange_info!
+        Request.send!(api_key_type: :read_info, path: '/api/v1/exchangeInfo')
+      end
+
+      def historical_trades!(symbol: nil, limit: 500, from_id: nil)
+        raise Error.new(message: "symbol is required") unless symbol
+        params = { fromId: from_id, limit: limit, symbol: symbol }
+        Request.send!(api_key_type: :read_info, path: '/api/v1/historicalTrades', params: params, security_type: :market_data)
+      end
+
+      def 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."
+        raise Error.new(message: error_message) unless ticker_types.include? ticker_type
+        params = symbol ? { symbol: symbol } : {}
+        Request.send!(api_key_type: :read_info, path: "/api/v3/ticker/#{type.to_s.camelcase(:lower)}", params: params)
+      end
+
+      def 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)
+      end
+
+      private
+
+      def ticker_types
+        [:daily, :price, :book_ticker].freeze
+      end
+    end
+  end
+end

data/lib/binance/api/account.rb

@@ -0,0 +1,25 @@
+module Binance
+  module Api
+    class Account
+      class << self
+        def info!(recv_window: 5000)
+          timestamp = Configuration.timestamp
+          params = { recvWindow: recv_window, timestamp: timestamp } 
+          Request.send!(api_key_type: :read_info, path: "/api/v3/account",
+                        params: params.delete_if { |key, value| value.nil? },
+                        security_type: :user_data)
+        end
+
+        def trades!(from_id: nil, limit: 500, recv_window: 5000, symbol: nil)
+          raise Error.new(message: "max limit is 500") unless limit <= 500
+          raise Error.new(message: "symbol is required") if symbol.nil?
+          timestamp = Configuration.timestamp
+          params = { fromId: from_id, limit: limit, recvWindow: recv_window, symbol: symbol, timestamp: timestamp }
+          Request.send!(api_key_type: :read_info, path: "/api/v3/myTrades",
+                        params: params.delete_if { |key, value| value.nil? },
+                        security_type: :user_data)
+        end
+      end
+    end
+  end
+end

data/lib/binance/api/configuration.rb

@@ -0,0 +1,32 @@
+require 'openssl'
+require 'base64'
+
+module Binance
+  module Api
+    class Configuration
+      class << self
+        def api_key(type:)
+          raise Error.new(message: "invalid security_type type: #{type}.") unless api_key_types.include?(type)
+          ENV["BINANCE_#{type.to_s.humanize.upcase}_API_KEY"] || ENV["BINANCE_API_KEY"]
+        end
+
+        def signed_request_signature(payload:)
+          key = ENV['BINANCE_SECRET_KEY']
+          raise Error.new(message: "environment variable 'BINANCE_SECRET_KEY' is required "\
+            "for signed requests.") unless key
+          Base64.encode64(OpenSSL::HMAC.digest(OpenSSL::Digest.new('sha256'), key, payload)).strip()
+        end
+
+        def timestamp
+          Time.now.to_i
+        end
+
+        private
+
+        def api_key_types
+          [:none, :read_info, :trading, :withdrawals].freeze
+        end
+      end
+    end
+  end
+end

data/lib/binance/api/data_stream.rb

@@ -0,0 +1,25 @@
+module Binance
+  module Api
+    class DataStream
+      class << self
+        # It's recommended to send a ping about every 30 minutes.
+        def keepalive!(listen_key: nil)
+          raise Error.new(message: "listen_key is required") if listen_key.nil?
+          Request.send!(api_key_type: :none, method: :put, path: "/api/v1/userDataStream",
+                        params: { listenKey: listen_key }, security_type: :user_stream)
+        end
+
+        def start!
+          Request.send!(api_key_type: :none, method: :post, path: "/api/v1/userDataStream",
+                        security_type: :user_stream)
+        end
+
+        def stop!(listen_key: nil)
+          raise Error.new(message: "listen_key is required") if listen_key.nil?
+          Request.send!(api_key_type: :none, method: :delete, path: "/api/v1/userDataStream",
+                        params: { listenKey: listen_key }, security_type: :user_stream)
+        end
+      end
+    end
+  end
+end

data/lib/binance/api/error.rb

@@ -0,0 +1,36 @@
+module Binance
+  module Api
+    class Error < StandardError
+      attr_reader :code, :msg
+
+      class << self
+        # https://github.com/binance-exchange/binance-official-api-docs/blob/master/errors.md
+        def is_error_response?(json:)
+          return false if json.is_a? Array
+          code = json[:code]&.to_i
+          code && code >= 400
+        end
+      end
+
+      def initialize(code: nil, json: {}, message: nil)
+        @code = code || json[:code]
+        @msg = message || json[:msg]
+      end
+
+      def inspect
+        message = "Binance::Api::Error"
+        message += " (#{code})" unless code.nil?
+        message += ": #{msg}"
+        message += "\nbacktrace: #{backtrace}"
+      end
+
+      def message
+        inspect
+      end
+
+      def to_s
+        inspect
+      end
+    end
+  end
+end

data/lib/binance/api/order.rb

@@ -0,0 +1,99 @@
+module Binance
+  module Api
+    class Order
+      class << self
+        def all!(limit: 500, order_id: nil, recv_window: 5000, symbol: nil)
+          raise Error.new(message: "max limit is 500") unless limit <= 500
+          raise Error.new(message: "symbol is required") if symbol.nil?
+          timestamp = Configuration.timestamp
+          params = { limit: limit, orderId: order_id, recvWindow: recv_window, 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)
+        end
+
+        # Be careful when accessing without a symbol!
+        def all_open!(recv_window: 5000, symbol: nil)
+          timestamp = Configuration.timestamp
+          params = { recvWindow: recv_window, symbol: symbol, timestamp: timestamp }
+          Request.send!(api_key_type: :read_info, path: '/api/v3/openOrders',
+                        params: params, security_type: :user_data)
+        end
+
+        def cancel!(order_id: nil, original_client_order_id: nil, new_client_order_id: nil, recv_window: nil, symbol: nil)
+          raise Error.new(message: "symbol is required") if symbol.nil?
+          raise Error.new(message: "either order_id or original_client_order_id " \
+            "is required") if order_id.nil? && original_client_order_id.nil?
+          timestamp = Configuration.timestamp
+          params = { orderId: order_id, origClientOrderId: original_client_order_id,
+                     newClientOrderId: new_client_order_id, recvWindow: recv_window,
+                     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)
+        end
+
+        def create!(iceberg_quantity: nil, new_client_order_id: nil, new_order_response_type: nil,
+                    price: nil, quantity: nil, recv_window: nil, stop_price: nil, symbol: nil,
+                    side: nil, type: nil, time_in_force: nil, test: false)
+          timestamp = Configuration.timestamp
+          ensure_required_create_keys!(params: {
+            iceberg_quantity: iceberg_quantity, new_client_order_id: new_client_order_id,
+            new_order_response_type: new_order_response_type, price: price,
+            quantity: quantity, recv_window: recv_window, stop_price: stop_price,
+            symbol: symbol, side: side, type: type, time_in_force: time_in_force,
+            timestamp: timestamp
+          })
+          params = { 
+            icebergQty: iceberg_quantity, newClientOrderId: new_client_order_id,
+            newOrderRespType: new_order_response_type, price: price, quantity: quantity,
+            recvWindow: recv_window, stopPrice: stop_price, symbol: symbol, side: side,
+            type: type, timeInForce: time_in_force, timestamp: timestamp
+          }.delete_if { |key, value| value.nil? }
+          path = "/api/v3/order#{'/test' if test}"
+          Request.send!(api_key_type: :trading, method: :post, path: path,
+                        params: params, security_type: :trade)
+        end
+
+        def status!(order_id: nil, original_client_order_id: nil, recv_window: nil, symbol: nil)
+          raise Error.new(message: "symbol is required") if symbol.nil?
+          raise Error.new(message: "either order_id or original_client_order_id " \
+            "is required") if order_id.nil? && original_client_order_id.nil?
+          timestamp = Configuration.timestamp
+          params = {
+            orderId: order_id, origClientOrderId: original_client_order_id, recvWindow: recv_window,
+            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)
+        end
+
+        private
+
+        def additional_required_create_keys(type:)
+          case type
+          when :limit
+            [:price, :time_in_force].freeze
+          when :stop_loss, :take_profit
+            [:stop_price].freeze
+          when :stop_loss_limit, :take_profit_limit
+            [:price, :stop_price, :time_in_force].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, :quantity, :timestamp].freeze
+        end
+      end
+    end
+  end
+end

data/lib/binance/api/request.rb

@@ -0,0 +1,63 @@
+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)
+          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)
+          if [:trade, :user_data].include?(security_type)
+            params.merge!(
+              signature: signed_request_signature(params: params),
+              timestamp: timestamp
+            )
+          end
+          # send() is insecure so don't use it.
+          case method
+          when :get
+            response = get(path, headers: all_headers, query: params)
+          when :post
+            response = post(path, body: params, headers: all_headers)
+          when :put
+            response = put(path, body: params, headers: all_headers)
+          when :delete
+            response = delete(path, body: params, headers: all_headers)
+          else
+            raise Error.new(message: "invalid http method used: #{method}")
+          end
+          process!(response: response || '{}')
+        end
+
+        private
+
+        def default_headers(api_key_type:, security_type:)
+          headers = {}
+          headers['X-MBX-APIKEY'] = Configuration.api_key(type: api_key_type) unless security_type == :none
+          headers
+        end
+
+        def process!(response: '')
+          json = JSON.parse(response, symbolize_names: true)
+          raise Error.new(json: json) if Error.is_error_response?(json: json)
+          json 
+        end
+
+        def security_types
+          [:none, :trade, :user_data, :user_stream, :market_data].freeze
+        end
+
+        def signed_request_signature(params:)
+          payload = params.map { |key, value| "#{key}=#{value}" }.join('&')
+          Configuration.signed_request_signature(payload: payload)
+        end
+
+        def timestamp
+          Time.now.to_i
+        end
+      end
+    end
+  end
+end

data/lib/binance/api/version.rb

@@ -0,0 +1,5 @@
+module Binance
+  module Api
+    VERSION = "0.1.0"
+  end
+end

metadata

@@ -0,0 +1,209 @@
+--- !ruby/object:Gem::Specification
+name: binance-ruby
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Jake Peterson
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2018-01-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.15'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.15'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.11.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.11.0
+- !ruby/object:Gem::Dependency
+  name: dotenv-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.2.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.2.0
+- !ruby/object:Gem::Dependency
+  name: codecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: awrence
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.15'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.15'
+- !ruby/object:Gem::Dependency
+  name: activesupport-core-ext
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.0.0
+description: "\n    - Official Announcements regarding changes, downtime, etc. to
+  the API and Streams will be reported here: https://t.me/binance_api_announcements\n
+  \   - Streams, endpoints, parameters, payloads, etc. decscribed in the documents
+  in this repository are considered official and supported.\n  "
+email:
+- hello@jakenberg.io
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".circleci/config.yml"
+- ".env.example"
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Gemfile
+- LICENSE
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- binance-ruby.gemspec
+- lib/binance/api.rb
+- lib/binance/api/account.rb
+- lib/binance/api/configuration.rb
+- lib/binance/api/data_stream.rb
+- lib/binance/api/error.rb
+- lib/binance/api/order.rb
+- lib/binance/api/request.rb
+- lib/binance/api/version.rb
+homepage: https://github.com/jakenberg/binance-ruby
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.2
+signing_key: 
+specification_version: 4
+summary: Ruby gem for the Binance API.
+test_files: []