ftx-api 0.2.2 → 0.2.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9a784067dd3e47ef2bd471c6c1fc0d845d951b5edb22d21ae4c48b8c20adccd4
-  data.tar.gz: 3d0774d855a762302badd622ef8ae9a5caed5310bab5202e4b6d9f101ee71c0c
+  metadata.gz: 7845a00bf3bf2a3ad58c8ee65a131008f2bf456683674dd2a664db57f6be89e4
+  data.tar.gz: 0fe0ccbe9faab912eee3250e6610abb499944716a52727e1dbec00d2c2f8a6a9
 SHA512:
-  metadata.gz: b7842c31f3023590ec2d7abaef9d89d6488480ff33a4a2fb1bf62c511cff973f3ea73766c3aae57b83a018b6583985c8b67c2facb3d8cf421dcf8357e296a8e4
-  data.tar.gz: b7fb5e6c9bbfad18542194900112ff20fded0c7b493052193070928067345d1871b834af67b410e17d54c4f0dc75fe9d698c315b9576342cf1d363c364e0881a
+  metadata.gz: 533647fc948c9b1d9f5c0f331b6c58954c566d6a00bd5d1f6e181eecefcef868e444afc0ba223b3131eb87ae428927642e34a68c2f03dbc700f93f2ecaf301c3
+  data.tar.gz: 18c12550f422a555b90bfecf648a75883e777cc0c033653bbc77ca8543d02cc16188381d937b7d967773c9bd5b503ab39b6cfbc1a5ce1c8e31e560a4d3a24392

data/CHANGELOG.md

@@ -4,4 +4,22 @@
 - Initial release
 
 ## [0.2.0] - 2021-09-23
-- Implement public API covering Markets and Futures only
+- Implement public API covering Markets and Futures only
+
+## [0.2.1] - 2021-09-23
+- Empty
+
+## [0.2.2] - 2021-10-05
+- Include private API endpoints with tests
+
+## [0.2.3] - 2021-10-05
+- Include private API endpoints with tests - further updates
+
+## [0.2.4] - 2021-10-05
+- Fix error compact_blank creates for rails db:migrate
+
+## [0.2.5] - 2021-10-06
+- Fix issues with post methods and add Convert endpoint
+
+## [0.2.6] - 2021-10-06
+- Implement Fills endpoint including tests

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    ftx-api (0.2.2)
+    ftx-api (0.2.6)
       httparty (~> 0.19)
       openssl (~> 2.2)
 

data/README.md

@@ -4,8 +4,6 @@ This gem is a ruby SDK for the FTX crypto exchange REST API.
 
 API docs can be found on the [FTX developer site](https://docs.ftx.com/)
 
-It is still under development and currently only covers the markets and futures endpoints.
-
 
 ## Installation
 
@@ -154,9 +152,65 @@ Note: the create order method is not included as a test, because I have not been
 
 *Check the [FTX API docs](https://docs.ftx.com/#orders) for all parameters*
 
+### Fills
+
+Initialize an fills session:
+```ruby
+fills = FXT::API::Orders.new(key: 'YOUR FTX KEY', secret: 'YOUR FTX SECRET')
+```
+
+Query for all fills:
+```ruby
+fills.list
+```
+or
+
+```ruby
+fills.list(market: 'BTC/USD')
+```
+
+Note: market is optional
+
+### Convert Coins
+
+Initialize an convert session:
+```ruby
+convert = FXT::API::Convert.new(key: 'YOUR FTX KEY', secret: 'YOUR FTX SECRET')
+```
+
+Create a new quote:
+```ruby
+args = {
+      size:         0.01,   # 0.01 is the smallest increment
+      fromCoin:     "USD",
+      toCoin:       "BTC",
+    }
+
+convert.new_quote(args)
+```
+
+Response:
+```ruby
+{:quoteId=>2*******3}
+```
+
+Fetch a quote:
+```ruby
+convert.get_quote('quoteId')
+```
+
+Accept a quote:
+```ruby
+convert.accept_quote('quoteId')
+```
+
 ## Development
 
-After checking out the repo, run `bin/setup` to install dependencies. You'll need to add environment variables ENV['FTX_KEY'] and ENV['FTX_SECRET']. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+After checking out the repo, run `bin/setup` to install dependencies.
+
+You'll then need to add environment variables `ENV['FTX_KEY']` and `ENV['FTX_SECRET']`. API keys can be created in your [FTX settings page](https://ftx.com/profile).
+
+Then, run `rake test` 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 the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 

data/ftx-api.gemspec

@@ -12,7 +12,7 @@ Gem::Specification.new do |spec|
   spec.description   = "Ruby gem for the FTX Exchange API"
   spec.homepage      = "https://github.com/benrs44/ftx-api"
   spec.license       = "MIT"
-  spec.required_ruby_version = ">= 3.0.0"
+  spec.required_ruby_version = ">= 3.0.1"
 
   # spec.metadata["allowed_push_host"] = "TODO: Set to 'https://mygemserver.com'"
 

data/lib/ext/array.rb

@@ -4,7 +4,7 @@ class Array
 		map(&:symbolize_keys)
 	end
 
-	def compact_blank
+	def compact_empty
 		delete_if {|i| i.respond_to?(:empty?) ? !!i.empty? : !i }
 	end
 	

data/lib/ftx/api/base.rb

@@ -4,11 +4,11 @@ require 'httparty'
 
 class FTX::API::Base
   
+  attr_reader :config, :key, :secret
+
   include HTTParty
   base_uri 'https://ftx.com/api'
 
-  attr_reader :config, :key, :secret
-
   def initialize(args = {})
     @config = FTX::API::Config.new(args.dig(:config))
     @key = args.dig(:key)
@@ -21,16 +21,21 @@ class FTX::API::Base
     uuid = SecureRandom.uuid
     print_log(:info, "[API] #{uuid} #{method.upcase} '#{path}' query = #{query}")
 
-    body_or_query = method == :get ? :query : :body
+    if method == :get
+      body_or_query = :query
+    else
+      body_or_query = :body
+      query = query.to_json
+    end
 
     begin
       response = self.class.send(
-        method,
-        path,
+        method, 
+        path, 
         headers: headers,
         timeout: @config.timeout,
-        body_or_query => query,
-      ).parsed_response
+        body_or_query.to_sym => query
+      )
 
       print_log(:info, "[API] #{uuid} response #{response}")
       return parse_response(response)
@@ -43,6 +48,7 @@ class FTX::API::Base
   private
 
   def parse_response(response)
+    response = response.parsed_response
     if response.dig("success")
       response.dig("result").symbolize_keys
     else
@@ -54,7 +60,6 @@ class FTX::API::Base
     logger = @config.logger
     if logger
       puts "#{method}: #{message}"
-      # logger[method] = message
     end
   end
   

data/lib/ftx/api/convert.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require_relative 'private'
+
+class FTX::API::Convert < FTX::API::Private
+
+  def new_quote(query = {})
+    raise ArgumentError.new(
+      "Size, fromCoin, toCoin params required"
+      ) unless [:fromCoin, :toCoin, :size].all? { |i| query.include? i }
+    
+    send_request(:post, "/otc/quotes", query)
+  end
+
+  def get_quote(quote_id)
+    send_request(:get, "/otc/quotes/#{quote_id}", {})
+  end
+
+  def accept_quote(quote_id)   
+    send_request(:post, "/otc/quotes/#{quote_id}/accept", {})
+  end
+  
+end

data/lib/ftx/api/fills.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require_relative 'private'
+
+class FTX::API::Fills < FTX::API::Private
+
+  def list(query = {})
+    send_request(:get, "/fills", query)
+  end
+  
+end

data/lib/ftx/api/private.rb

@@ -15,6 +15,8 @@ class FTX::API::Private < FTX::API::Base
       'FTX-KEY' => key,
       'FTX-SIGN' => signature(*args),
       'FTX-TS' => ts.to_s,
+      'Content-Type' => 'application/json',
+      'Accepts' => 'application/json',
     }
   end
 
@@ -23,15 +25,15 @@ class FTX::API::Private < FTX::API::Base
   end
 
   def signature_payload(method, path, query)
-    payload = [ts, method.to_s.upcase, "/api", path].compact_blank
+    payload = [ts, method.to_s.upcase, "/api", path].compact_empty
     
     if method==:post
-      payload.push(query.to_json)
+      payload << query.to_json
     elsif method==:get
-      payload.push("?" + URI.encode_www_form(query))
+      payload << ("?" + URI.encode_www_form(query))
     end unless query.empty?
 
-    "#{payload.join}".encode("UTF-8")
+    payload.join.encode("UTF-8")
   end
 
   def ts

data/lib/ftx/api/version.rb

@@ -2,6 +2,6 @@
 
 module FTX
   module API
-    VERSION = "0.2.2"
+    VERSION = "0.2.6"
   end
 end

data/lib/ftx/api.rb

@@ -3,7 +3,9 @@ require_relative "../ext/base"
 require_relative "api/version"
 require_relative "api/config"
 require_relative "api/markets"
+require_relative "api/futures"
 require_relative "api/account"
 require_relative "api/wallet"
 require_relative "api/orders"
-require_relative "api/futures"
+require_relative "api/fills"
+require_relative "api/convert"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ftx-api
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.2.6
 platform: ruby
 authors:
 - benrs44
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-10-05 00:00:00.000000000 Z
+date: 2021-10-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -63,6 +63,8 @@ files:
 - lib/ftx/api/account.rb
 - lib/ftx/api/base.rb
 - lib/ftx/api/config.rb
+- lib/ftx/api/convert.rb
+- lib/ftx/api/fills.rb
 - lib/ftx/api/futures.rb
 - lib/ftx/api/markets.rb
 - lib/ftx/api/orders.rb
@@ -85,7 +87,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.0.0
+      version: 3.0.1
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="