com.xeiam.xchange.bter.service.polling

Class BTERPollingTradeService

java.lang.Object

com.xeiam.xchange.service.BaseExchangeService

com.xeiam.xchange.bter.service.polling.BTERBasePollingService

com.xeiam.xchange.bter.service.polling.BTERPollingTradeServiceRaw

com.xeiam.xchange.bter.service.polling.BTERPollingTradeService

All Implemented Interfaces:

BasePollingService, PollingTradeService

public class BTERPollingTradeService
extends BTERPollingTradeServiceRaw
implements PollingTradeService

Field Summary

Fields inherited from class com.xeiam.xchange.bter.service.polling.BTERBasePollingService

apiKey, bter, signatureCreator

Fields inherited from class com.xeiam.xchange.service.BaseExchangeService

exchange

Constructor Summary

Constructors

Constructor and Description
BTERPollingTradeService(Exchange exchange) Constructor

Method Summary

Modifier and Type	Method and Description
boolean	cancelOrder(String orderId) cancels order with matching orderId
TradeHistoryParamCurrencyPair	createTradeHistoryParams() Create TradeHistoryParams object specific to this exchange.
OpenOrders	getOpenOrders() Gets the open orders
UserTrades	getTradeHistory(Object... args) gets trade history for user's account
UserTrades	getTradeHistory(TradeHistoryParams params) Required parameter: TradeHistoryParamCurrencyPair
String	placeLimitOrder(LimitOrder limitOrder) Submits a Limit Order to be executed on the BTER Exchange for the desired market defined by CurrencyPair.
String	placeMarketOrder(MarketOrder marketOrder) Place a market order

Methods inherited from class com.xeiam.xchange.bter.service.polling.BTERPollingTradeServiceRaw

getBTEROpenOrders, getBTEROrderStatus, getBTERTradeHistory, placeBTERLimitOrder, placeBTERLimitOrder

Methods inherited from class com.xeiam.xchange.bter.service.polling.BTERBasePollingService

getExchangeSymbols, handleResponse

Methods inherited from class com.xeiam.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 com.xeiam.xchange.service.polling.trade.PollingTradeService

verifyOrder, verifyOrder

Methods inherited from interface com.xeiam.xchange.service.polling.BasePollingService

getExchangeSymbols

Constructor Detail

BTERPollingTradeService

public BTERPollingTradeService(Exchange exchange)

Constructor

Parameters:

exchange -

Method Detail

getOpenOrders

public OpenOrders getOpenOrders()
                         throws IOException

Description copied from interface: PollingTradeService

Gets the open orders

Specified by:

getOpenOrders in interface PollingTradeService

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 marketOrder)
                        throws IOException

Description copied from interface: PollingTradeService

Place a market order

Specified by:

placeMarketOrder in interface PollingTradeService

Returns:

the order ID

Throws:

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

placeLimitOrder

public String placeLimitOrder(LimitOrder limitOrder)
                       throws IOException

Submits a Limit Order to be executed on the BTER Exchange for the desired market defined by CurrencyPair. WARNING - BTER will return true regardless of whether or not an order actually gets created. The reason for this is that orders are simply submitted to a queue in their back-end. One example for why an order might not get created is because there are insufficient funds. The best attempt you can make to confirm that the order was created is to poll getOpenOrders(). However, if the order is created and executed before it is caught in its open state from calling getOpenOrders() then the only way to confirm would be confirm the expected difference in funds available for your account.

Specified by:

placeLimitOrder in interface PollingTradeService

Returns:

String "true"/"false" Used to determine if the order request was submitted successfully.

Throws:

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

cancelOrder

public boolean cancelOrder(String orderId)
                    throws IOException

Description copied from interface: PollingTradeService

cancels order with matching orderId

Specified by:

cancelOrder in interface PollingTradeService

Overrides:

cancelOrder in class BTERPollingTradeServiceRaw

Returns:

true if order was successfully cancelled, false otherwise.

Throws:

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

getTradeHistory

public UserTrades getTradeHistory(Object... args)
                           throws IOException

Description copied from interface: PollingTradeService

gets trade history for user's account

Specified by:

getTradeHistory in interface PollingTradeService

Returns:

Throws:

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

getTradeHistory

public UserTrades getTradeHistory(TradeHistoryParams params)
                           throws ExchangeException,
                                  IOException

Required parameter: TradeHistoryParamCurrencyPair

Specified by:

getTradeHistory in interface PollingTradeService

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 PollingTradeService.createTradeHistoryParams() and the javadoc of the method.

Returns:

UserTrades as returned by the exchange API

Throws:

ExchangeException - - Indication that the exchange reported some kind of error with the request or response

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

See Also:

PollingTradeService.getTradeHistory(Object...), PollingTradeService.createTradeHistoryParams(), TradeHistoryParamsAll

createTradeHistoryParams

public TradeHistoryParamCurrencyPair createTradeHistoryParams()

Description copied from interface: PollingTradeService

Create TradeHistoryParams object specific to this exchange. Object created by this method may be used to discover supported and required PollingTradeService.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 PollingTradeService