Package org.knowm.xchange.binance.service

Class BinanceAccountService

java.lang.Object

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

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

org.knowm.xchange.binance.service.BinanceBaseService

org.knowm.xchange.binance.service.BinanceAccountServiceRaw

org.knowm.xchange.binance.service.BinanceAccountService

All Implemented Interfaces:

AccountService, BaseService

Direct Known Subclasses:

BinanceUsAccountService

public class BinanceAccountService
extends BinanceAccountServiceRaw
implements AccountService

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
BinanceAccountService(BinanceExchange exchange, ResilienceRegistries resilienceRegistries)

Method Summary

Modifier and Type	Method	Description
TradeHistoryParams	createFundingHistoryParams()	Create TradeHistoryParams object specific to this exchange.
AccountInfo	getAccountInfo()	Get account info
Map<String,AssetDetail>	getAssetDetails()
Fee	getCommissionRateByInstrument(Instrument instrument)
Map<Instrument,Fee>	getDynamicTradingFeesByInstrument(String... category)	Results based on ExchangeSpecificParametersItem(EXCHANGE_TYPE)
List<BinanceFlexiblePosition>	getFlexiblePositions(String asset, String productId, Long current, Long size)
List<FundingRecord>	getFundingHistory(TradeHistoryParams params)
List<BinanceLockedPosition>	getLockedPositions(String asset, Long positionId, String projectId, Long current, Long size)
BinanceSimpleAccount	getSimpleAccount()
String	requestDepositAddress(Currency currency, String... args)	Request a digital currency address to fund this account.
String	requestDepositAddress(RequestDepositAddressParams requestDepositAddressParams)	Request a digital currency address to fund this account.
AddressWithTag	requestDepositAddressData(Currency currency, String... args)	Request a digital currency address to fund this account.
AddressWithTag	requestDepositAddressData(RequestDepositAddressParams requestDepositAddressParams)	Request a digital currency address to fund this account.
boolean	setLeverage(Instrument instrument, int leverage, Object... args)	Change user's initial leverage of specific symbol market.
String	withdrawFunds(Currency currency, BigDecimal amount, String address)	Convenience method, typically just delegates to withdrawFunds(WithdrawFundsParams params)
String	withdrawFunds(Currency currency, BigDecimal amount, AddressWithTag address)	Convenience method, typically just delegates to withdrawFunds(WithdrawFundsParams params)
String	withdrawFunds(WithdrawFundsParams params)	Withdraw funds from this account.

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

account, currencyInfos, depositHistory, futuresAccount, futuresAccount, getAssetDividend, getAssetDividend, getCommissionRate, getCurrencyInfo, getCurrencyInfoCached, getFiatOrders, getFlexiblePositionsRaw, getLockedPositionsRaw, getSubUserHistory, getTradeFee, getTransferHistory, requestAssetDetail, requestDepositAddress, requestDepositAddressWithNetwork, setDualSidePosition, setLeverageRaw, setMarginType, withdraw, withdraw, withdrawHistory

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

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

Constructor Details

BinanceAccountService

public BinanceAccountService(BinanceExchange exchange,
 ResilienceRegistries resilienceRegistries)

Method Details

getAccountInfo

public AccountInfo getAccountInfo()
                           throws IOException

Description copied from interface: AccountService

Get account info

Specified by:

getAccountInfo in interface AccountService

Returns:

the AccountInfo object, null if some sort of error occurred. Implementers should log the error.

Throws:

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

getDynamicTradingFeesByInstrument

public Map<Instrument,Fee> getDynamicTradingFeesByInstrument(String... category)
                                                      throws IOException

Results based on ExchangeSpecificParametersItem(EXCHANGE_TYPE)

Specified by:

getDynamicTradingFeesByInstrument in interface AccountService

Parameters:

category - Optional arguments - instrument category. Exchange-specific (SPOT, SWAP, etc...)

Returns:

map between currency pairs and their fees at the time of invocation.

Throws:

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

getCommissionRateByInstrument

public Fee getCommissionRateByInstrument(Instrument instrument)
                                  throws IOException

Throws:

IOException

withdrawFunds

public String withdrawFunds(Currency currency,
 BigDecimal amount,
 String address)
                     throws IOException

Description copied from interface: AccountService

Convenience method, typically just delegates to withdrawFunds(WithdrawFundsParams params)

Specified by:

withdrawFunds in interface AccountService

Parameters:

currency - The currency to withdraw

amount - The amount to withdraw

address - The destination address

Returns:

The result of the withdrawal (usually a transaction ID)

Throws:

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

withdrawFunds

public String withdrawFunds(Currency currency,
 BigDecimal amount,
 AddressWithTag address)
                     throws IOException

Description copied from interface: AccountService

Convenience method, typically just delegates to withdrawFunds(WithdrawFundsParams params)

Specified by:

withdrawFunds in interface AccountService

Parameters:

currency - The currency to withdraw

amount - The amount to withdraw

address - The destination address

Returns:

The result of the withdrawal (usually a transaction ID)

Throws:

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

withdrawFunds

public String withdrawFunds(WithdrawFundsParams params)
                     throws IOException

Description copied from interface: AccountService

Withdraw funds from this account. Allows to withdraw digital currency funds from the exchange account to an external address

Specified by:

withdrawFunds in interface AccountService

Parameters:

params - The withdrawl details

Returns:

The result of the withdrawal (usually a transaction ID)

Throws:

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

requestDepositAddress

public String requestDepositAddress(Currency currency,
 String... args)
                             throws IOException

Description copied from interface: AccountService

Request a digital currency address to fund this account. Allows to fund the exchange account with digital currency from an external address

Specified by:

requestDepositAddress in interface AccountService

Parameters:

currency - The digital currency that corresponds to the desired deposit address.

args - Necessary argument(s) as a String

Returns:

the internal deposit address to send funds to

Throws:

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

requestDepositAddressData

public AddressWithTag requestDepositAddressData(Currency currency,
 String... args)
                                         throws IOException

Description copied from interface: AccountService

Request a digital currency address to fund this account. Allows to fund the exchange account with digital currency from an external address

Specified by:

requestDepositAddressData in interface AccountService

Parameters:

currency - The digital currency that corresponds to the desired deposit address.

Returns:

the internal deposit address to send funds to

Throws:

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

requestDepositAddressData

public AddressWithTag requestDepositAddressData(RequestDepositAddressParams requestDepositAddressParams)
                                         throws IOException

Description copied from interface: AccountService

Request a digital currency address to fund this account. Allows to fund the exchange account with digital currency from an external address

Specified by:

requestDepositAddressData in interface AccountService

Parameters:

requestDepositAddressParams - The deposit address request parameters

Returns:

the internal deposit address to send funds to

Throws:

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

requestDepositAddress

public String requestDepositAddress(RequestDepositAddressParams requestDepositAddressParams)
                             throws IOException

Description copied from interface: AccountService

Request a digital currency address to fund this account. Allows to fund the exchange account with digital currency from an external address

Specified by:

requestDepositAddress in interface AccountService

Parameters:

requestDepositAddressParams - The deposit address request parameters

Returns:

the internal deposit address to send funds to

Throws:

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

getAssetDetails

public Map<String,AssetDetail> getAssetDetails()
                                        throws IOException

Throws:

IOException

createFundingHistoryParams

public TradeHistoryParams createFundingHistoryParams()

Description copied from interface: AccountService

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

Specified by:

createFundingHistoryParams in interface AccountService

getFundingHistory

public List<FundingRecord> getFundingHistory(TradeHistoryParams params)
                                      throws IOException

Specified by:

getFundingHistory in interface AccountService

Returns:

list of funding history if available or an empty list otherwise. This should never return null.

Throws:

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

setLeverage

public boolean setLeverage(Instrument instrument,
 int leverage,
 Object... args)
                    throws IOException

Description copied from interface: AccountService

Change user's initial leverage of specific symbol market.

Specified by:

setLeverage in interface AccountService

Parameters:

instrument - symbol to change leverage

leverage - leverage

Returns:

true, if success

Throws:

IOException

getSimpleAccount

public BinanceSimpleAccount getSimpleAccount()
                                      throws IOException

Overrides:

getSimpleAccount in class BinanceAccountServiceRaw

Throws:

IOException

getFlexiblePositions

public List<BinanceFlexiblePosition> getFlexiblePositions(String asset,
 String productId,
 Long current,
 Long size)
                                                   throws IOException

Throws:

IOException

getLockedPositions

public List<BinanceLockedPosition> getLockedPositions(String asset,
 Long positionId,
 String projectId,
 Long current,
 Long size)
                                               throws IOException

Throws:

IOException