ftx-api 0.2.0 → 0.2.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6164ab4f05bb14b174c612dc06723531a6b8fb96ac4d1abd590c5bd023e1b9e9
-  data.tar.gz: 14541c5ccbe987d6e8bd726f7caffdff0015b31947550aa51f5e41c1fa33b8cb
+  metadata.gz: 58c15096ba4fb95095c38eb810ce23e70066ae3e462cd96d25b4793be3ed0457
+  data.tar.gz: 44f47071c91cb4d76a3bf075ae3c4b9e3ad656833936ad7b4cb8e3671908bb33
 SHA512:
-  metadata.gz: f26ffc669ae5dadffac282db63a6dd9fdad337cdfa214d94e59e70ff2eaf6125e025d93297a59d56a9ffccbd7c323a90f4952d65a0a47c658dc260aa11a8b586
-  data.tar.gz: fc799a21f27a4cb6c06eee3e7cf011e9bd56f7687f6de558dd23d4f19c8a7a105e79a27f56b5274f8e19ddc3fb0fa5bfdc4cdc06e05973900b7e37b0550720e5
+  metadata.gz: 687383de76c7e9b00e8cc385cc73a32537d45392253881a56b00d70336021e356cd87a6a3804357a18a1933c6be2a9b69fed2969f6817558a7acf0adbffdede3
+  data.tar.gz: 25a2ea5c354a87a36074759790b3b28af98aae58f3c9109e7bf7489acaebaa969d3e26c4a49005e18788dc246175340a4b532b8666b1e6b12a761c7106810d87

data/.rubocop.yml

@@ -1,5 +1,5 @@
 AllCops:
-  TargetRubyVersion: 3.0
+  TargetRubyVersion: 3.0.1
 
 Style/StringLiterals:
   Enabled: true

data/Gemfile

@@ -8,6 +8,7 @@ gemspec
 group :test do
   gem 'simplecov', '< 0.18'
   gem 'httparty', '~> 0.19'
+  gem 'openssl', '~> 2.2'
 end
 
 gem "rake", "~> 13.0"

data/Gemfile.lock

@@ -1,8 +1,9 @@
 PATH
   remote: .
   specs:
-    ftx-api (0.2.0)
+    ftx-api (0.2.5)
       httparty (~> 0.19)
+      openssl (~> 2.2)
 
 GEM
   remote: https://rubygems.org/
@@ -21,6 +22,7 @@ GEM
     mime-types-data (3.2021.0901)
     minitest (5.14.4)
     multi_xml (0.6.0)
+    openssl (2.2.0)
     parallel (1.21.0)
     parser (3.0.2.0)
       ast (~> 2.4.1)
@@ -60,6 +62,7 @@ DEPENDENCIES
   ftx-api!
   httparty (~> 0.19)
   minitest (~> 5.0)
+  openssl (~> 2.2)
   pry-rails
   rake (~> 13.0)
   rubocop (~> 1.7)

data/README.md

@@ -1,8 +1,11 @@
-# Ftx::Api
+# FTX::API
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/ftx/api`. To experiment with that code, run `bin/console` for an interactive prompt.
+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.
 
-TODO: Delete this and the text above, and describe your gem
 
 ## Installation
 
@@ -22,11 +25,175 @@ Or install it yourself as:
 
 ## Usage
 
-TODO: Write usage instructions here
+### Markets
+
+Initialize a markets session:
+```ruby
+markets = FXT::API::Markets.new
+```
+
+Query for all current prices:
+```ruby
+markets.list
+```
+
+Fetch a single market price:
+```ruby
+markets.get('BTC/USD')
+```
+
+Check for market depth:
+```ruby
+markets.orderbook('BTC/USD', depth: 3)
+```
+
+View historic prices:
+```ruby
+markets.historic('BTC/USD', resolution: 86400*30)
+```
+*Check the [FTX API docs](https://docs.ftx.com/?python#get-historical-prices) for additional parameters such as start_time and end_time*
+
+Note: resolution is in seconds so 86,400 would be the number of seconds in a day. As a default, the API responds with 12 months of historical prices.
+
+### Futures
+
+Initialize a futures session:
+```ruby
+futures = FXT::API::Futures.new
+```
+
+Query for all current prices:
+```ruby
+futures.list
+```
+
+Fetch a single market price:
+```ruby
+futures.get('BTC-PERP')
+```
+
+### Account
+
+Initialize an account session:
+```ruby
+account = FXT::API::Account.new(key: 'YOUR FTX KEY', secret: 'YOUR FTX SECRET')
+```
+
+Fetch information about account associated with key/secret:
+```ruby
+account.get
+```
+
+Query for all current account positions:
+```ruby
+account.positions
+```
+
+### Wallet
+
+Initialize a wallet session:
+```ruby
+wallet = FXT::API::Wallet.new(key: 'YOUR FTX KEY', secret: 'YOUR FTX SECRET')
+```
+
+Query for all available coins:
+```ruby
+wallet.coins
+```
+
+Query for all current coin balances in your account:
+```ruby
+wallet.balances
+```
+
+Query for all current coin balances split into a hash by subaccount:
+```ruby
+wallet.all_balances
+```
+
+### Orders
+
+Initialize an orders session:
+```ruby
+orders = FXT::API::Orders.new(key: 'YOUR FTX KEY', secret: 'YOUR FTX SECRET')
+```
+
+Query for all open orders:
+```ruby
+orders.open
+```
+
+Query for all historical orders:
+```ruby
+orders.history
+```
+
+Fetch a specific order:
+```ruby
+orders.get
+```
+
+Create a new order:
+```ruby
+args = {
+      market:       "XRP-PERP",     # coin or futures name
+      side:         "sell",         # "buy" or "sell"
+      price:        0.306525,       # Send nil for market orders.
+      type:         "limit",        # "limit" or "market"
+      size:         31431.0,
+      reduceOnly:   false,          # optional; default is false
+      ioc:          false,          # optional; default is false
+      postOnly:     false,          # optional; default is false
+      clientId:     nil             # optional; client order id
+    }
+
+orders.create(args)
+```
+
+Note: the create order method is not included as a test, because I have not been able to find FTX test keys and it seems a bit ridiculous to execute a live order for testing.
+
+*Check the [FTX API docs](https://docs.ftx.com/#orders) for all parameters*
+
+### 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. 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).
 
@@ -40,4 +207,4 @@ The gem is available as open source under the terms of the [MIT License](https:/
 
 ## Code of Conduct
 
-Everyone interacting in the Ftx::Api project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/benrs44/ftx-api/blob/master/CODE_OF_CONDUCT.md).
+Everyone interacting in the Ftx::Api project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/benrs44/ftx-api/blob/master/CODE_OF_CONDUCT.md).

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'"
 
@@ -33,6 +33,7 @@ Gem::Specification.new do |spec|
 
   # Uncomment to register a new dependency of your gem
   spec.add_dependency "httparty", "~> 0.19"
+  spec.add_dependency "openssl", "~> 2.2"
 
   # For more information and examples about making a new gem, checkout our
   # guide at: https://bundler.io/guides/creating_gem.html

data/lib/ext/array.rb

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

data/lib/ftx/api/account.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require_relative 'private'
+
+class FTX::API::Account < FTX::API::Private
+
+  def get
+    send_request(:get, "/account", {})
+  end
+
+  def positions
+    send_request(:get, "/positions", {})
+  end
+  
+end

data/lib/ftx/api/base.rb

@@ -3,12 +3,16 @@
 require 'httparty'
 
 class FTX::API::Base
-  include HTTParty
+  
+  attr_reader :config, :key, :secret
 
-  attr_reader :config
+  include HTTParty
+  base_uri 'https://ftx.com/api'
 
-  def initialize(config: nil)
-    @config = FTX::API::Config.new(config)
+  def initialize(args = {})
+    @config = FTX::API::Config.new(args.dig(:config))
+    @key = args.dig(:key)
+    @secret = args.dig(:secret)
   end
 
   protected
@@ -17,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)
@@ -39,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
@@ -48,6 +58,9 @@ class FTX::API::Base
 
   def print_log(method, message)
     logger = @config.logger
-    logger.send(method, message) if logger
+    if logger
+      puts "#{method}: #{message}"
+    end
   end
+  
 end

data/lib/ftx/api/config.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
 class FTX::API::Config
-  attr_accessor :timeout
-  attr_accessor :logger
+  
+  attr_accessor :timeout, :logger
 
   def initialize(data = nil)
     data ||= {}

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/futures.rb

@@ -3,7 +3,6 @@
 require_relative 'public'
 
 class FTX::API::Futures < FTX::API::Public
-  base_uri 'https://ftx.com/api'
 
   def list
     send_request(:get, '/futures', {})
@@ -12,4 +11,5 @@ class FTX::API::Futures < FTX::API::Public
   def get(futures_name)
     send_request(:get, "/futures/#{futures_name}", {})
   end
+  
 end

data/lib/ftx/api/markets.rb

@@ -3,7 +3,6 @@
 require_relative 'public'
 
 class FTX::API::Markets < FTX::API::Public
-  base_uri 'https://ftx.com/api'
 
   def list
     send_request(:get, '/markets', {})
@@ -25,4 +24,5 @@ class FTX::API::Markets < FTX::API::Public
     
     send_request(:get, "/markets/#{market_name}/candles", query)
   end
+  
 end

data/lib/ftx/api/orders.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require_relative 'private'
+
+class FTX::API::Orders < FTX::API::Private
+
+  def open(query = {})
+    send_request(:get, "/orders", query)
+  end
+
+  def history(query = {})
+    send_request(:get, "/orders/history", query)
+  end
+
+  def get(order_id)
+    send_request(:get, "/orders/#{order_id}", {})
+  end
+
+  def create(query = {})
+    raise ArgumentError.new(
+      "Market, side, price (can be nil), tupe and size params required"
+      ) unless [:market, :side, :price, :type, :size].all? { |i| query.include? i }
+    
+    send_request(:post, "/orders", query)
+  end
+  
+end

data/lib/ftx/api/private.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+class FTX::API::Private < FTX::API::Base
+
+  protected
+
+  def send_request(method, path, query)
+    super(method, path, headers(method, path, query), query)
+  end
+
+  def headers(*args)
+    {
+      'FTX-KEY' => key,
+      'FTX-SIGN' => signature(*args),
+      'FTX-TS' => ts.to_s,
+      'Content-Type' => 'application/json',
+      'Accepts' => 'application/json',
+    }
+  end
+
+  def signature(*args)
+    OpenSSL::HMAC.hexdigest(digest, secret, signature_payload(*args))
+  end
+
+  def signature_payload(method, path, query)
+    payload = [ts, method.to_s.upcase, "/api", path].compact_empty
+    
+    if method==:post
+      payload << query.to_json
+    elsif method==:get
+      payload << ("?" + URI.encode_www_form(query))
+    end unless query.empty?
+
+    payload.join.encode("UTF-8")
+  end
+
+  def ts
+    @ts ||= (Time.now.to_f * 1000).to_i
+  end
+
+  def digest
+    @digest ||= OpenSSL::Digest.new('sha256')
+  end
+  
+end

data/lib/ftx/api/public.rb

@@ -3,11 +3,11 @@
 require_relative 'base'
 
 class FTX::API::Public < FTX::API::Base
-  base_uri 'https://ftx.com/api'
 
   protected
 
   def send_request(method, path, query)
     super(method, path, {}, query)
   end
+  
 end

data/lib/ftx/api/version.rb

@@ -2,6 +2,6 @@
 
 module FTX
   module API
-    VERSION = "0.2.0"
+    VERSION = "0.2.5"
   end
 end

data/lib/ftx/api/wallet.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require_relative 'private'
+
+class FTX::API::Wallet < FTX::API::Private
+
+  def coins
+    send_request(:get, "/wallet/coins", {})
+  end
+
+  def balances
+    send_request(:get, "/wallet/balances", {})
+  end
+
+  def all_balances
+    send_request(:get, "/wallet/all_balances", {})
+  end
+  
+end

data/lib/ftx/api.rb

@@ -3,4 +3,8 @@ 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/convert"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ftx-api
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.5
 platform: ruby
 authors:
 - benrs44
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-09-23 00:00:00.000000000 Z
+date: 2021-10-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -24,6 +24,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.19'
+- !ruby/object:Gem::Dependency
+  name: openssl
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.2'
 description: Ruby gem for the FTX Exchange API
 email:
 - ben@certoris.com
@@ -46,12 +60,17 @@ files:
 - lib/ext/base.rb
 - lib/ext/hash.rb
 - lib/ftx/api.rb
+- lib/ftx/api/account.rb
 - lib/ftx/api/base.rb
 - lib/ftx/api/config.rb
+- lib/ftx/api/convert.rb
 - lib/ftx/api/futures.rb
 - lib/ftx/api/markets.rb
+- lib/ftx/api/orders.rb
+- lib/ftx/api/private.rb
 - lib/ftx/api/public.rb
 - lib/ftx/api/version.rb
+- lib/ftx/api/wallet.rb
 homepage: https://github.com/benrs44/ftx-api
 licenses:
 - MIT
@@ -67,7 +86,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:
   - - ">="