cryptomarket-sdk 1.0.1 → 3.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 62756eac34a0cac0bff07eb60b27f57d35688de29c77db8b9c395bb00d48af2b
-  data.tar.gz: c6326c7df54dbc1069fec07be675f06fc95e8aafa71ac5ed47b6e9a1b97236f4
+  metadata.gz: 57f75bd527cd0e65734a08b244ca66c9b7911fdf23209f0e6521a52046fb91ce
+  data.tar.gz: 7a05fe882f6aa4de73229565b409b11b347997fd45b317e9e2613903c72f0e70
 SHA512:
-  metadata.gz: d64312e26d144291661b081b8dfde90ea2d65d909392bafc310a4fc3720e8f21a356f47521a70e274ad515558a2c41b75f8a2bcad86d4540f2bb163ece8fb016
-  data.tar.gz: cf5e559cdf9bd29fc578c04387ae837a4fb3f46c15eb5bf502ded24f2f2c41461ee7beceeda536ba03dc9a4a92737147106a717df319da1cb8fd5375c470b164
+  metadata.gz: 15a1b8b5cb5f2b10a49b99de60e47c65a44d298139695ed38abbaa49d81ba9cd310f13f1d77fecada5515536dca0385a373a5c55d4cb5a480c82f9afaa30e640
+  data.tar.gz: aa3a6f24469f5ec11484df474b576500e8271c843a83710c922da9ce61f1a53d0f7c2e086ef62179b7989517c495b6f7af4f5015c9a6dcddea8e00368f9c783c

data/README.md

@@ -1,129 +1,216 @@
 # CryptoMarket-Ruby
-[main page](https://www.cryptomkt.com/)
 
+[main page](https://www.cryptomkt.com/)
 
 [sign up in CryptoMarket](https://www.cryptomkt.com/account/register).
 
 # Installation
+
 To install Cryptomarket use gem
+
 ```
 gem install cryptomarket-sdk
 ```
+
 # Documentation
-This sdk makes use of the [api version 2](https://api.exchange.cryptomkt.com/v2) of cryptomarket
+
+This sdk makes use of the [api version 3](https://api.exchange.cryptomkt.com/) of cryptomarket
 
 # Quick Start
 
 ## rest client
+
 ```ruby
-require "cryptomarket"
+require "cryptomarket-sdk"
 
 # instance a client
 api_key='AB32B3201'
 api_secret='21b12401'
-client = Cryptomarket::Client.new apiKey:apiKey, apiSecret:apiSecret
+client = Cryptomarket::Client.new api_key:api_key, api_secret:api_secret
 
 # get currencies
-currencies = client.getCurrencies()
+currencies = client.get_currencies
 
 # get order books
-order_book = client.getOrderbook('EOSETH')
+order_book = client.get_orderbooks symbols:['EOSETH']
 
 # get your account balances
-account_balance = client.getAccountBalance()
+account_balance = client.get_wallet_balances
 
 # get your trading balances
-trading_balance = client.getTradingBalance()
+trading_balance = client.get_spot_trading_balances
 
 # move balance from account bank to account trading
-result = client.transferMoneyFromBankToExchange('ETH', '3.2')
+result = @client.transfer_between_wallet_and_exchange(
+  currency: "CRO",
+  amount: "0.1",
+  source:"wallet",
+  destination:"spot",
+)
 
 # get your active orders
-orders = client.getActiveOrders('EOSETH')
+orders = client.get_all_active_spot_orders('EOSETH')
 
 # create a new order
-order = client.createOrder('EOSETH', 'buy', '10', order_type=args.ORDER_TYPE.MARKET)
+order = client.create_spot_order(
+  symbol:'EOSETH',
+  side:'buy',
+  quantity:'10',
+  order_type:args.ORDER_TYPE.MARKET
+)
 ```
 
-## websocket client
+## Websocket Clients
 
-All websocket calls work with callbacks, subscriptions also use a callback with one argument for the subscription feed. All the other callbacks takes two arguments, err and result: callback(err, result). If the transaction is successful err is None and the result is in result. If the transaction fails, result is None and the error is in err.
+Ahere are three websocket clients, the `MarketDataClient`, the `TradingClient` and the `WalletClient`. The `MarketDataClient` is public, while the others require authentication to be used.
 
-callbacks are callables like Procs
+All websocket methods take Procs for their callbacks. These procs take two argument, the first is a possible error in the call (such as missing arguments), and the result data of the method.
 
-There are three websocket clients, the PublicClient, the TradingClient and the AccountClient.
-
-```ruby
-require "cryptomarket-sdk"
+Subscriptions also take in a Proc of two parameters, the notification data, and the notification type. The notification type is of type Args::NotificationType, and is either SNAPSHOT, NOTIFICATION or DATA, corresponding to the strings 'snapshot', 'update' and 'data'
 
-# THE PUBLIC CLIENT
+The documentation of a specific subscriptions explains with of this types of notification uses.
 
-wsclient = Cryptomarket::Websocket::PublicClient.new
+### Websocket Market Data Client
 
-wsclient.connect() # blocks until connected
+There are no unsubscriptions methods for the `MarketDataClient`. To stop recieving messages is recomended to close the `MarketDataClient`.
 
-my_callback = Proc.new {|err, data|
+```ruby
+# instance a client
+client = Cryptomarket::Websocket::MarketDataClient.new
+client.connect
+# close the client
+client.close
+# subscribe to public trades
+client.subscribe_to_trades(
+  callback:Proc.new {|notification, type|
+    if type == Args::NotificationType::UPDATE
+      puts "an update"
+    end
+    if type == Args::NotificationType::SNAPSHOT
+      puts "a snapshot"
+    end
+    puts notification
+  },
+  symbols:['eoseth', 'ethbtc'],
+  limit:2,
+  result_callback:Proc.new {|err, result|
     if not err.nil?
-        puts err # deal with error
-        return
+      puts err
+    else
+      puts result
     end
-    puts data
-}
-
-# get currencies
-wsclient.getCurrencies(my_callback)
-
-
-# get an order book feed, 
-# feed_callback is for the subscription feed, with one argument
-# result_callback is for the subscription result (success or failure)
-feed_callback = Proc.new {|feed|
-    puts feed
-}
+  }
+)
+
+# subscribe to symbol tickers
+client.subscribe_to_ticker(
+  speed:"1s",
+  callback:Proc.new {|notificatoin, type|
+    if type == Args::NotificationType::DATA
+      puts "is always data"
+    end
+    puts notification
+  },
+  symbols:['eoseth', 'ethbtc'],
+  result_callback:Proc.new {|err, result|
+    if not err.nil?
+      puts err
+    else
+      puts result
+    end
+  }
+)
+```
 
-wsclient.subscribeToOrderbook('EOSETH', feed_callback, my_callback)
+### Websocket Trading Client
 
-# THE TRADING CLIENT
+Subscription callback to spot trading balances takes only one argument, a list of balances (see example below)
 
-wsclient = Cryptomarket::Websocket::TradingClient.new apiKey:apiKey, apiSecret:apiSecret
+```ruby
+# instance a client with a 15 seconds window
+client = Cryptomarket::Websocket::TradingClient.new(
+  api_key:Keyloader.api_key,
+  api_secret:Keyloader.api_secret,
+  window:15_000
+)
+client.connect
+# close the client
+client.close
+
+# subscribe to order reports
+client.subscribe_to_reports(
+  callback:Proc.new {|notification, type|
+      if type == Args::NotificationType::UPDATE
+        puts "a lonely report in a list"
+      end
+      if type == 'snapshot' # same as Args::NotificationType::SNAPSHOT
+        puts "reports of active orders"
+      end
+      puts notification
+  }
+)
+# unsubscribe from order reports
+client.unsubscribe_to_reports
+
+@wsclient.subscribe_to_spot_balance(
+  callback: ->(balances) {puts balances},
+  result_callback: ->(_) {},
+  mode: 'updates'
+)
+
+client_order_id = Time.now.to_i.to_s
+
+# create an order
+client.create_spot_order(
+  symbol: symbol,
+  price:'10000',
+  quantity:'0.01',
+  side:'sell',
+  clientOrderId:client_order_id
+)
+
+# candel an order
+client.cancel_spot_order(client_order_id)
 
-wsclient.connect() # blocks until connected and authenticated.
+```
 
-# get your trading balances
-wsclient.getTradingBalance(my_callback)
+### Websocket Wallet Management Client
 
-# get your active orders
-wsclient.getActinveOrders(my_callback)
+Subscription callback to transactions takes only one argument, a transaction (see example below)
 
-# create a new order
-wsclient.create_order(
-    clientOrderId:"123123",
-    symbol:'EOSETH', 
-    side:'buy', 
-    quantity:"10",
-    price:"10",
-    callback:my_callback)
+```ruby
+# instance a client with a default window of 10 seconds
+client = Cryptomarket::Websocket::WalletClient.new api_key:Keyloader.api_key, api_secret:Keyloader.api_secret
+client.connect
+# close the client
+defer client.close
 
-# THE ACCONUT CLIENT
+# subscribe to wallet transactions
+def callback(transaction):
+  ->(transaction) { puts(transaction) }
 
-wsclient = Cryptomarket::Websocket::AccountClient apiKey:apiKey, apiSecret:apiSecret
+client.subscribe_to_transactions(callback)
 
-wsclient.connect() # blocks until connected
+# unsubscribe from wallet transactions
+client.unsubscribe_to_transactions(lambda { |is_success| 
+  puts('successful unsubscription') if is_success
+})
 
-wsclient.getAccountBalance(my_callback)
+# get wallet balances
+client.get_wallet_balances(->(balances){ puts balances})
 ```
 
-
 ## exception handling
+
 ```ruby
 require "cryptomarket-sdk"
 
-client = Cryptomarket::Client.new apiKey:apiKey, apiSecret:apiSecret
+client = Cryptomarket::Client.new api_key:api_key, api_secret:api_secret
 
-# catch a wrong argument 
+# catch a wrong argument
 begin
-    order = client.create_order(
-        symbol='EOSETH', 
+    order = client.create_spot_order(
+        symbol='EOSETH',
         side='selllll', # wrong
         quantity='3'
     )
@@ -133,18 +220,18 @@ end
 
 # catch a failed transaction
 begin
-    order = client.create_order(
+    order = client.create_spot_order(
         symbol='eosehtt',  # non existant symbol
         side='sell',
-        quantity='10', 
+        quantity='10',
     )
 rescue Cryptomarket::SDKException => e:
     puts e
 end
 
-wsclient = Cryptomarket::Websocket::TradingClient.new apiKey:apiKey, apiSecret:apiSecret
+wsclient = Cryptomarket::Websocket::TradingClient.new api_key:api_key, api_secret:api_secret
 
-# websocket errors are passed as the first argument to the callback
+# websocket errors are passed as the first argument to the callback. valid for all non subscription methods
 my_callback = Proc.new {|err, data|
     if not err.nil?
         puts err # deal with error
@@ -153,16 +240,15 @@ my_callback = Proc.new {|err, data|
     puts data
 }
 
-wsclient.getTradingBalance(my_callback)
+wsclient.get_spot_trading_balances(my_callback)
 
 # catch authorization error
 # to catch an authorization error on client connection, a on_error function must be defined on the client
-wsclient = TradingClient(apiKey, apiSecret)
+wsclient = TradingClient(api_key, api_secret)
 wsclient.onerror = Proc.new {|error| puts "error", error}
 wsclient.connect
-
-
 ```
+
 # Checkout our other SDKs
 
 [node sdk](https://github.com/cryptomkt/cryptomkt-node)