WavesRubyClient

With the waves ruby client gem, You can access some of the Waves platform API methods.

It was mainly build to create orders and can be used for automatic trading algorithms.

Add this line to your application's Gemfile:

gem 'waves_ruby_client'

And then execute:

$ bundle

Or install it yourself as:

$ gem install waves_ruby_client

The gem requires the following environment variables

• WAVES_PUBLIC_KEY: your waves public key
• WAVES_PRIVATE_KEY: your waves private key, necessary for signing requests
• WAVES_ADDRESS: your waves address

Optionally you can override:

• the API URLs for the node (https://nodes.wavesnodes.com),
• the matcher (https://matcher.waves.exchange),
• matcher address (3PEjHv3JGjcWNpYEEkif2w8NXV4kbhnoGgu)
• and the matcher public key (9cpfKN9suPNvfeUNphzxXMjcnn974eme8ZhWUjaktzU5)

by setting the following environement variables:

• WAVES_NODE_URL
• WAVES_MATCHER_URL
• WAVES_MATCHER_ADDRESS
• WAVES_MATCHER_PUBLIC_KEY

Shows the current order book

book = WavesRubyClient::OrderBook.btc_waves
book.refresh
book.bids
=> [{ price: 0.00082101, amount: 104 }, ...] # sorted by price descending
book.asks
=> [{ price: 0.00083, amount: 50 }, ...] # sorted by price ascending

An Order object has the following attributes:

• id
• price
• amount
• timestamp
• type (sell|buy)
• status (Accepted|PartiallyFilled|Filled|NotFound|Cancelled)

All orders:

WavesRubyClient::Order.all

or orders with status (Accepted|PartiallyFilled)

WavesRubyClient::Order.active

order = WavesRubyClient::Order.new(price: 0.0008, amount: 10, type: :buy)
order.place # raises exception if not successful
order.cancel
order.delete

order = WavesRubyClient::Order.new(price: 0.0008, amount: 10, type: :buy)
order.place
order.refresh_status
order.status
=> 'Accepted'
order.pending?
=> true

WavesRubyClient can list unconfirmed transactions. This can be used to wait for the transaction of a filled order before placing the next order.

# order was filled
sleep(10) while WavesRubyClient::Transaction.my_unconfirmed_exchanges.any?

Lists user's balances for waves and bitcoins.

WavesRubyClient::Wallet.balance_btc
=> 1200.3

WavesRubyClient::Wallet.balance_waves
=> 500.2

Returns the last traded price as a float number

WavesRubyClient::DataFeed.current_price
=> 0.000726

Returns a list of filled Orders representing the last n trades

WavesRubyClient::DataFeed.trade_history(10)
=> [<WavesRubyClient::Order:0x0055d4746715d0, ...]

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.

Bug reports and pull requests are welcome on GitHub at https://github.com/phigrofi/waves_ruby_client. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

The gem is available as open source under the terms of the MIT License.