MaxExchangeApi
A ruby implementation of MAX exchange API
- REST API V2
- Websocket API
Documentations
Supports
- Ruby 2.2 ~ 2.7, 3.0
Installation
gem 'max_exchange_api'
And then execute:
$ bundle
Or install it yourself as:
$ gem install max_exchange_api
Configuration
Set timeout time
# Set default timeout time
MaxExchangeApi.default_config.timeout = 3 # seconds
# Create an api instance with custom timeout time
api = MaxExchangeApi::PublicApi.new(config: { timeout: 12 })
api = MaxExchangeApi::PrivateApi.new(access_key, secret_key, config: { timeout: 12 })
Logging
require 'logger'
# Print log to standard output
MaxExchangeApi.default_config.logger = Logger.new(STDOUT)
# Print log to file
MaxExchangeApi.default_config.logger = Logger.new('log/api.log')
# Create an api instance with custom logger
api = MaxExchangeApi::PublicApi.new(config: { logger: Logger.new(STDOUT) })
api = MaxExchangeApi::PrivateApi.new(access_key, secret_key, config: { logger: Logger.new(STDOUT) })
Usage
Public Api Examples
@api = MaxExchangeApi::PublicApi.new
GET /api/v2/vip_levels
Get all VIP level fees.
Show code
```rb @api.vip_levels ```GET /api/v2/vip_levels/level
Get VIP level fee by level.
Show code
```rb @api.vip_levels(2) ```GET /api/v2/currencies
Get all available currencies.
Show code
```rb @api.currencies ```GET /api/v2/k
Get OHLC(k line) of a specific market.
Show code
```rb # use default parameters @api.k('btctwd') # provide all possible parameters @api.k('btctwd', limit: 30, period: 1, timestamp: 1624705402) ```GET /api/v2/depth
Get depth of a specified market.
Show code
```rb # use default parameters @api.depth('maxtwd') # provide all possible parameters @api.depth('maxtwd', limit: 10, sort_by_price: true) ```GET /api/v2/trades
Get recent trades on market, sorted in reverse creation order.
Show code
```rb # use default parameters @api.trades('btctwd') # provide all possible parameters @api.trades( 'maxtwd', timestamp: 1624705402, from: 68444, to: 69444, order_by: 'asc', pagination: true, page: 3, limit: 15, offset: 5, ) ```GET /api/v2/markets
Get all available markets.
Show code
```rb @api.markets ```GET /api/v2/summary
Overview of market data for all tickers.
Show code
```rb @api.summary ```GET /api/v2/tickers/path_market
Get ticker of specific market.
Show code
```rb @api.tickers('btctwd') ```GET /api/v2/tickers
Get ticker of all markets.
Show code
```rb @api.tickers ```GET /api/v2/timestamp
Get server current time, in seconds since Unix epoch.
Show code
```rb @api.timestamp ```Private Api Examples
access_key = 'YOUR_ACCESS_KEY'
secret_key = 'YOUR_SECRET_KEY'
@api = MaxExchangeApi::PrivateApi.new(access_key, secret_key)
Trade
GET /api/v2/trades/my/of_order
get your executed trades related to a order
Show code
```rb # use max unique order id @api.my_trades_of_order(123456) # use user specified order id @api.my_trades_of_order('MY_ORDER_123456', use_client_id: true) ```GET /api/v2/trades/my
get your executed trades, sorted in reverse creation order
Show code
```rb # use default parameters @api.my_trades('btctwd') # provide all possible parameters @api.my_trades( 'maxtwd', timestamp: 1624705402, from: 68444, to: 69444, order_by: 'asc', pagination: true, page: 3, limit: 15, offset: 5, ) ```Withdrawal
GET /api/v2/withdrawals
get your external withdrawals history
Show code
```rb # use default parameters @api.withdrawals('max') # provide all possible parameters @api.withdrawals( 'max', 'confirmed', from: 68444, to: 69444, state: 'confirmed', pagination: true, page: 3, limit: 15, offset: 5, ) ```GET /api/v2/withdrawal
get details of a specific external withdraw
Show code
```rb @api.withdrawal('withdraw_id') ```POST /api/v2/withdrawal
submit a withdrawal. IP whitelist for api token is required.
Show code
```rb @api.create_withdrawal!('twd', 'withdraw_address_id', 100000) ```Profile
GET /api/v2/members/profile
get personal profile information
Show code
```rb @api.member_profile ```GET /api/v2/members/me
get your profile and accounts information
Show code
```rb @api.me ```GET /api/v2/members/vip_level
get VIP level info
Show code
```rb @api.vip_level ```Account
GET /api/v2/members/accounts
get personal accounts information
Show code
```rb @api.accounts ```GET /api/v2/members/accounts/path_currency
get personal accounts information of a currency
Show code
```rb @api.account(currnecy) ```Deposit
GET /api/v2/deposits
get your deposits history
Show code
```rb # use default parameters @api.deposits('max') # provide all possible parameters @api.deposits( 'max', 'confirmed', from: 68444, to: 69444, state: 'accepted', pagination: true, page: 3, limit: 15, offset: 5, ) ```GET /api/v2/deposit
get details of a specific deposit
Show code
```rb @api.deposit('transaction_id') ```Address
GET /api/v2/deposit_addresses
The addresses could be empty before generated, please call POST /deposit_addresses in that case
Show code
```rb # use default parameters @api.deposit_addresses # provide all possible parameters @api.deposit_addresses(currency: 'twd', pagination: true, page: 3, limit: 15, offset: 5) ```POST /api/v2/deposit_addresses
Address creation is asynchronous, please call GET /deposit_addresses later to get generated addresses
Show code
```rb @api.create_deposit_addresses!('twd') ```GET /api/v2/withdraw_addresses
get withdraw addresses
Show code
```rb # use default parameters @api.withdraw_addresses('twd') # provide all possible parameters @api.withdraw_addresses('usdt', pagination: true, page: 3, limit: 15, offset: 5) ```Internal Transfer
GET /api/v2/internal_transfers
get internal transfers history
Show code
```rb # use default parameters @api.internal_transfers # provide all possible parameters @api.internal_transfers( currency: 'btc', side: 'in', from: 68444, to: 69444, pagination: true, page: 3, limit: 15, offset: 5, ) ```GET /api/v2/internal_transfer
get details of a specific internal transfer
Show code
```rb @api.internal_transfer('internal_transfer_id') ```Reward
GET /api/v2/rewards
get rewards history
Show code
```rb # use default parameters @api.rewards # provide all possible parameters @api.rewards( currency: 'btc', from: 68444, to: 69444, pagination: true, page: 3, limit: 15, offset: 5, ) ```GET /api/v2/rewards/path_reward_type
get specific rewards history
Show code
```rb # use default parameters @api.rewards(reward_type: 'airdrop_rewards') # provide all possible parameters @api.rewards( reward_type: 'airdrop_rewards', currency: 'btc', from: 68444, to: 69444, pagination: true, page: 3, limit: 15, offset: 5, ) ```GET /api/v2/max_rewards/yesterday
get max rewards yesterday
Show code
```rb @api.max_rewards_yesterday ```GET /api/v2/yields
get yields history
Show code
```rb # use default parameters @api.yields # provide all possible parameters @api.yields( currency: 'usdt', from: 68444, to: 69444, pagination: true, page: 3, limit: 15, offset: 5, ) ```Order
GET /api/v2/orders
get your orders, results is paginated.
Show code
```rb # use default parameters @api.orders('maxtwd') # provide all possible parameters @api.orders( 'maxtwd', state: 'done', order_by: 'desc', group_id: 12345, pagination: true, page: 3, limit: 15, offset: 5, ) ```GET /api/v2/order
get a specific order.
Show code
```rb # use max unique order id @api.order(123456) # use user specified order id @api.order('MY_ORDER_123456', use_client_id: true) ```POST /api/v2/orders/clear
cancel all your orders with given market and side
Show code
```rb # use default parameters @api.cancel_orders! # provide all possible parameters @api.cancel_orders!(market: 'maxtwd', side: 'sell', group_id: '123456') ```POST /api/v2/order/delete
cancel an order
Show code
```rb # use max unique order id @api.cancel_order!(123456) # use user specified order id @api.cancel_order!('MY_ORDER_123456', use_client_id: true) ```POST /api/v2/orders
create a sell/buy order
Show code
```rb # use default parameters @api.create_order!('maxtwd', 'buy', 1000, price: 7.5) # provide all possible parameters @api.create_order!( 'maxtwd', 'buy', 1000, price: 7.5, client_oid: 'MY_ORDER_ID_12345', stop_price: 8, ord_type: 'limit', group_id: 12345678, ) ```POST /api/v2/orders/multi/onebyone
Create multiple sell/buy orders, orders may be partially accepted, please put your orders as an array in json body.
Show code
```rb # use default parameters @api.create_orders!('maxtwd', [ { side: 'buy', volume: '1000', price: 7.5 }, { side: 'buy', volume: '1500', price: 7.2 }, ]) # provide all possible parameters @api.create_orders!('maxtwd', [ { side: 'buy', volume: '1000', price: 7.5, client_oid: 'MY_ORDER_ID_12345', stop_price: 8, ord_type: 'limit' }, { side: 'buy', volume: '1500', price: 7.2, client_oid: 'MY_ORDER_ID_12346', stop_price: 8, ord_type: 'limit' }, ], group_id: 12345) ```Development
After checking out the repo, run bin/setup to install dependencies. Then, run rake test 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.
Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/khiav223577/max_exchange_api. 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.
License
The gem is available as open source under the terms of the MIT License.