Offers (table)

Brief

This section describes the Offers table that contains information about trading instruments, current prices, and high/low trading day prices.

Details

Name

Type

Description

OfferID

String

The unique identification number of the instrument.

Instrument

String

The symbol of the instrument. For example, EUR/USD, USD/JPY, GBP/USD.

QuoteID

String

The unique identification number of the pair of prices (bid and ask) the instrument can be traded at.

Bid

Double

The current market price the instrument can be sold at. In the case of FX instruments, it is expressed in the instrument counter currency per one unit of base currency. In the case of CFD instruments, it is expressed in the instrument native currency per one contract.

Ask

Double

The current market price the instrument can be bought at. In the case of FX instruments, it is expressed in the instrument counter currency per one unit of base currency. In the case of CFD instruments, it is expressed in the instrument native currency per one contract.

BidTradable

String

The usage of the bid price. It defines whether the bid price of the instrument is available for trading or not. The possible values are:

T

The bid price is available for trading.

I

The bid price is view only.

N

The bid price is not available for trading.

AskTradable

String

The usage of the ask price. It defines whether the ask price of the instrument is available for trading or not. The possible values are:

T

The ask price is available for trading.

I

The ask price is view only.

N

The ask price is not available for trading.

High

Double

The highest ask price (buy price) of the instrument for the current trading day. In the case of FX instruments, it is expressed in the instrument counter currency per one unit of base currency. In the case of CFD instruments, it is expressed in the instrument native currency per one contract. A trading day is from 17:00 through 17:00 Eastern Time (UTC-5).

Low

Double

The lowest bid price (sell price) of the instrument for the current trading day. In the case of FX instruments, it is expressed in the instrument counter currency per one unit of base currency. In the case of CFD instruments, it is expressed in the instrument native currency per one contract. A trading day is from 17:00 through 17:00 Eastern Time (UTC-5).

BuyInterest

Double

The interest amount added to the account balance for holding a one lot long (buy) position overnight. In the case of FX instruments, lot size is determined by the system base unit size. In the case of CFD instruments, lot size equals to one contract. The interest amount is expressed in the account currency and can be positive or negative.

Note: If the account base unit size differs from the system base unit size, to get the proper interest amount for the account, use the following formula:
Offer.BuyInterest/SystemProperties.Base_Unit_Size* Account.Base_Unit_Size
This formula is applicable for FX instruments only.

SellInterest

Double

The interest amount added to the account balance for holding a one lot short (sell) position overnight. In the case of FX instruments, lot size is determined by the system base unit size. In the case of CFD instruments, lot size equals to one contract. The interest amount is expressed in the account currency and can be positive or negative.

Note: If the account base unit size differs from the system base unit size, to get the proper interest amount for the account, use the following formula:
Offer.SellInterest/SystemProperties.Base_Unit_Size* Account.Base_Unit_Size
This formula is applicable for FX instruments only.

Volume

Integer

The tick volume of the current minute. The value of this field represents the number of ticks happened during the current minute.

ContractCurrency

String

The base currency of the instrument (for example, EUR - in EUR/USD, USD - in USD/JPY, GBP - in GBP/USD, and so on).

Digits

Integer

The price precision of the instrument. It defines number of digits after the decimal point in the instrument price quote. For example, it is 5 for EUR/USD and 3 for USD/JPY. Therefore, price for EUR/USD instrument may look like 1.33187, for USD/JPY instrument like 77.953.

PointSize

Double

The size of one pip. It used to define the smallest move the instrument can make. In the case of FX instruments, it is expressed in the instrument counter currency. In the case of CFD instruments, it is expressed in the instrument native currency. The possible values are:

  • 1.0;

  • 0.1;

  • 0.01;

  • 0.001;

  • 0.0001;

  • 0.00001.

Different instruments have different pip values. For example, it is 0.0001 for EUR/USD and 0.01 for USD/JPY.

Note: For different instruments, the minimum possible change of the price could be 1 pip or a fraction of 1 pip. In the case of FX instruments, the pip is the minimal possible change of the second-to-last digit in a price quote. In the case of CFD instruments, the pip is the minimal possible change of the last digit in a price quote.

SubscriptionStatus

String

The subscription status.

The possible values are:

T

Available for trading.

D

Disabled (applicable for the trading station only; orders can still be created, and D changes to T).

V

View only.

TradingStatus

String

The trading status.

The possible values are:

O

Open, in other words, the instrument is tradable.

C

Closed, in other words, the instrument is not tradable.

InstrumentType

Integer

The type of the instrument. The possible values are:

1

Forex.

2

Indices.

3

Commodity.

4

Treasury.

5

Bullion.

ContractMultiplier

Integer

The contract multiplier for some CFD instruments only. It is used for simulation of the real-life trading conditions. For example, it is impossible to buy less than 25,000 lbs of copper on the market. Hence, the value of this field for Copper is 25000. In the case of FX instruments, the value of this field is 1.

ValueDate

String

The simulated delivery date. The date and time when the position opened in the instrument could be automatically closed. The value of this field is provided in the yyyyMMdd format. It is applicable only when instrument trades on account with the day netting trading mode (see MaintenanceType field in the Accounts table). Otherwise, the value of this field is blank.

Time

Date

The date and time of the last update of the instrument. The time zone is defined by the system properties SERVER_TIME_UTC and BASE_TIME_ZONE.

PipCost

Double

The cost of one pip per lot. It is expressed in the account currency and used to calculate the P/L value in the account currency. The size of one lot is returned by the getBaseUnitSize method of the TradingSettingsProvider object.
Note: It is a calculated field and is available only through the Table Manager.

back