Package org.knowm.xchange.binance.service

Class BinanceTradeService

java.lang.Object

org.knowm.xchange.service.BaseExchangeService<E>

org.knowm.xchange.service.BaseResilientExchangeService<BinanceExchange>

org.knowm.xchange.binance.service.BinanceBaseService

org.knowm.xchange.binance.service.BinanceTradeServiceRaw

org.knowm.xchange.binance.service.BinanceTradeService

All Implemented Interfaces:

BaseService, TradeService

public class BinanceTradeService
extends BinanceTradeServiceRaw
implements TradeService

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	BinanceTradeService.BinanceOrderFlags

Field Summary

Fields inherited from class org.knowm.xchange.binance.service.BinanceBaseService

apiKey, binance, binanceFutures, inverseBinanceFutures, LOG, signatureCreator

Fields inherited from class org.knowm.xchange.service.BaseResilientExchangeService

resilienceRegistries

Fields inherited from class org.knowm.xchange.service.BaseExchangeService

exchange

Constructor Summary

Constructors

Constructor	Description
BinanceTradeService(BinanceExchange exchange, ResilienceRegistries resilienceRegistries)

Method Summary

Modifier and Type	Method	Description
Collection<String>	cancelAllOrders(CancelAllOrders orderParams)
boolean	cancelOrder(String orderId)	cancels order with matching orderId (conveniance method, typical just delegate to cancelOrder(CancelOrderByIdParams))
boolean	cancelOrder(CancelOrderParams params)	cancels order with matching orderParams
OpenOrdersParams	createOpenOrdersParams()	Create OpenOrdersParams object specific to this exchange.
TradeHistoryParams	createTradeHistoryParams()	Create TradeHistoryParams object specific to this exchange.
OpenOrders	getOpenOrders()	Gets the open orders
OpenOrders	getOpenOrders(CurrencyPair pair)
OpenOrders	getOpenOrders(OpenOrdersParams params)	Gets the open orders
OpenPositions	getOpenPositions()	Get all openPositions of the exchange
Collection<Order>	getOrder(String... orderIds)	get's the latest order form the order book that with matching orderId
Collection<Order>	getOrder(OrderQueryParams... params)	get's the latest order form the order book that with matching orderQueryParams
Class[]	getRequiredCancelOrderParamClasses()	Returns required cancel order parameter as classes
Class	getRequiredOrderQueryParamClass()	Returns required get order parameter as classes
UserTrades	getTradeHistory(TradeHistoryParams params)	Fetch the history of user trades.
String	placeLimitOrder(LimitOrder limitOrder)	Place a limit order
String	placeMarketOrder(MarketOrder mo)	Place a market order
String	placeStopOrder(StopOrder order)	Place a stop order
void	placeTestOrder(OrderType type, Order order, BigDecimal limitPrice, BigDecimal stopPrice)
void	placeTestOrder(OrderType type, Order order, BigDecimal limitPrice, BigDecimal stopPrice, BigDecimal quoteOrderQty, Long trailingDelta)

Methods inherited from class org.knowm.xchange.binance.service.BinanceTradeServiceRaw

allOrders, cancelAllOpenOrdersAllProducts, cancelOrderAllProducts, closeDataStream, getDustLog, keepAliveDataStream, myTradesAllProducts, myTradesPermits, newFutureOrder, newInverseFutureOrder, newOrder, newPortfolioMarginFutureOrder, newPortfolioMarginInverseFutureOrder, openOrdersAllProducts, openOrdersAllProducts, openOrdersPermits, openPositions, orderStatusAllProducts, startUserDataStream, testNewOrder

Methods inherited from class org.knowm.xchange.binance.service.BinanceBaseService

getExchangeInfo, getFutureExchangeInfo, getRecvWindow, getSystemStatus, getTimestampFactory

Methods inherited from class org.knowm.xchange.service.BaseResilientExchangeService

decorateApiCall, rateLimiter, rateLimiter, retry, retry

Methods inherited from class org.knowm.xchange.service.BaseExchangeService

verifyOrder, verifyOrder, verifyOrder

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.knowm.xchange.service.trade.TradeService

changeOrder, verifyOrder, verifyOrder

Constructor Details

BinanceTradeService

public BinanceTradeService(BinanceExchange exchange,
 ResilienceRegistries resilienceRegistries)

Method Details

getOpenOrders

public OpenOrders getOpenOrders()
                         throws IOException

Description copied from interface: TradeService

Gets the open orders

Specified by:

getOpenOrders in interface TradeService

Returns:

the open orders, null if some sort of error occurred. Implementers should log the error.

Throws:

IOException - - Indication that a networking error occurred while fetching JSON data

getOpenOrders

public OpenOrders getOpenOrders(CurrencyPair pair)
                         throws IOException

Throws:

IOException

getOpenOrders

public OpenOrders getOpenOrders(OpenOrdersParams params)
                         throws IOException

Description copied from interface: TradeService

Gets the open orders

Specified by:

getOpenOrders in interface TradeService

Parameters:

params - The parameters describing the filter. Note that OpenOrdersParams is an empty interface. Exchanges should implement its own params object. Params should be create with TradeService.createOpenOrdersParams().

Returns:

the open orders, null if some sort of error occurred. Implementers should log the error.

Throws:

IOException - - Indication that a networking error occurred while fetching JSON data

placeMarketOrder

public String placeMarketOrder(MarketOrder mo)
                        throws IOException

Description copied from interface: TradeService

Place a market order

If your orders amount does to meet the restrictions dictated by InstrumentMetaData then the exchange will reject your order. Use OrderValuesHelper to validate and / or adjust it while you'r building an order.

Specified by:

placeMarketOrder in interface TradeService

Returns:

the order ID

Throws:

IOException - - Indication that a networking error occurred while fetching JSON data

See Also:

• OrderValuesHelper

placeLimitOrder

public String placeLimitOrder(LimitOrder limitOrder)
                       throws IOException

Description copied from interface: TradeService

Place a limit order

If your orders amount or limit price does to meet the restrictions dictated by InstrumentMetaData then the exchange will reject your order. Use OrderValuesHelper to validate and / or adjust those values while you'r building an order.

Specified by:

placeLimitOrder in interface TradeService

Returns:

the order ID

Throws:

IOException - - Indication that a networking error occurred while fetching JSON data

See Also:

• OrderValuesHelper

placeStopOrder

public String placeStopOrder(StopOrder order)
                      throws IOException

Description copied from interface: TradeService

Place a stop order

If your orders amount or spot price does to meet the restrictions dictated by InstrumentMetaData then the exchange will reject your order. Use OrderValuesHelper to validate and / or adjust those values while you'r building an order.

Specified by:

placeStopOrder in interface TradeService

Returns:

the order ID

Throws:

IOException - - Indication that a networking error occurred while fetching JSON data

See Also:

• OrderValuesHelper

placeTestOrder

public void placeTestOrder(OrderType type,
 Order order,
 BigDecimal limitPrice,
 BigDecimal stopPrice)
                    throws IOException

Throws:

IOException

placeTestOrder

public void placeTestOrder(OrderType type,
 Order order,
 BigDecimal limitPrice,
 BigDecimal stopPrice,
 BigDecimal quoteOrderQty,
 Long trailingDelta)
                    throws IOException

Throws:

IOException

cancelOrder

public boolean cancelOrder(CancelOrderParams params)
                    throws IOException

Description copied from interface: TradeService

cancels order with matching orderParams

Specified by:

cancelOrder in interface TradeService

Returns:

true if order was successfully cancelled, false otherwise.

Throws:

IOException - - Indication that a networking error occurred while fetching JSON data

cancelOrder

public boolean cancelOrder(String orderId)

Description copied from interface: TradeService

cancels order with matching orderId (conveniance method, typical just delegate to cancelOrder(CancelOrderByIdParams))

Specified by:

cancelOrder in interface TradeService

Returns:

true if order was successfully cancelled, false otherwise.

getRequiredCancelOrderParamClasses

public Class[] getRequiredCancelOrderParamClasses()

Description copied from interface: TradeService

Returns required cancel order parameter as classes

Different trading services requires different parameters for order cancellation. To provide generic operation of the trade service interface. This method returns Class of the parameter objects as an array. This class information can be utilized by the caller of TradeService.cancelOrder(CancelOrderParams) to create instances of the required parameters such as CancelOrderByIdParams, CancelOrderByInstrument etc...

Specified by:

getRequiredCancelOrderParamClasses in interface TradeService

Returns:

Class types for the required parameter classes. Default implementation returns an array with a single CancelOrderByIdParams element

getTradeHistory

public UserTrades getTradeHistory(TradeHistoryParams params)
                           throws IOException

Description copied from interface: TradeService

Fetch the history of user trades.

If you are calling this method for single exchange, known at the development time, you may pass an object of specific *TradeHistoryParam class that is nested it that exchange's trade service.

If, however, you are fetching user trade history from many exchanges using the same code, you will find useful to create the parameter object with TradeService.createTradeHistoryParams() and check which parameters are required or supported using instanceof operator. See subinterfaces of TradeHistoryParams. Note that whether an interface is required or supported will vary from exchange to exchange and it's described only through the javadoc.

There is also implementation of all the common interfaces, TradeHistoryParamsAll , that, with all properties set non-null, should work with any exchange.

Some exchanges allow extra parameters, not covered by any common interface. To access them, you will have to use the object returned by TradeService.createTradeHistoryParams() and cast it to the exchange-specific type.

Specified by:

getTradeHistory in interface TradeService

Parameters:

params - The parameters describing the filter. Note that TradeHistoryParams is an empty interface. Exact set of interfaces that are required or supported by this method is described by the type of object returned from TradeService.createTradeHistoryParams() and the javadoc of the method.

Returns:

UserTrades as returned by the exchange API

Throws:

IOException - - Indication that a networking error occurred while fetching JSON data

See Also:

• TradeService.createTradeHistoryParams()
• TradeHistoryParamsAll

getOrder

public Collection<Order> getOrder(OrderQueryParams... params)
                           throws IOException

Description copied from interface: TradeService

get's the latest order form the order book that with matching orderQueryParams

Specified by:

getOrder in interface TradeService

Returns:

the order as it is on the exchange.

Throws:

IOException - - Indication that a networking error occurred while fetching JSON data

getOpenPositions

public OpenPositions getOpenPositions()
                               throws IOException

Description copied from interface: TradeService

Get all openPositions of the exchange

Specified by:

getOpenPositions in interface TradeService

Throws:

IOException

cancelAllOrders

public Collection<String> cancelAllOrders(CancelAllOrders orderParams)
                                   throws IOException

Specified by:

cancelAllOrders in interface TradeService

Throws:

IOException

createTradeHistoryParams

public TradeHistoryParams createTradeHistoryParams()

Description copied from interface: TradeService

Create TradeHistoryParams object specific to this exchange. Object created by this method may be used to discover supported and required TradeService.getTradeHistory(TradeHistoryParams) parameters and should be passed only to the method in the same class as the createTradeHistoryParams that created the object.

Specified by:

createTradeHistoryParams in interface TradeService

createOpenOrdersParams

public OpenOrdersParams createOpenOrdersParams()

Description copied from interface: TradeService

Create OpenOrdersParams object specific to this exchange. Object created by this method may be used to discover supported and required TradeService.getOpenOrders(OpenOrdersParams) parameters and should be passed only to the method in the same class as the createOpenOrdersParams that created the object.

Specified by:

createOpenOrdersParams in interface TradeService

getOrder

public Collection<Order> getOrder(String... orderIds)

Description copied from interface: TradeService

get's the latest order form the order book that with matching orderId

Specified by:

getOrder in interface TradeService

Returns:

the order as it is on the exchange.

getRequiredOrderQueryParamClass

public Class getRequiredOrderQueryParamClass()

Description copied from interface: TradeService

Returns required get order parameter as classes

Different trading services requires different parameters for order querying. To provide generic operation of the trade service interface, This method returns Class of the parameter objects as an array. This class information can be utilized by the caller of TradeService.getOrder(OrderQueryParams...) to create instances of the required parameter such as OrderQueryParamCurrencyPair, OrderQueryParamInstrument etc...

Specified by:

getRequiredOrderQueryParamClass in interface TradeService

Returns:

Class type for the required parameter class. Default implementation returns an instance of OrderQueryParams element