Package org.knowm.xchange.okcoin.service

Class OkCoinTradeService

java.lang.Object

org.knowm.xchange.service.BaseExchangeService

org.knowm.xchange.okcoin.service.OkCoinBaseService

org.knowm.xchange.okcoin.service.OKCoinBaseTradeService

org.knowm.xchange.okcoin.service.OkCoinTradeServiceRaw

org.knowm.xchange.okcoin.service.OkCoinTradeService

All Implemented Interfaces:

BaseService, TradeService

public class OkCoinTradeService
extends OkCoinTradeServiceRaw
implements TradeService

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	OkCoinTradeService.OkCoinCancelOrderParam
static class	OkCoinTradeService.OkCoinTradeHistoryParams

Field Summary

Fields inherited from class org.knowm.xchange.okcoin.service.OkCoinTradeServiceRaw

BATCH_DELIMITER

Fields inherited from class org.knowm.xchange.okcoin.service.OKCoinBaseTradeService

apikey, okCoin, secretKey

Fields inherited from class org.knowm.xchange.okcoin.service.OkCoinBaseService

useIntl

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

exchange

Constructor Summary

Constructors

Constructor	Description
OkCoinTradeService(Exchange exchange)	Constructor

Method Summary

Modifier and Type	Method	Description
boolean	cancelOrder(String orderId)	cancels order with matching orderId (conveniance method, typical just delegate to cancelOrder(CancelOrderByIdParams))
boolean	cancelOrder(CancelOrderParams orderParams)	cancels order with matching orderParams
Map<LimitOrder,Boolean>	cancelUpToThreeOrders(List<LimitOrder> limitOrders)	Cancel a batch of up to three orders (maximum allowed by the exchange).
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(OpenOrdersParams params)	Gets the open orders
OkCoinOrderResult	getOrder(long orderId, String symbol)	获取用户的订单信息
OkCoinOrderResult	getOrder(String symbol)	获取用户的未完成的订单信息
OkCoinOrderResult	getOrder(String symbol, Integer type, String... orderIds)	todo 批量获取用户订单
UserTrades	getTradeHistory(TradeHistoryParams params)	OKEX does not support trade history in the usual way, it only provides a aggregated view on a per order basis of how much the order has been filled and the average price.
String	placeBatchLimitOrder(LimitOrder... limitOrders)	批量下单 todo 测试不成功
String	placeLimitOrder(LimitOrder limitOrder)	Place a limit order
String	placeMarketOrder(MarketOrder marketOrder)	Place a market order
String	placeStopOrder(StopOrder stopOrder)	Place a stop order

Methods inherited from class org.knowm.xchange.okcoin.service.OkCoinTradeServiceRaw

batchTrade, cancelOrder, cancelUpToThreeOrders, futureBatchTrade, futureExplosive, futuresCancelOrder, futuresTrade, getFuturesFilledOrder, getFuturesOrder, getFuturesOrders, getFuturesPosition, getFuturesPosition, getFuturesPositionsFixed, getFuturesPriceLimits, getFuturesTradesHistory, getOrder, getOrderHistory, placeMarketOrderBuy, placeMarketOrderSell, trade

Methods inherited from class org.knowm.xchange.okcoin.service.OKCoinBaseTradeService

returnOrThrow, signatureCreator

Methods inherited from class org.knowm.xchange.okcoin.service.OkCoinBaseService

createDelimitedString

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

cancelAllOrders, changeOrder, getOpenPositions, getOrder, getOrder, getRequiredCancelOrderParamClasses, getRequiredOrderQueryParamClass, verifyOrder, verifyOrder

Constructor Details

OkCoinTradeService

public OkCoinTradeService(Exchange exchange)

Constructor

Parameters:

exchange -

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(OpenOrdersParams params)

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.

placeMarketOrder

public String placeMarketOrder(MarketOrder marketOrder)
                        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

placeBatchLimitOrder

public String placeBatchLimitOrder(LimitOrder... limitOrders)
                            throws IOException

批量下单 todo 测试不成功

Parameters:

limitOrders -

Returns:

Throws:

IOException

placeStopOrder

public String placeStopOrder(StopOrder stopOrder)
                      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

cancelOrder

public boolean cancelOrder(CancelOrderParams orderParams)
                    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)
                    throws IOException

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.

Throws:

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

cancelUpToThreeOrders

public Map<LimitOrder,Boolean> cancelUpToThreeOrders(List<LimitOrder> limitOrders)
                                              throws IOException

Cancel a batch of up to three orders (maximum allowed by the exchange).

Parameters:

limitOrders - orders to cancel

Returns:

(id, result) mappings

Throws:

IOException

getTradeHistory

public UserTrades getTradeHistory(TradeHistoryParams params)
                           throws IOException

OKEX does not support trade history in the usual way, it only provides a aggregated view on a per order basis of how much the order has been filled and the average price. Individual trade details are not available. As a consequence of this, the trades supplied by this method will use the order ID as their trade ID, and will be subject to being amended if a partially filled order if further filled. Supported parameters are TradeHistoryParamCurrencyPair and TradeHistoryParamPaging, if not supplied then the query will default to BTC/USD or BTC/CNY (depending on session configuration) and the last 200 trades.

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

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 OkCoinOrderResult getOrder(String symbol)
                           throws IOException

Description copied from class: OkCoinTradeServiceRaw

获取用户的未完成的订单信息

Overrides:

getOrder in class OkCoinTradeServiceRaw

Returns:

Throws:

IOException

getOrder

public OkCoinOrderResult getOrder(long orderId,
 String symbol)
                           throws IOException

Description copied from class: OkCoinTradeServiceRaw

获取用户的订单信息

Overrides:

getOrder in class OkCoinTradeServiceRaw

Returns:

Throws:

IOException

getOrder

public OkCoinOrderResult getOrder(String symbol,
 Integer type,
 String... orderIds)
                           throws IOException

todo 批量获取用户订单

Parameters:

symbol -

type - 查询类型 0:未完成的订单 1:已经完成的订单

orderIds - 多个订单ID中间以","分隔,一次最多允许查询50个订单

Returns:

Throws:

IOException