com.dukascopy.api

Interface IDataService

public interface IDataService

Provide with system state:

• The information about high/low prices for corresponding instruments and periods.
• The times of first ticks, bars, candles etc. for corresponding instruments.
• Forex Sentiment Indices.
• Offline Time Intervals
• ...

Author:

aburenin

Method Summary

Modifier and Type	Method and Description
void	addDailyHighLowListener(Instrument instrument, IDailyHighLowListener listener) The method adds daily high/low listener.
void	addHighLowListener(Period period, Instrument instrument, IHighLowListener listener) Deprecated.
void	addHighLowListener(Period period, Instrument instrument, OfferSide offerSide, IHighLowListener listener) The method adds high/low listener. After addition, listener will be notified with the current best period's high/low (If in progress candle exists in the system) If in progress candle doesn't exist in the system listener will be notified as soon as candle arrives
java.util.Map<Instrument,java.util.Collection<IDailyHighLowListener>>	getDailyHighLowListeners() Returns all daily high/low listeners This method equals to getHighLowListeners(Period.DAILY)
java.util.Collection<IDailyHighLowListener>	getDailyHighLowListeners(Instrument instrument) Returns all daily high/low listeners subscribed on the passed instrument.
IFXSentimentIndex	getFXSentimentIndex(java.util.Currency currency) Deprecated. Returns null
IFXSentimentIndex	getFXSentimentIndex(java.util.Currency currency, long time) Deprecated. Returns null
java.util.List<IFXSentimentIndexBar>	getFXSentimentIndex(java.util.Currency currency, Period period, long from, long to) Deprecated. Returns null
IFXSentimentIndex	getFXSentimentIndex(ICurrency currency) Deprecated. Returns null
IFXSentimentIndex	getFXSentimentIndex(ICurrency currency, long time) Deprecated. Returns null
java.util.List<IFXSentimentIndexBar>	getFXSentimentIndex(ICurrency currency, Period period, long from, long to) Deprecated. Returns null
IFXSentimentIndex	getFXSentimentIndex(Instrument instrument) Returns last updated Forex Sentiment Index for specified subscribed Instrument.
IFXSentimentIndex	getFXSentimentIndex(Instrument instrument, long time) Deprecated. Returns null
java.util.List<IFXSentimentIndexBar>	getFXSentimentIndex(Instrument instrument, Period period, long from, long to) Deprecated. Returns null
java.util.Map<Period,java.util.Map<Instrument,java.util.Collection<IHighLowListener>>>	getHighLowListeners() Returns all high/low listeners
java.util.Map<Instrument,java.util.Collection<IHighLowListener>>	getHighLowListeners(Period period) Returns all high/low listeners subscribed to the passed period and grouped by instrument
java.util.Collection<IHighLowListener>	getHighLowListeners(Period period, Instrument instrument) Returns all high/low listeners subscribed to the passed period and instrument
double	getLongSwapInAccountCurrency(Instrument instrument, double amount) Returns a Long Overnight Swap in account currency for specified amount.
double	getLongSwapInPips(Instrument instrument) Returns a Long Overnight Swap in pips.
double	getLongSwapRateCoefficient(Instrument instrument) Returns the coefficient for calculating a Long Overnight Swap.
ITimeDomain	getOfflineTimeDomain() Deprecated. Use getOfflineTimeDomain(Instrument) instead.
ITimeDomain	getOfflineTimeDomain(Instrument instrument) Returns either present, current offline (weekend) time interval or the next approximate upcoming one. The same as #getOfflineTimeDomain(shift) with shift == 0
ITimeDomain	getOfflineTimeDomain(int shift) Deprecated. Use getOfflineTimeDomain(int, Instrument) instead.
ITimeDomain	getOfflineTimeDomain(int shift, Instrument instrument) Returns offline (weekend) time interval that is shifted back or forward for number of offline intervals specified in shift parameter.
java.util.Set<ITimeDomain>	getOfflineTimeDomains(long from, long to) Deprecated. Use getOfflineTimeDomains(long, long, Instrument) instead.
java.util.Set<ITimeDomain>	getOfflineTimeDomains(long from, long to, Instrument instrument) Returns the set of offline (weekend) time intervals ascending ordered by time which are within the limits of from and to parameters.
java.util.Map<java.lang.String,java.lang.Object>	getServerProperties() Return unmodifiable map of server properties
double	getShortSwapInAccountCurrency(Instrument instrument, double amount) Returns a Short Overnight Swap in account currency for specified amount.
double	getShortSwapInPips(Instrument instrument) Returns a Short Overnight Swap in pips.
double	getShortSwapRateCoefficient(Instrument instrument) Returns the coefficient for calculating a Short Overnight Swap.
long	getTimeOfFirstCandle(IFeedDescriptor feedDescriptor) Returns the time of first feed data specified in IFeedDescriptor.
long	getTimeOfFirstCandle(Instrument instrument, Period period) Returns the time of first candles for specified Instrument and Period
long	getTimeOfFirstKagi(Instrument instrument, Period timeSession) Returns the time of first kagi for specified Instrument and Period (time session)
long	getTimeOfFirstLineBreak(Instrument instrument, Period timeSession) Returns the time of first N-Line Break for specified Instrument and Period (time session)
long	getTimeOfFirstPointAndFigure(Instrument instrument, PriceRange priceRange, ReversalAmount reversalAmount) Deprecated. use getTimeOfFirstPointAndFigure(Instrument, PriceRange, ReversalAmount, com.dukascopy.api.feed.DataInterpolationDescriptor)
long	getTimeOfFirstPointAndFigure(Instrument instrument, PriceRange priceRange, ReversalAmount reversalAmount, DataInterpolationDescriptor dataInterpolationDescriptor) Returns the time of first point & figures for specified Instrument, PriceRange, ReversalAmount and DataInterpolationDescriptor
long	getTimeOfFirstRangeBar(Instrument instrument, PriceRange priceRange) Deprecated. use getTimeOfFirstRangeBar(Instrument, PriceRange, com.dukascopy.api.feed.DataInterpolationDescriptor)
long	getTimeOfFirstRangeBar(Instrument instrument, PriceRange priceRange, DataInterpolationDescriptor dataInterpolationDescriptor) Returns the time of first price range bars for specified Instrument, PriceRange and DataInterpolationDescriptor
long	getTimeOfFirstRenko(Instrument instrument, Period timeSession) Returns the time of first renko for specified Instrument and Period (time session)
long	getTimeOfFirstRenko(Instrument instrument, PriceRange priceRange) Deprecated. use getTimeOfFirstRenko(Instrument, Period)
long	getTimeOfFirstTick(Instrument instrument) Returns the time of first ticks for specified Instrument
long	getTimeOfFirstTickBar(Instrument instrument) Returns the time of first tick bars for specified Instrument
IWLabelData	getWhiteLabelData()
boolean	isOfflineTime(long time) Deprecated. Use isOfflineTime(long, Instrument) instead.
boolean	isOfflineTime(long time, Instrument instrument) Returns true if specified time is within the limits of offline (weekend) period.
void	removeAllDailyHighLowListeners() Removes all high/low listeners
void	removeAllHighLowListeners() Removes all high/low listeners NOTE: shared instance of listeners will be unsubscribed from every period and/or instrument.
void	removeDailyHighLowListener(IDailyHighLowListener listener) Removes daily high/low listener
void	removeHighLowListener(IHighLowListener listener) Removes high/low listener. NOTE: shared instance of listener will be unsubscribed from every period and/or instrument.

Method Detail

addDailyHighLowListener

void addDailyHighLowListener(Instrument instrument,
                             IDailyHighLowListener listener)

The method adds daily high/low listener. After addition listener will be notified with the current best daily high/low (If in progress daily candle exists in the system). If in progress candle doesn't exist in the system listener will be notified as soon as candle arrives. This method equals to addHighLowListener(Period.DAILY, instrument, listener)

Parameters:

instrument - Instrument to listen for high/low

listener - listener to add

See Also:

addHighLowListener(Period, Instrument, IHighLowListener)

removeDailyHighLowListener

void removeDailyHighLowListener(IDailyHighLowListener listener)

Removes daily high/low listener

Parameters:

listener - listener to remove

See Also:

removeHighLowListener(IHighLowListener)

getDailyHighLowListeners

java.util.Collection<IDailyHighLowListener> getDailyHighLowListeners(Instrument instrument)

Returns all daily high/low listeners subscribed on the passed instrument. This method equals to getHighLowListeners(Period.DAILY, instrument)

Parameters:

instrument - Instrument to get listeners for

Returns:

all daily high/low listeners subscribed on the passed instrument

See Also:

getHighLowListeners(Period, Instrument)

getDailyHighLowListeners

java.util.Map<Instrument,java.util.Collection<IDailyHighLowListener>> getDailyHighLowListeners()

Returns all daily high/low listeners This method equals to getHighLowListeners(Period.DAILY)

Returns:

all daily high/low listeners

See Also:

getHighLowListeners(Period)

removeAllDailyHighLowListeners

void removeAllDailyHighLowListeners()

Removes all high/low listeners

See Also:

removeAllHighLowListeners()

addHighLowListener

void addHighLowListener(Period period,
                        Instrument instrument,
                        OfferSide offerSide,
                        IHighLowListener listener)

The method adds high/low listener.
After addition, listener will be notified with the current best period's high/low (If in progress candle exists in the system) If in progress candle doesn't exist in the system listener will be notified as soon as candle arrives

Parameters:

period - Candles' Period to listen to. Period.TICK isn't supported.

instrument - Candles Instrument to listen to.

offerSide - Candles OfferSide to listen to.

listener - instance of IHighLowListener

addHighLowListener

@Deprecated
void addHighLowListener(Period period,
                                    Instrument instrument,
                                    IHighLowListener listener)

Deprecated.

removeHighLowListener

void removeHighLowListener(IHighLowListener listener)

Removes high/low listener.
NOTE: shared instance of listener will be unsubscribed from every period and/or instrument.

Parameters:

listener - instance of IHighLowListener

getHighLowListeners

java.util.Collection<IHighLowListener> getHighLowListeners(Period period,
                                                           Instrument instrument)

Returns all high/low listeners subscribed to the passed period and instrument

Parameters:

period - listener's Period

instrument - listener's Instrument

Returns:

all high/low listeners subscribed to the passed period and instrument

getHighLowListeners

java.util.Map<Instrument,java.util.Collection<IHighLowListener>> getHighLowListeners(Period period)

Returns all high/low listeners subscribed to the passed period and grouped by instrument

Parameters:

period - listener's Period

Returns:

a map of all high/low listeners subscribed to the passed period and grouped by instrument

getHighLowListeners

java.util.Map<Period,java.util.Map<Instrument,java.util.Collection<IHighLowListener>>> getHighLowListeners()

Returns all high/low listeners

Returns:

all high/low listeners grouped by period and instrument

removeAllHighLowListeners

void removeAllHighLowListeners()

Removes all high/low listeners NOTE: shared instance of listeners will be unsubscribed from every period and/or instrument.

getTimeOfFirstCandle

long getTimeOfFirstCandle(IFeedDescriptor feedDescriptor)

Returns the time of first feed data specified in IFeedDescriptor.

Parameters:

feedDescriptor - the IFeedDescriptor specifies the feed data the first time must be returned.
IFeedDescriptor.getDataType() determines the required properties of IFeedDescriptor must be set and
the specifies the method will be invoked:

• DataType#TICKS - requires Instrument, equals to getTimeOfFirstTick(Instrument)
• DataType#TICK_BAR - requires Instrument, equals to getTimeOfFirstTickBar(Instrument)
• DataType#TIME_PERIOD_AGGREGATION - requires Instrument and Period, equals to getTimeOfFirstCandle(Instrument, Period)
• DataType#PRICE_RANGE_AGGREGATION - requires Instrument and PriceRange, equals to getTimeOfFirstRangeBar(Instrument, PriceRange)
• DataType#POINT_AND_FIGURE - requires Instrument, PriceRange and and ReversalAmount, equals to getTimeOfFirstPointAndFigure(Instrument, PriceRange, ReversalAmount)
• DataType#RENKO - requires Instrument and PriceRange, equals to getTimeOfFirstRenko(Instrument, PriceRange)
• DataType#LINE_BREAK - requires Instrument and Period, equals to getTimeOfFirstLineBreak(Instrument, Period)

Returns:

Returns the time of first feed data specified in IFeedDescriptor or Long.MAX_VALUE if there is no one.

getTimeOfFirstTick

long getTimeOfFirstTick(Instrument instrument)

Returns the time of first ticks for specified Instrument

Parameters:

instrument - the Instrument the first tick's time must be returned.

Returns:

the time of first ticks for specified Instrument or Long.MAX_VALUE if there is no one.

See Also:

DataType.TICKS

getTimeOfFirstTickBar

long getTimeOfFirstTickBar(Instrument instrument)

Returns the time of first tick bars for specified Instrument

Parameters:

instrument - the Instrument the first Tick Bars' time must be returned.

Returns:

the time of first tick bars for specified Instrument or Long.MAX_VALUE if there is no one.

See Also:

DataType.TICK_BAR

getTimeOfFirstCandle

long getTimeOfFirstCandle(Instrument instrument,
                          Period period)

Returns the time of first candles for specified Instrument and Period

Parameters:

instrument - the Instrument the first candles' time must be returned.

period - the Period the first candles' time must be returned.

Returns:

the time of first candles for specified Instrument and Period or Long.MAX_VALUE if there is no one.

See Also:

DataType.TIME_PERIOD_AGGREGATION

getTimeOfFirstRangeBar

@Deprecated
long getTimeOfFirstRangeBar(Instrument instrument,
                                        PriceRange priceRange)

Deprecated. use getTimeOfFirstRangeBar(Instrument, PriceRange, com.dukascopy.api.feed.DataInterpolationDescriptor)

Returns the time of first price range bars for specified Instrument and PriceRange

Parameters:

instrument - the Instrument the first price range bars' time must be returned.

priceRange - the PriceRange the first price range bars' time must be returned.

Returns:

the time of first price range bars for specified Instrument and PriceRange or Long.MAX_VALUE if there is no one.

See Also:

DataType.PRICE_RANGE_AGGREGATION

getTimeOfFirstRangeBar

long getTimeOfFirstRangeBar(Instrument instrument,
                            PriceRange priceRange,
                            DataInterpolationDescriptor dataInterpolationDescriptor)

Returns the time of first price range bars for specified Instrument, PriceRange and DataInterpolationDescriptor

Parameters:

instrument - the Instrument the first price range bars' time must be returned.

priceRange - the PriceRange the first price range bars' time must be returned.

dataInterpolationDescriptor - the DataInterpolationDescriptor the first price range bars' time must be returned.

Returns:

the time of first price range bars for specified Instrument and PriceRange or Long.MAX_VALUE if there is no one.

See Also:

DataType.PRICE_RANGE_AGGREGATION

getTimeOfFirstPointAndFigure

@Deprecated
long getTimeOfFirstPointAndFigure(Instrument instrument,
                                              PriceRange priceRange,
                                              ReversalAmount reversalAmount)

Deprecated. use getTimeOfFirstPointAndFigure(Instrument, PriceRange, ReversalAmount, com.dukascopy.api.feed.DataInterpolationDescriptor)

Returns the time of first point & figures for specified Instrument, PriceRange and ReversalAmount

Parameters:

instrument - the Instrument the first point & figures' time must be returned.

priceRange - the PriceRange the first point & figures' time must be returned.

reversalAmount - the ReversalAmount the first point & figures' time must be returned.

Returns:

the time of first point & figures for specified Instrument, PriceRange and ReversalAmount or Long.MAX_VALUE if there is no one.

See Also:

DataType.POINT_AND_FIGURE

getTimeOfFirstPointAndFigure

long getTimeOfFirstPointAndFigure(Instrument instrument,
                                  PriceRange priceRange,
                                  ReversalAmount reversalAmount,
                                  DataInterpolationDescriptor dataInterpolationDescriptor)

Returns the time of first point & figures for specified Instrument, PriceRange, ReversalAmount and DataInterpolationDescriptor

Parameters:

instrument - the Instrument the first point & figures' time must be returned.

priceRange - the PriceRange the first point & figures' time must be returned.

reversalAmount - the ReversalAmount the first point & figures' time must be returned.

dataInterpolationDescriptor - the DataInterpolationDescriptor the first point & figures' time must be returned.

Returns:

the time of first point & figures for specified Instrument, PriceRange and ReversalAmount or Long.MAX_VALUE if there is no one.

See Also:

DataType.POINT_AND_FIGURE

getTimeOfFirstRenko

@Deprecated
long getTimeOfFirstRenko(Instrument instrument,
                                     PriceRange priceRange)

Deprecated. use getTimeOfFirstRenko(Instrument, Period)

Returns the time of first renko for specified Instrument and PriceRange

Parameters:

instrument - the Instrument the first renko' time must be returned.

priceRange - the PriceRange the first renko' time must be returned.

Returns:

the time of first renko for specified Instrument and PriceRange or Long.MAX_VALUE if there is no one.

See Also:

DataType.RENKO

getTimeOfFirstRenko

long getTimeOfFirstRenko(Instrument instrument,
                         Period timeSession)

Returns the time of first renko for specified Instrument and Period (time session)

Parameters:

instrument - the Instrument the first renko' time must be returned.

timeSession - the Period (renko session) the first renko' time must be returned.

Returns:

the time of first renko for specified Instrument and time session or Long.MAX_VALUE if there is no one.

See Also:

DataType.RENKO

getTimeOfFirstLineBreak

long getTimeOfFirstLineBreak(Instrument instrument,
                             Period timeSession)

Returns the time of first N-Line Break for specified Instrument and Period (time session)

Parameters:

instrument - the Instrument the first N-Line Break' time must be returned.

timeSession - the Period (time session) the first N-Line Break' time must be returned.

Returns:

the time of first N-Line Break for specified Instrument and time session or Long.MAX_VALUE if there is no one.

See Also:

DataType.LINE_BREAK

getTimeOfFirstKagi

long getTimeOfFirstKagi(Instrument instrument,
                        Period timeSession)

Returns the time of first kagi for specified Instrument and Period (time session)

Parameters:

instrument - the Instrument the first kagi's time must be returned.

timeSession - the Period (time session) the first kagi' time must be returned.

Returns:

the time of first kagi for specified Instrument and time session or Long.MAX_VALUE if there is no one.

See Also:

DataType.KAGI

getFXSentimentIndex

IFXSentimentIndex getFXSentimentIndex(Instrument instrument)

Returns last updated Forex Sentiment Index for specified subscribed Instrument.

Parameters:

instrument - Instrument of sentiment index

Returns:

the last updated sentiment index or null if there is no such

getFXSentimentIndex

@Deprecated
IFXSentimentIndex getFXSentimentIndex(Instrument instrument,
                                                  long time)

Deprecated. Returns null

Returns Forex Sentiment Index which was most up-to-date at a point of specified time

Parameters:

instrument - Instrument of sentiment index

time - the point of time in the past in milliseconds.
To calculate the right time point one can use either

• standard java utils Calendar/Date/TimeUnit/DateFormat or
• JFUtils.getTimeForNPeriodsBack(Period, long, int) / JFUtils.getTimeForNPeriodsForward(Period, long, int) or
• custom approaches

Returns:

the sentiment index which was most up-to-date at a point of specified time or null if there is no such.

See Also:

JFUtils.getTimeForNPeriodsBack(Period, long, int), JFUtils.getTimeForNPeriodsForward(Period, long, int)

getFXSentimentIndex

@Deprecated
java.util.List<IFXSentimentIndexBar> getFXSentimentIndex(Instrument instrument,
                                                                     Period period,
                                                                     long from,
                                                                     long to)
                                                              throws JFException

Deprecated. Returns null

Returns the list of sentiment indices which were most up-to-date at the specified time frame.

Parameters:

instrument - Instrument of sentiment index

period - period between the sentiment indices

from - start of the time interval for which bars should be loaded. Should be the exact starting time of the bar for specified period. See IHistory.getBarStart(Period, long) description if you want to get bar starting time for candle that includes specific time

to - end time of the time interval for which bars should be loaded. This is the starting time of the last candle to be loaded

Returns:

the list of sentiment indices which were most up-to-date at the specified time frame or null if there is no such.

Throws:

JFException - if time is not divisible by the interval of period or the period is not among Period.THIRTY_MINS, Period.ONE_HOUR, Period.FOUR_HOURS, Period.DAILY, Period.WEEKLY

getFXSentimentIndex

@Deprecated
IFXSentimentIndex getFXSentimentIndex(java.util.Currency currency)

Deprecated. Returns null

Returns last updated Forex Sentiment Index for specified currency.

Parameters:

currency - currency of sentiment index

Returns:

the last updated sentiment index or null if there is no such

getFXSentimentIndex

@Deprecated
IFXSentimentIndex getFXSentimentIndex(ICurrency currency)

Deprecated. Returns null

Returns last updated Forex Sentiment Index for specified ICurrency.
Equivalent to the getFXSentimentIndex(ICurrency, System.currentTimeMillis) for live data and getFXSentimentIndex(ICurrency, pseudo_current_historical_tester_time) for historical data.

Parameters:

currency - ICurrency of sentiment index.

Returns:

the last updated sentiment index or null if there is no such

See Also:

getFXSentimentIndex(ICurrency, long)

getFXSentimentIndex

@Deprecated
IFXSentimentIndex getFXSentimentIndex(java.util.Currency currency,
                                                  long time)

Deprecated. Returns null

Returns Forex Sentiment Index which was most up-to-date at a point of specified time.

Parameters:

currency - currency of sentiment index

time - the point of time in the past in milliseconds

Returns:

the sentiment index which was most up-to-date at a point of specified time or null if there is no such

getFXSentimentIndex

IFXSentimentIndex getFXSentimentIndex(ICurrency currency,
                                      long time)

Deprecated. Returns null

Returns Forex Sentiment Index which was most up-to-date at a point of specified time

Parameters:

currency - ICurrency of sentiment index.

time - the point of time in the past in milliseconds.
To calculate the right time point one can use either

• standard java utils Calendar/Date/TimeUnit/DateFormat or
• JFUtils.getTimeForNPeriodsBack(Period, long, int) / JFUtils.getTimeForNPeriodsForward(Period, long, int) or
• custom approaches

Returns:

the sentiment index which was most up-to-date at a point of specified time or null if there is no such.

See Also:

JFUtils.getTimeForNPeriodsBack(Period, long, int), JFUtils.getTimeForNPeriodsForward(Period, long, int)

getFXSentimentIndex

@Deprecated
java.util.List<IFXSentimentIndexBar> getFXSentimentIndex(java.util.Currency currency,
                                                                     Period period,
                                                                     long from,
                                                                     long to)
                                                              throws JFException

Deprecated. Returns null

Returns the list of sentiment indices which were most up-to-date at the specified time frame.

Parameters:

currency - currency of sentiment index

period - period between the sentiment indices

from - start of the time interval for which bars should be loaded

to - end time of the time interval for which bars should be loaded

Returns:

the list of sentiment indices which were most up-to-date at the specified time frame or null if there is no such

Throws:

JFException - if time is not divisible by the interval of period or the period is not among Period.THIRTY_MINS, Period.ONE_HOUR, Period.FOUR_HOURS, Period.DAILY, Period.WEEKLY

getFXSentimentIndex

@Deprecated
java.util.List<IFXSentimentIndexBar> getFXSentimentIndex(ICurrency currency,
                                                                     Period period,
                                                                     long from,
                                                                     long to)
                                                              throws JFException

Deprecated. Returns null

Returns the list of sentiment indices which were most up-to-date at the specified time frame.

Parameters:

currency - ICurrency of sentiment index

period - period between the sentiment indices

from - start of the time interval for which bars should be loaded. Should be the exact starting time of the bar for specified period. See IHistory.getBarStart(Period, long) description if you want to get bar starting time for candle that includes specific time

to - end time of the time interval for which bars should be loaded. This is the starting time of the last candle to be loaded

Returns:

the list of sentiment indices which were most up-to-date at the specified time frame or null if there is no such.

Throws:

JFException - if time is not divisible by the interval of period or the period is not among Period.THIRTY_MINS, Period.ONE_HOUR, Period.FOUR_HOURS, Period.DAILY, Period.WEEKLY

isOfflineTime

boolean isOfflineTime(long time)

Deprecated. Use isOfflineTime(long, Instrument) instead.

Returns true if specified time is within the limits of offline (weekend) period.

Parameters:

time - time in milliseconds

Returns:

true if specified time is within the limits of offline (weekend) period, false - otherwise

isOfflineTime

boolean isOfflineTime(long time,
                      Instrument instrument)

Returns true if specified time is within the limits of offline (weekend) period.

Parameters:

time - time in milliseconds

instrument - checked instrument

Returns:

true if specified time is within the limits of offline (weekend) period, false - otherwise

getOfflineTimeDomain

ITimeDomain getOfflineTimeDomain()
                          throws JFException

Deprecated. Use getOfflineTimeDomain(Instrument) instead.

Returns either present, current offline (weekend) time interval or the next approximate upcoming one.
The same as #getOfflineTimeDomain(shift) with shift == 0

Returns:

either present, current offline (weekend) time interval or the next approximate upcoming one.

Throws:

JFException - when some error occurs

See Also:

getOfflineTimeDomain(int)

getOfflineTimeDomain

ITimeDomain getOfflineTimeDomain(Instrument instrument)

Returns either present, current offline (weekend) time interval or the next approximate upcoming one.
The same as #getOfflineTimeDomain(shift) with shift == 0

Parameters:

instrument - checked instrument

Returns:

either present, current offline (weekend) time interval or the next approximate upcoming one.

See Also:

getOfflineTimeDomain(int)

getOfflineTimeDomain

ITimeDomain getOfflineTimeDomain(int shift)
                          throws JFException

Deprecated. Use getOfflineTimeDomain(int, Instrument) instead.

Returns offline (weekend) time interval that is shifted back or forward for number of offline intervals specified in shift parameter.

Parameters:

shift - number of offline intervals back or forward in time staring from current one. E.g.:

• 0 - current or next approximate offline period,
• -1 - previous offline (last finished one),
• 1 - next approximate after current one, etc.

Returns:

offline (weekend) time interval that is shifted back or forward for number of offline intervals specified in shift parameter

Throws:

JFException - when some error occurs

getOfflineTimeDomain

ITimeDomain getOfflineTimeDomain(int shift,
                                 Instrument instrument)

Returns offline (weekend) time interval that is shifted back or forward for number of offline intervals specified in shift parameter.

Parameters:

shift - number of offline intervals back or forward in time staring from current one. E.g.:

• 0 - current or next approximate offline period,
• -1 - previous offline (last finished one),
• 1 - next approximate after current one, etc.

instrument - checked instrument

Returns:

offline (weekend) time interval that is shifted back or forward for number of offline intervals specified in shift parameter

getOfflineTimeDomains

java.util.Set<ITimeDomain> getOfflineTimeDomains(long from,
                                                 long to)
                                          throws JFException

Deprecated. Use getOfflineTimeDomains(long, long, Instrument) instead.

Returns the set of offline (weekend) time intervals ascending ordered by time which are within the limits of from and to parameters.

Parameters:

from - start of the time interval for which offline periods should be loaded. If start time is within the limits of offline period - this period will be returned as first element of resulting set.

to - end of the time interval for which offline periods should be loaded. If end time is within the limits of offline period - this period will be returned as last element of resulting set.

Returns:

the set of offline (weekend) time intervals ascending ordered by time which are within the limits of from and to parameters.

Throws:

JFException - when some error occurs

getOfflineTimeDomains

java.util.Set<ITimeDomain> getOfflineTimeDomains(long from,
                                                 long to,
                                                 Instrument instrument)

Returns the set of offline (weekend) time intervals ascending ordered by time which are within the limits of from and to parameters.

Parameters:

from - start of the time interval for which offline periods should be loaded. If start time is within the limits of offline period - this period will be returned as first element of resulting set.

to - end of the time interval for which offline periods should be loaded. If end time is within the limits of offline period - this period will be returned as last element of resulting set.

instrument - checked instrument

Returns:

the set of offline (weekend) time intervals ascending ordered by time which are within the limits of from and to parameters.

getServerProperties

java.util.Map<java.lang.String,java.lang.Object> getServerProperties()

Return unmodifiable map of server properties

Returns:

unmodifiable map of server properties

getWhiteLabelData

IWLabelData getWhiteLabelData()

Returns:

IWLabelData information

getLongSwapRateCoefficient

double getLongSwapRateCoefficient(Instrument instrument)

Returns the coefficient for calculating a Long Overnight Swap.

Parameters:

instrument - instrument for which the coefficient is requested

Returns:

coefficient for calculating a Long Overnight Swap

Throws:

java.lang.NullPointerException - if instrument is null

java.lang.IllegalArgumentException - if instrument is not subscribed or swap rates are unavailable for another reason

getShortSwapRateCoefficient

double getShortSwapRateCoefficient(Instrument instrument)

Returns the coefficient for calculating a Short Overnight Swap.

Parameters:

instrument - instrument for which the coefficient is requested

Returns:

coefficient for calculating a Short Overnight Swap

Throws:

java.lang.NullPointerException - if instrument is null

java.lang.IllegalArgumentException - if instrument is not subscribed or swap rates are unavailable for another reason

getLongSwapInPips

double getLongSwapInPips(Instrument instrument)

Returns a Long Overnight Swap in pips.

The value is calculated as:
-Long_Swap_Rate * Current_Price / Pip_Value

Parameters:

instrument - instrument for which value is requested

Returns:

Long Overnight Swap in pips

Throws:

java.lang.NullPointerException - if instrument is null

java.lang.IllegalArgumentException - if instrument is not subscribed or swap rates are unavailable for another reason or current price for the instrument is unknown

getShortSwapInPips

double getShortSwapInPips(Instrument instrument)

Returns a Short Overnight Swap in pips.

The value is calculated as:
Short_Swap_Rate * Current_Price / Pip_Value

Parameters:

instrument - instrument for which value is requested

Returns:

Short Overnight Swap in pips

Throws:

java.lang.NullPointerException - if instrument is null

java.lang.IllegalArgumentException - if instrument is not subscribed or swap rates are unavailable for another reason or current price for the instrument is unknown

getLongSwapInAccountCurrency

double getLongSwapInAccountCurrency(Instrument instrument,
                                    double amount)

Returns a Long Overnight Swap in account currency for specified amount.

The value is calculated as:
-Long_Swap_Rate * Amount * Current_Price

Parameters:

instrument - instrument for which value is requested

amount - amount in millions

Returns:

Long Overnight Swap in account currency

Throws:

java.lang.NullPointerException - if instrument is null

java.lang.IllegalArgumentException - if instrument is not subscribed or swap rates are unavailable for another reason or current price for the instrument is unknown

getShortSwapInAccountCurrency

double getShortSwapInAccountCurrency(Instrument instrument,
                                     double amount)

Returns a Short Overnight Swap in account currency for specified amount.

The value is calculated as:
Short_Swap_Rate * Amount * Current_Price

Parameters:

instrument - instrument for which value is requested

amount - amount in millions

Returns:

Short Overnight Swap in account currency

Throws:

java.lang.NullPointerException - if instrument is null

java.lang.IllegalArgumentException - if instrument is not subscribed or swap rates are unavailable for another reason or current price for the instrument is unknown