hitbtc-uberamd 0.1.4

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 6eabee57d5f0a0c57bcfd862c48e9c3d72f93fde
+  data.tar.gz: 507c241e78303ccb0db37bda803ecc9ce414d929
+SHA512:
+  metadata.gz: 7fb0ef5d98084e8a9d767b1e1899ffed2e29033cab34b978ab2d86219f165441215c820b032a43518f90098766d5a31a93defd354172c4d6e1967ffc04d1f7cb
+  data.tar.gz: 9bb609484ea0b3a5b28d0a494219954c9130eedc92bb2b0c54fb192036e961b6a194131120680e4ba91458049d71a2f8bf141ed255fa6279ee090af08eedfb08

data/.gitignore

@@ -0,0 +1,3 @@
+.idea
+*.gem
+key.yml

data/Gemfile

@@ -0,0 +1,6 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in hitbtc.gemspec
+gemspec
+gem 'httparty'
+gem 'hashie'

data/README.md

@@ -0,0 +1,254 @@
+## Summary
+
+This document provides the complete reference for [hitbtc](https://hitbtc.com) API in the wrapper.
+
+
+The following symbols are traded on hitbtc exchange.
+
+| Symbol	| Lot size | Price step
+| --- | --- | --- |
+| BTCUSD |	0.01 BTC |	0.01 |
+| BTCEUR |	0.01 BTC |	0.01 |
+| LTCBTC | 0.1 LTC |	0.00001 |
+| LTCUSD | 0.1 LTC |	0.001 |
+| LTCEUR | 0.1 LTC |	0.001 |
+| EURUSD | 1 EUR |	0.0001 |
+
+Size representation:
+* Size values in streaming messages are represented in lots.
+* Size values in RESTful market data are represented in money (e.g. in coins or in USD). 
+* Size values in RESTful trade are represented in lots (e.g. 1 means 0.01 BTC for BTCUSD)
+
+### Pending Future Updates
+
+- Solid trade execution functionality
+- payment api
+
+Don't hesitate to contribute.
+If you liked it:
+BTC: 1PizgAWLJbwEsNWG9Cf27skcbgbgZGgeyK
+LTC: LQtM1t6BRd64scsdSBk8nnCLJuc8Qfhm53
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'hitbtc'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install hitbtc
+
+## Usage
+
+Create a Kraken client:
+
+```ruby
+API_KEY = '3bH+M/nLp......'
+API_SECRET = 'wQG+7Lr9b.....'
+
+hitbtc = Hitbtc::Client.new(API_KEY, API_SECRET)
+
+time = hitbtc.server_time
+time #=> 1393056191
+```
+### Public Data Methods
+
+#### Server Time
+```ruby
+time = hitbtc.server_time
+
+```
+#### Symbol info
+
+ ```ruby
+ symbol = hitbtc.symbols("BTCEUR")
+ symbols = hitbtc.symbols(["BTCEUR", "BTCUSD"])
+ all_symbols = hitbtc.symbols
+ ```
+
+#### Ticker
+
+```ruby
+ticker_data = hitbtc.ticker('BTCEUR')
+```
+
+* 24h means last 24h + last incomplete minute
+* high - highest trade price / 24 h
+* low - lowest trade price / 24 h
+* volume - volume / 24h
+
+#### Order Book
+
+```ruby
+order_book = hitbtc.order_book('BTCEUR')
+order_book = hitbtc.order_book('BTCEUR', {format_amount_unit: "lot"})
+```
+
+| Parameter | Type | Description |
+| --- | --- | --- |
+| format_price | optional, "string" (default) or "number" | |
+| format_amount | optional, "string" (default) or "number" | |
+| format_amount_unit | optional, "currency" (default) or "lot" | |
+
+
+#### Trades
+
+```ruby
+trades = hitbtc.trades "BTCEUR" (default from 1 day ago, by timestamp, index 0, max_result 1000)
+trades = hitbtc.trades 'BTCEUR', (Time.now - 1.day).to_i, "ts", 0, 1000)
+trades = hitbtc.trades 'BTCEUR', (Time.now - 1.day).to_i, "ts", 0, 1000, {format_amount_unit: "lot"})
+```
+
+Parameters:
+
+| Parameter | Type | Description |
+| --- | --- | --- |
+| from | required, int, trade_id or timestamp | returns trades with trade_id > specified trade_id <br> returns trades with timestamp >= specified timestamp |
+| till | optional, int, trade_id or timestamp | returns trades with trade_id < specified trade_id <br> returns trades with timestamp < specified timestamp |
+| by | required, filter and sort by `trade_id` or `ts` (timestamp) | |
+| sort | optional, `asc` (default) or `desc` | |
+| start_index | required, int | zero-based |
+| max_results | required, int, max value = 1000 | |
+| format_item | optional, "array" (default) or "object" |  |
+| format_price | optional, "string" (default) or "number" | |
+| format_amount | optional, "string" (default) or "number" | |
+| format_amount_unit | optional, "currency" (default) or "lot" | |
+| format_tid | optional, "string" or "number" (default) | |
+| format_timestamp | optional, "millisecond" (default) or "second" | |
+| format_wrap | optional, "true" (default) or "false" | |
+
+
+### Private Data Methods
+
+#### Error codes
+
+RESTful Trading API can return the following errors:
+
+| HTTP code | Text | Description |
+| --- | --- | --- |
+| 403 | Invalid apikey | API key doesn't exist or API key is currently used on another endpoint (max last 15 min) |
+| 403 | Nonce has been used | nonce is not monotonous |
+| 403 | Nonce is not valid | too big number or not a number |
+| 403 | Wrong signature | |
+
+#### Execution reports
+
+The API uses `ExecutionReport` as an object that represents change of order status.
+
+The following fields are used in this object:
+
+| Field	| Description | Type / Enum | Required |
+| --- | --- | --- | --- |
+| orderId | Order ID on the Exchange | string | required |
+| clientOrderId | clientOrderId sent in NewOrder message | string | required |
+| execReportType | execution report type | `new` <br> `canceled` <br> `rejected` <br> `expired` <br> `trade` <br> `status` | required |
+| orderStatus | order status | `new` <br> `partiallyFilled` <br> `filled` <br> `canceled` <br> `rejected` <br> `expired` | required |
+| orderRejectReason | Relevant only for the orders in rejected state | `unknownSymbol` <br> `exchangeClosed` <br>`orderExceedsLimit` <br> `unknownOrder` <br> `duplicateOrder` <br> `unsupportedOrder` <br> `unknownAccount` <br> `other`| for rejects |
+| symbol | | string, e.g. `BTCUSD` | required |
+| side | | `buy` or `sell` | required |
+| timestamp | UTC timestamp in milliseconds | | |
+| price | | decimal | |
+| quantity | | integer | required |
+| type | | only `limit` orders are currently supported | required |
+| timeInForce | time in force | `GTC` - Good-Til-Canceled <br>`IOK` - Immediate-Or-Cancel<br>`FOK` - Fill-Or-Kill<br>`DAY` - day orders< | required |
+| tradeId | Trade ID on the exchange | | for trades |
+| lastQuantity | | integer | for trades |
+| lastPrice | | decimal | for trades |
+| leavesQuantity | | integer |  |
+| cumQuantity | | integer | |
+| averagePrice | | decimal, will be 0 if 'cumQuantity'=0 | |
+
+
+#### Balance
+
+```ruby
+all_balance = hitbtc.balance
+one_balance = hitbtc.balance("BTC")
+many_balances = hitbtc.balance(["BTC", "EUR"])
+```
+
+#### List of active orders
+
+```ruby
+all_active_orders = hitbtc.active_orders
+symbol_specific_orders = hitbtc.active_orders({symbols: "BTCEUR"})
+symbols_specific_orders = hitbtc.active_orders({symbols: "BTCEUR,BTCUSD"})
+```
+
+Parameters: 
+
+| Parameter | Type | Description |
+| --- | --- | --- |
+| symbols | string, comma-delimeted list of symbols, optional, default - all symbols | |
+
+
+#### Create Order
+
+price should be specified even for market execution (haven't tested on a real order yet)
+
+```ruby
+hitbtc.create_order({symbol: "BTCEUR", side: "buy", quantity: 1, type: "market", timeInForce: "GTC", price: 320.000})
+```
+
+Parameters: 
+
+| Parameter | Type | Description |
+| --- | --- | --- |
+| symbol | string, required | e.g. `BTCUSD` |
+| side | `buy` or `sell`, required | |
+| price | decimal, required | order price, required for limit orders |
+| quantity | int | order quantity in lots |
+| type | `limit` or `market` | order type |
+| timeInForce | `GTC` - Good-Til-Canceled <br>`IOK` - Immediate-Or-Cancel<br>`FOK` - Fill-Or-Kill<br>`DAY` - day | use `GTC` by default |
+
+
+
+#### Cancel Order
+
+You only need your order id  (haven't been tested on real order yet)
+
+```ruby
+hitbtc.cancel_order("1398804347")
+```
+
+#### Trades History
+
+```ruby
+default = hitbtc.trade_history
+custom = hitbtc.trade_history({by: "ts", start_index: 0, max_results: 10, symbols: "BTCEUR,BTCUSD"})
+```
+
+Parameters: 
+
+| Parameter | Type | Description |
+| --- | --- | --- |
+| `by` | `trade_id` or `ts` (timestamp) | |
+| `start_index` | int, optional, default(0) | zero-based index |
+| `max_results` | int, required, <=1000 | |
+| `symbols` | string, comma-delimited | |
+| `sort` | `asc` (default) or `desc` | |
+| `from` | optional | start `trade_id` or `ts`, see `by` |
+| `till` | optional | end `trade_id` or `ts`, see `by` |
+
+
+#### Recent Orders
+
+```ruby
+default = hitbtc.recent_orders
+custom = hitbtc.trade_history({start_index: 0, max_results: 10, symbols: "BTCEUR,BTCUSD", statuses: "new,filled"})
+```
+
+Parameters: 
+
+| Parameter | Type | Description |
+| --- | --- | --- |
+| `start_index` | int, optional, default(0) | zero-based index |
+| `max_results` | int, required, <=1000 | |
+| `symbols` | string, comma-delimited | |
+| `statuses` | string, comma-delimited, `new`, `partiallyFilled`, `filled`, `canceled`, `expired`, `rejected` | |
+

data/hitbtc.gemspec

@@ -0,0 +1,27 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'hitbtc/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "hitbtc-uberamd"
+  spec.version       = HitbtcRuby::VERSION
+  spec.authors       = ["Steve Morrissey"]
+  spec.email         = ["uberamd@gmail.com"]
+  spec.description   = %q{"Wrapper for hitbtc Exchange API"}
+  spec.summary       = %q{"Wrapper for hitbtc Exchange API"}
+  spec.homepage      = "https://github.com/uberamd/hitbtc_ruby"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec"
+
+  spec.add_dependency "httparty"
+  spec.add_dependency "hashie"
+  spec.add_dependency "addressable"
+end

data/key.yml.example

@@ -0,0 +1,2 @@
+key: apikey
+secret: apisecret

data/lib/hitbtc.rb

@@ -0,0 +1,2 @@
+require "hitbtc/version"
+require "hitbtc/client"

data/lib/hitbtc/client.rb

@@ -0,0 +1,163 @@
+require 'httparty'
+require 'base64'
+require 'addressable/uri'
+
+
+module Hitbtc
+  class Client
+    include HTTParty
+
+    def initialize(api_key=nil, api_secret=nil, options={})
+      @api_key      = api_key || YAML.load_file("key.yml")["key"]
+      @api_secret   = api_secret || YAML.load_file("key.yml")["secret"]
+      @api_version  = options[:version] ||= '2'
+      @base_uri     = options[:base_uri] ||= 'api.hitbtc.com'
+    end
+
+    ###########################
+    ###### Public Data ########
+    ###########################
+
+    def symbols
+        get_public 'symbol'
+    end
+
+    def ticker symbol
+      get_public("ticker/"+symbol.upcase)
+    end
+
+    def order_book symbol, opts={}
+      #opts parameter
+      #limit (number): Limit of orderbook levels, default 100. Set 0 to view full orderbook levels
+      get_public("orderbook/"+symbol.upcase, opts)
+    end
+
+    def trades symbol, from = (Time.now - 1.day).to_i, by = "ts", start_index = 0, max_results = 1000, opts={}
+      #Parameter                    Type                            Description
+      #from	required                int = trade_id or timestamp	    returns trades with trade_id > specified trade_id or returns trades with timestamp >= specified timestamp
+      #till	optional                int = trade_id or timestamp	    returns trades with trade_id < specified trade_id or returns trades with timestamp < specified timestamp
+      #by	required                  filter and sort by trade_id or ts (timestamp)
+      #sort	optional                asc (default) or desc
+      #start_index required         int	zero-based
+      #max_results required         int, max value = 1000
+      #format_item optional         "array" (default) or "object"
+      #format_price	optional        "string" (default) or "number"
+      #format_amount optional       "string" (default) or "number"
+      #format_amount_unit optional  "currency" (default) or "lot"
+      #format_tid	optional          "string" or "number" (default)
+      #format_timestamp	optional    "millisecond" (default) or "second"
+      #format_wrap optional         "true" (default) or "false"
+      if by != "trade_id" && by != "ts"
+        raise "3rd parameter by, should be 'trade_id' or 'ts'"
+      end
+      opts[:from] = from
+      opts[:start_index] = start_index
+      opts[:max_results] = max_results
+      opts[:by] = by
+      opts[:symbol] = symbol.upcase
+      mash= get_public('trades', opts)
+      mash.try(:trades)
+    end
+
+    def get_public(method, opts={})
+      url = 'https://'+ @base_uri + '/api/' + @api_version + '/public/' + method
+      r = self.class.get(url, query: opts)
+      JSON.parse(r.body)
+    end
+
+    ######################
+    ##### Private Data ###
+    ######################
+
+    def balance #array of string currency
+      get_private 'trading/balance'
+    end
+
+    def active_orders opts={}
+      #opts parameter
+      #symbol (string): Optional parameter to filter active orders by symbol
+      get_private 'order', opts
+    end
+
+    def cancel_order client_order_id
+      delete_private 'order/'+client_order_id
+    end
+
+    def trade_history opts={}
+      get_private 'history/trades', opts
+    end
+
+    def recent_orders opts={}
+      get_private 'history/order', opts
+    end
+
+    def create_order opts={}
+      # clientOrderId	   (String):	Optional parameter, if skipped - will be generated by server. Uniqueness must be guaranteed within a single trading day, including all active orders.
+      # symbol	         (String):	Trading symbol
+      # side	           (String):	sell buy
+      # type	           (String):	Optional. Default - limit. One of: limit, market, stopLimit, stopMarket
+      # timeInForce	     (String):	Optional. Default - GDC. One of: GTC, IOC, FOK, Day, GTD
+      # quantity	       (Number):	Order quantity
+      # price	           (Number):	Order price. Required for limit types.
+      # stopPrice	       (Number):	Required for stop types.
+      # expireTime	   (Datetime):	Required for GTD timeInForce.
+      # strictValidate	(Boolean):	Price and quantity will be checked that they increment within tick size and quantity step. See symbol tickSize and quantityIncrement
+      post_private 'order', opts
+    end
+    ######################
+    ##### Payment Data ###
+    ######################
+
+    # to be written
+
+    #######################
+    #### Generate Signed ##
+    ##### Post Request ####
+    #######################
+
+    private
+
+    def post_private(method, opts={})
+      post_data = encode_options(opts)
+      uri = "/api/"+ @api_version + "/" + method
+      url = "https://" + @base_uri + uri
+
+      r = self.class.post(url, {basic_auth: {username: @api_key, password: @api_secret}, body: post_data}).parsed_response
+      r
+    end
+
+    def get_private(method, opts={})
+      opts = complete_opts(opts)
+      uri = "/api/"+ @api_version + "/" + method +"?" + encode_options(opts)
+      url = "https://" + @base_uri + uri
+
+      r = self.class.get(url, basic_auth: {username: @api_key, password: @api_secret})
+      JSON.parse(r.body)
+    end
+
+    def delete_private(method, opts={})
+      post_data = encode_options(opts)
+      uri = "/api/"+ @api_version + "/" + method
+      url = "https://" + @base_uri + uri
+
+      r = self.class.delete(url, basic_auth: {username: @api_key, password: @api_secret}).parsed_response
+      r
+    end
+
+    def complete_opts opts
+      opts[:apikey] = @api_key
+      opts[:nonce] = nonce
+      opts
+    end
+
+    def nonce
+      DateTime.now.strftime('%Q')
+    end
+
+    def encode_options(opts)
+      uri = Addressable::URI.new
+      uri.query_values = opts
+      uri.query
+    end
+  end
+end

data/lib/hitbtc/version.rb

@@ -0,0 +1,3 @@
+module HitbtcRuby
+  VERSION = "0.1.4"
+end

metadata

@@ -0,0 +1,135 @@
+--- !ruby/object:Gem::Specification
+name: hitbtc-uberamd
+version: !ruby/object:Gem::Version
+  version: 0.1.4
+platform: ruby
+authors:
+- Steve Morrissey
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2018-06-06 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: hashie
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: addressable
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: '"Wrapper for hitbtc Exchange API"'
+email:
+- uberamd@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- README.md
+- hitbtc.gemspec
+- key.yml.example
+- lib/hitbtc.rb
+- lib/hitbtc/client.rb
+- lib/hitbtc/version.rb
+homepage: https://github.com/uberamd/hitbtc_ruby
+licenses: []
+metadata: {}
+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.6.11
+signing_key: 
+specification_version: 4
+summary: '"Wrapper for hitbtc Exchange API"'
+test_files: []