Add this line to your application's Gemfile:
gem 'binance-ruby'
And then execute:
$ bundle
Or install it yourself as:
$ gem install binance-ruby
At minimum, you must configure the following environment variables:
BINANCE_API_KEY
BINANCE_SECRET_KEY
or as instance variables:
Binance::Api::Configuration.api_key = nil
Binance::Api::Configuration.secret_key = nil
Additionally, Binance allows granular API key access based on the action being taken. For example, it is possible to use one API key for only trade actions, while using another for withdrawal actions. You can configure this using any of the following keys:
BINANCE_READ_INFO_API_KEY
BINANCE_TRADING_API_KEY
BINANCE_WITHDRAWALS_API_KEY
or as instance variables:
Binance::Api::Configuration.read_info_api_key = nil
Binance::Api::Configuration.trading_api_key = nil
Binance::Api::Configuration.withdrawals_api_key = nil
If any one of these keys are not defined, binance-ruby
will fallback to BINANCE_API_KEY
/Binance::Api::Configuration.api_key
.
# Test that API is responding.
Binance::Api.ping! # => {}
# Create a new order.
Binance::Api::Order.create!(price: '0.001', quantity: '100.0', side: 'BUY', symbol: 'XRPBTC', timeInForce: 'GTC', type: 'STOP_LIMIT')
I would highly recommend reading the official Binance documentation before using this gem. Anything missed here is surely well explained there.
candlesticks!
: Kline/candlestick bars for a symbol. Klines are uniquely identified by their open time.compressed_aggregate_trades!
: Get compressed, aggregate trades. Trades that fill at the time, from the same order, with the same price will have the quantity aggregated.depth!
: Get your order book.exchange_info!
: Current exchange trading rules and symbol information.historical_trades!
: Get older trades.ping!
: Test connectivity to the Rest API.ticker!
: Price change statistics. Careful when accessing this with no symbol.time!
: Test connectivity to the Rest API and get the current server time.trades!
: Get recent trades (up to last 500).
fees!
: Get withdrawal information (status, minimum amount and fees) for all symbols.info!
: Get current account information.trades!
: Get trades for a specific account and symbol.
start!
: Start a new user data stream. The stream will close after 60 minutes unless a keepalive is sent.keepalive!
: Keepalive a user data stream to prevent a time out. User data streams will close after 60 minutes. It's recommended to send a ping about every 30 minutes.stop!
: Close out a user data stream.
all!
: Get all account orders; active, canceled, or filled.all_open!
: Get all open orders on a symbol. Careful when accessing this with no symbol.cancel!
: Cancel an active order.create!
: Send in a new order. Usetest: true
for test orders.status!
: Check an order's status.
See the rubydoc for information about parameters for each method listed above.
For more information, please refer to the official Rest API documentation written by the Binance team.
I drink beer 😉
BTC: 1EZTj5rEaKE9dEBjR1wiismwma4XpXtLBz
ETH: 0xf61195dcb1e89f139114e599cf1dd37dd8b7b96a
LTC: LL3Nf7CmLoFeLENSKN6WhgPNVuxjzgh2eV
BCH: Bcash. LOL
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.
The operational system clock is ahead/behind regarding the Binance's timestamp clock.
Use the command: sudo ntpdate time.nist.gov
.
If ntpdate
is not installed: sudo apt install ntpdate
.
Use the path: Right-click on tray clock > Adjust date/time > Additional date, time & regional settings > Date and Time > Internet time > Change settings...
- Option "Syncronize with an Internet time server" should be enabled;
- "Server" should be "time.nist.org".
Bug reports and pull requests are welcome on GitHub at https://github.com/jakenberg/binance-ruby.
- DateTime parameters (in addition to milliseconds).
The gem is available as open source under the terms of the MIT License.