Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Page Tree
rootInstrument types

Bonds

The default way to configure Bonds in BFS is to have them traded in nominal values and quoted in percentage values. For example, if a Bond has a minimum lot size of 100,000 USD and the price is 98% the purchase price for 100,000 nominal amount will be 98,000. To configure this instrument do the following.

PropertyDescription
TypeThe instrument type, select Bonds
NameThe name of the instrument
ISINThe ISIN-code of the instrument
StatusThe status determines what user type the instrument should be available to
Visible StatusThe status determines what user type the instrument should be visible to
CurrencyThe currency that the instrument is based in
Tax CountryThe country where the instrument is based according to tax reasons
Default MarketplaceThe default marketplace where the instrument is traded
IssuerThe legal entity that has issued the instrument
Dividend TypeIf dividends are issued or re-invested in the instrument, not widely used for bonds.

PropertyDescription
Price DecimalsThe number of decimals to use when showing the price of the instrument
Display Percentage PriceIf checked the price will be displayed as a percentage value, in the database the value of 98% will be stored as 0.98 but shown as 98%
Price %The price of the instrument
Price DateThe date when the price was set
Multiplier

The value multiplier of the instrument. Using the bond example above the instrument could be configured with a value multiplier of 100,000 and then the user could enter a lot of 1 as the quantity and that would mean that they are trading one bond contract with a face value of 100,000. Best practice is to set the value multiplier to 1 and have the user enter 100,000 as the quantity of units to trade. This is called trading in nominal amounts.

The minimum lot size should then be defined on the trade route (Execution Interface) that we configure for the instrument.

DecimalsThis is a legacy property that should be left blank
Quantity DecimalsThis is the number of decimals that should be used for the units. The bond should have 0 decimals for the quantity since we cannot trade 0.5 bonds. Funds on the other hand could have 0.00001 for example since fund units are commonly traded in fractions of whole units.

PropertyDescription
First TradeThe first date on which the instrument should be available for trading
Last TradeThe last date on which the instrument should be available for trading
ExpirationThe date on which the instrument will expire
Datasheet URLA link to an instrument description
CategorizationInstrument Categorization
External ReferenceA reference that could be used to link the instrument to an external system or some other reference
Lock In PeriodThe period that a legal entity should be locked in before being able to sell after having purchased the bond
Fee CategoryWhich fee category the instrument should belong to according to /wiki/spaces/KB/pages/66584622
Buy CommissionThe percentage commission charged on buy orders
Sell CommissionThe percentage commission charged on sell orders
Early Sell FeeThe percentage fee charged on orders that are being executed within the lock in period.
Product CompensationThe percentage of kickback that should be given to the associated re-seller on the orders of the bond
Account Type LimitationDetermines if the instrument should be limited to certain account types.


Image result for next button