Module: Binance::Api

Defined in:
lib/binance/api.rb,
lib/binance/api/error.rb,
lib/binance/api/order.rb,
lib/binance/api/margin.rb,
lib/binance/api/account.rb,
lib/binance/api/request.rb,
lib/binance/api/version.rb,
lib/binance/api/data_stream.rb,
lib/binance/api/margin/order.rb,
lib/binance/api/configuration.rb,
lib/binance/api/margin/account.rb

Defined Under Namespace

Modules: Margin Classes: Account, Configuration, DataStream, Error, Order, Request

Constant Summary collapse

VERSION = 
"1.1.2"

Class Method Summary collapse

Class Method Details

.candlesticks!(endTime: nil, interval: nil, limit: 500, startTime: nil, symbol: nil, api_key: nil, api_secret_key: nil) ⇒ Object

Valid limits:[5, 10, 20, 50, 100, 500, 1000]

Raises:



5
6
7
8
9
10
11
 
# File 'lib/binance/api.rb', line 5

def candlesticks!(endTime: nil, interval: nil, limit: 500, startTime: nil, symbol: nil, api_key: nil, api_secret_key: nil)
  raise Error.new(message: "interval is required") unless interval
  raise Error.new(message: "symbol is required") unless symbol
  params = { endTime: endTime, interval: interval, limit: limit, startTime: startTime, symbol: symbol }
  Request.send!(api_key_type: :read_info, path: "/api/v1/klines", params: params,
                api_key: api_key, api_secret_key: api_secret_key)
end

.compressed_aggregate_trades!(endTime: nil, fromId: nil, limit: 500, startTime: nil, symbol: nil, api_key: nil, api_secret_key: nil) ⇒ Object

Raises:



13
14
15
16
17
18
19
20
 
# File 'lib/binance/api.rb', line 13

def compressed_aggregate_trades!(endTime: nil, fromId: nil, limit: 500, startTime: nil, symbol: nil, api_key: nil, api_secret_key: nil)
  raise Error.new(message: "symbol is required") unless symbol
  params = {
    endTime: endTime, fromId: fromId, limit: limit, startTime: startTime, symbol: symbol,
  }.delete_if { |key, value| value.nil? }
  Request.send!(api_key_type: :read_info, path: "/api/v1/aggTrades", params: params,
                api_key: api_key, api_secret_key: api_secret_key)
end

.depth!(symbol: nil, limit: 100, api_key: nil, api_secret_key: nil) ⇒ Object

Raises:



22
23
24
25
26
27
 
# File 'lib/binance/api.rb', line 22

def depth!(symbol: nil, limit: 100, api_key: nil, api_secret_key: nil)
  raise Error.new(message: "symbol is required") unless symbol
  params = { limit: limit, symbol: symbol }
  Request.send!(api_key_type: :read_info, path: "/api/v1/depth", params: params,
                api_key: api_key, api_secret_key: api_secret_key)
end

.exchange_info!(api_key: nil, api_secret_key: nil) ⇒ Object 



29
30
31
32
 
# File 'lib/binance/api.rb', line 29

def exchange_info!(api_key: nil, api_secret_key: nil)
  Request.send!(api_key_type: :read_info, path: "/api/v1/exchangeInfo",
                api_key: api_key, api_secret_key: api_secret_key)
end

.historical_trades!(symbol: nil, limit: 500, fromId: nil, api_key: nil, api_secret_key: nil) ⇒ Object

Raises:



34
35
36
37
38
39
 
# File 'lib/binance/api.rb', line 34

def historical_trades!(symbol: nil, limit: 500, fromId: nil, api_key: nil, api_secret_key: nil)
  raise Error.new(message: "symbol is required") unless symbol
  params = { fromId: fromId, limit: limit, symbol: symbol }
  Request.send!(api_key_type: :read_info, path: "/api/v1/historicalTrades", params: params,
                security_type: :market_data, api_key: api_key, api_secret_key: api_secret_key)
end

.info!(recvWindow: nil, api_key: nil, api_secret_key: nil) ⇒ Object 



41
42
43
44
45
46
 
# File 'lib/binance/api.rb', line 41

def info!(recvWindow: nil, api_key: nil, api_secret_key: nil)
  timestamp = Configuration.timestamp
  params = { recvWindow: recvWindow, timestamp: timestamp }.delete_if { |key, value| value.nil? }
  Request.send!(api_key_type: :read_info, path: "/api/v3/account", params: params, security_type: :user_data,
                api_key: api_key, api_secret_key: api_secret_key)
end

.ping! ⇒ Object 



48
49
50
 
# File 'lib/binance/api.rb', line 48

def ping!
  Request.send!(path: "/api/v1/ping")
end

.ticker!(symbol: nil, type: nil, api_key: nil, api_secret_key: nil) ⇒ Object

Raises:



52
53
54
55
56
57
58
59
60
 
# File 'lib/binance/api.rb', line 52

def ticker!(symbol: nil, type: nil, api_key: nil, api_secret_key: nil)
  ticker_type = type&.to_sym
  error_message = "type must be one of: #{ticker_types.join(", ")}. #{type} was provided."
  raise Error.new(message: error_message) unless ticker_types.include? ticker_type
  path = ticker_path(type: ticker_type)
  params = symbol ? { symbol: symbol } : {}
  Request.send!(api_key_type: :read_info, path: path, params: params,
                api_key: api_key, api_secret_key: api_secret_key)
end

.time! ⇒ Object 



62
63
64
 
# File 'lib/binance/api.rb', line 62

def time!
  Request.send!(path: "/api/v1/time")
end

.trades!(symbol: nil, limit: 500, api_key: nil, api_secret_key: nil) ⇒ Object

Raises:



66
67
68
69
70
71
 
# File 'lib/binance/api.rb', line 66

def trades!(symbol: nil, limit: 500, api_key: nil, api_secret_key: nil)
  raise Error.new(message: "symbol is required") unless symbol
  params = { limit: limit, symbol: symbol }
  Request.send!(api_key_type: :read_info, path: "/api/v1/trades", params: params,
                api_key: api_key, api_secret_key: api_secret_key)
end