Cobinhood

This is an unofficial Ruby wrapper for the Cobinhood exchange REST and WebSocket APIs.

• This is Alpha software. All issues should be aggressively reported for quick resolution!
• RESTful interface is fully implemented.
• Websocket is not done.
• Pull Requests are very welcome!

Add this line to your application's Gemfile:

gem 'cobinhood'

And then execute:

$ bundle

Or install it yourself as:

$ gem install cobinhood

• Basic implementation of REST API
  • Easy to use authentication
  • Methods return parsed JSON
  • No need to generate timestamps
  • No need to generate signatures

• Basic implementation of WebSocket API

  • Pass procs or lambdas to event handlers
  • Single and multiple streams supported
  • Runs on EventMachine

• Exception handling with responses

• High level abstraction

Require Cobinhood:

require 'cobinhood'

Create a new instance of the REST Client:

# If you only plan on touching public API endpoints, you can forgo any arguments
client = Cobinhood::Client::REST.new

# Otherwise provide an api_key as keyword arguments
client = Cobinhood::Client::REST.new api_key: 'your.api_key'

ALTERNATIVELY, set your API key in exported environment variable:

export COBINHOOD_API_KEY=your.api_key

Then you can instantiate client without parameters as in first variation above.

Create various requests:

# Ping the server
client.time
  # => {"time"=>1527470756975}

# Get candle data
client.candles "ABT-BTC", timeframe: '1m'
  # => {"candles"=>[
  #   {"timeframe"=>"1m", "trading_pair_id"=>"ABT-BTC", "timestamp"=>1527384360000, "volume"=>"0",
  #     "open"=>"0.00012873", "close"=>"0.00012873", "high"=>"0.00012873", "low"=>"0.00012873"
  #   },
  #   {"timeframe"=>"1m", "trading_pair_id"=>"ABT-BTC", "timestamp"=>1527384420000, "volume"=>"0",
  #     "open"=>"0.00012873", "close"=>"0.00012873", "high"=>"0.00012873", "low"=>"0.00012873"
  #   },
  #   {"timeframe"=>"1m", "trading_pair_id"=>"ABT-BTC", ...


# Place an order
client.place_order 'ABT-BTC', side: :ask, type: :limit, price: 0.000127, size: 22
  # => {
  #   "order"=>{
  #     "id"=>"298e5465-7282-47ca-9a1f-377c56487f5f",
  #     "trading_pair_id"=>"ABT-BTC",
  #     "side"=>"ask",
  #     "type"=>"limit",
  #     "price"=>"0.000127",
  #     "size"=>"22",
  #     "filled"=>"0",
  #     "state"=>"queued",
  #     "timestamp"=>1527471152779,
  #     "eq_price"=>"0",
  #     "completed_at"=>nil,
  #     "source"=>"exchange"
  #     }
  #   }


# Get deposit address
client.get_deposit_addresses
  => { "deposit_addresses"=>[
    { "address"=>"0x8bdFCC26CaA363234528288471107D90525d6BF923",
      "blockchain_id"=>"ethereum",
      "created_at"=>1527263083623,
      "currency"=>"FXT",
      "type"=>"exchange"
      },
    ...

Required and optional parameters, as well as enum values, can currently be found on the Cobinhood GitHub Page. Parameters should always be passed to client methods as keyword arguments in snake_case form. trading_pair_id, when a required parameter is simply passed as first parameter for most API calls.

REST endpoints are in order as documented on the Cobinhood Github page (linked above). The following lists only the method names, aliases (if any) and parameters of the methods to access endpoints. For the most part, method names follow naming of the endpoint's URL and alias method follows the title/name given in Cobinhood API documentation. There were some deviations where there would otherwise be name clashes/overloading.

time

• required params: none

info

• required params: none

currencies

• alias: get_all_currencies
• required params: none

trading_pairs

• alias: get_all_trading_pairs
• required params: none

order_book trading_pair_id

• alias: get_order_book
• required params: trading_pair_id

precisions trading_pair_id

• alias: get_order_book_precisions
• required params: trading_pair_id

stats

• required params: none

tickers trading_pair_id

• alias: get_ticker
• required params: none

market_trades trading_pair_id

• alias: get_recent_trades
• required params: none

candles trading_pair_id, options={}

• required params: trading_pair_id, timeframe

order order_id

• alias: get_order
• required params: order_id

order_trades order_id

• alias: get_trades_of_an_order
• required params: order_id

orders

• alias: get_all_orders
• required params: none

place_order trading_pair_id, options={}

• required params: side, type, size, price (except market orders)

modify_order order_id, options={}

• required params: order_id, size, price

cancel_order order_id

• required params: order_id

order_history trading_pair_id=nil, options={}

• alias: get_order_history
• required params: none

get_trade trade_id

• alias: trade
• required params: trade_id

trades trading_pair_id, options={}

• required params: trading_pair_id

balances

• alias: get_wallet_balances
• required params: none

ledger

• alias: get_ledger_entries
• required params: none

deposit_addresses

• alias: get_deposit_addresses
• required params: none

withdrawal_addresses

• alias: get_withdrawal_addresses
• required params: none

withdrawal withdrawal_id

• alias: get_withdrawal
• required params: withdrawal_id

withdrawals

• alias: get_all_withdrawals
• required params: none

deposit deposit_id

• alias: get_deposit
• required params: deposit_id

deposits

• alias: get_all_deposits
• required params: none

• COMING SOON!

• RSPECs coming soon!

Bug reports and pull requests are welcome on GitHub at https://github.com/mwlang/cobinhood.

The inspiration for architectural layout of this gem comes nearly one-for-one from the Binance gem by craysiii.

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