API Retrieval Methods - GetPositions

GetPositions

GetPositions method returns an array of "Position" structures. This array corresponds directly to the Positions window in Streamster. Each Position structure in the returned array contains one position with its associated fields as displayed in Streamster. GetPositions returns an array of Position structures which contain only fields available in Streamster - if you wish to retrieve any fields not currently shown in Streamster's Positions window, you have to add them by clicking the Columns button.

Sample - PHP: The following sample retrieves all positions and lists them.

SOAP_SINGLE_ELEMENT_ARRAYS));

$r = $api -> GetPositions();

if(property_exists($r, "Position")) {

foreach($r -> Position as $n => $PositionInfo) {

echo "\tPosition " . $n . "\n";

foreach($PositionInfo as $field => $value) {

echo "\t\tField: " . $field . " = " . $value . "\n";

}

}

}

?>

Sample - Visual Basic: The following sample retrieves all positions and lists them.

Dim api As StreamsterApi = New StreamsterApi

Dim ap As Position()

Dim p As Position

ap = api.GetPositions()

For Each p In ap

Console.WriteLine("")

Console.WriteLine("Position:")

Console.WriteLine("PositionID: " & p.PositionID)

Console.WriteLine("Desk: " & p.Desk)

Console.WriteLine("Instrument: " & p.Instrument)

Console.WriteLine("Side: " & p.Side)

Console.WriteLine("OpenPrice: " & p.OpenPrice)

Console.WriteLine("Currency: " & p.Currency)

Console.WriteLine("Quantity: " & p.Quantity)

Console.WriteLine("Points: " & p.Points)

Console.WriteLine("Profit: " & p.Profit)

Console.WriteLine("ExitStopLoss: " & p.ExitStopLoss)

Console.WriteLine("ExitTarget: " & p.ExitTarget)

Console.WriteLine("Entered: " & p.Entered)

Console.WriteLine("Exited: " & p.Exited)

Console.WriteLine("Status: " & p.Status)

Console.WriteLine("Text: " & p.Text)

Console.WriteLine("ClosePrice: " & p.ClosePrice)

Console.WriteLine("Interest: " & p.Interest)

Next

GetDesks

GetDesks method returns an array of "Desk" structures. Each Desk structure in the returned array describes one desk on your account, including the name of the desk, the amount available on the desk, and the currency in which this amount is available.

Sample - PHP: The following sample retrieves all desks and lists them.

SOAP_SINGLE_ELEMENT_ARRAYS));

$r = $api -> GetDesks();

if(property_exists($r, "Desk")) {

foreach($r -> Desk as $n => $Desk) {

echo "Name: " . $Desk -> Name;

echo ", Currency: " . $Desk -> Currency;

echo ", Amount: " . $Desk -> Amount;

echo "\n";

}

}

?>

Sample - Visual Basic: The following sample retrieves all desks and lists them.

Dim api As StreamsterApi = New StreamsterApi

Dim ad As Desk()

Dim d As Desk

ad = api.GetDesks()

For Each d In ad

Console.WriteLine("Name: " & d.Name & ", Currency: " & d.Currency &

", Amount: " & d.Amount)

Next

GetBars

GetBars method retrieves an array of bars for a specified instrument and period. Each bar in the returned array of bars contains price at a specific point in time.

NOTE: Only bars from any open Charting windows in Streamster can be retrieved. If you wish to retrieve bars from your script for a specific instrument and period, you have to make sure that this instrument/period is shown in one of Streamster's Charting windows.

The GetBars method has three parameters: instrument, period and a flag for options.

First parameter of the GetBars method is a string that specifies the instrument for which bars will be retrieved. The second parameter, Period, specifies the required period such as "5 Minutes", "15 Minutes", "30 Minutes", "Hourly", "4 Hours", "Daily", "Weekly", or "Monthly". The third parameter is a string that determines the order in which bars are returned: a blank string if bars are to be returned in descending order or a string "f" (as in "flip") for ascending order.

Each bar in the returned array of bars has the following fields: BarDateTime, Open, High, Low, Close and Volume.

Sample - PHP: The following code retrieves 5-minute EUR/USD bars and shows them all.

SOAP_SINGLE_ELEMENT_ARRAYS));

$r = $api -> GetBars("EUR/USD", "5 minutes", "f");

if(property_exists($r, "Bar")) {

foreach($r -> Bar as $n => $Bar) {

echo $Bar -> BarDateTime . " " . $Bar -> Open . " " . $Bar -> High .

" " . $Bar -> Low . " " . $Bar -> Close . "\n";

}

}

?>

Sample - Visual Basic: The following code retrieves 5-minute EUR/USD bars and shows them all.

Dim api As StreamsterApi = New StreamsterApi

Dim ab As Bar()

Dim b As Bar

ab = api.GetBars("EUR/USD", "5 minutes", "")

For Each b In ab

Console.WriteLine(b.BarDateTime & " " & b.Open & " " & b.High &

" " & b.Low & " " & b.Close)

Next

GetLastMessage

GetLastMessage retrieves the last error or warning message displayed in Streamster, if any. The GetLastMessage method returns a blank string if there were no messages after the previous GetLastMessage call.

Sample - PHP: The following code shows the last error or warning message.

SOAP_SINGLE_ELEMENT_ARRAYS));

$r = $api -> GetLastMessage();

if($r != "") {

echo($r);

}

?>

Sample - Visual Basic: The following code shows the last error or warning message.

Dim api As StreamsterApi = New StreamsterApi

Dim s As String

s = api.GetLastMessage()

If s <> "" Then Console.WriteLine(s)

Getting started with Streamster

Streamster basics, download and installation

Novativa Streamster™ is the proprietary software utilized by Marketiva to deliver financial information and trading services to its clients. Streamster was designed and developed by Novativa Corporation.

Streamster can be used on Windows 98, Me, 2000, XP and Vista. Please check the download section for a detailed information as the list of operating systems changes. All of the information and service provided by Marketiva is delivered via Streamster software that can be downloaded from:

Download Streamster

In order to install Streamster, you need to double click on the executable downloaded from the link above and follow an easy to use installation wizard. Streamster icon will then be placed on your desktop, which you can double-click to launch this program.

Connecting to the Streamster Server

To use Streamster, you must be connected to the Internet. You can use either a dial-up connection with a phone-based modem, a broadband connection such as DSL or cable modem, or a LAN (local area network) with Internet access. Streamster is capable of connecting to the Streamster Server whenever there is an Internet connection present. If your Internet Explorer works properly, Streamster should work as well.

To connect to the Streamster Server:

• Double-click the Streamster icon on your desktop or start menu.
• Type in your user name.
• Type in the password.
• Click Connect.

Upon connecting, Streamster will take between 5 and 60 seconds to download the start-up data.

Understanding security

Streamster uses industry-standard 128-bit SSL (secure sockets layer) to encrypt the communication between you and the Streamster Server. Streamster protects your privacy by encrypting any and all data received and sent between Streamster and the Streamster Server, and by verifying the identity of the Streamster Server prior to any communication.

Troubleshooting connectivity

Because Streamster uses SSL (secure sockets layer) to communicate with Streamster Server, it is necessary that your Internet connection supports SSL. If you are using a dial-up or a broadband connection, you will be able to use SSL. However, if your computer is behind a company firewall, it might be possible that network administrators have disabled SSL. If you are unable to connect to the Streamster Server, please ask your network administrators to enable SSL by allowing TCP communication on port 443.

Streamster will work with a proxy server if your Internet Explorer is configured to use one. To check or configure your proxy settings, please open Internet Explorer, select Internet Options from the Tools menu and then click Connections.

Common connection errors in Streamster

Error: Please check your network connection and server address, and try again. (0x80342af9).

This error message is usually seen if the user has installed a download accelerator or a newer version of Norton Antivirus application on his computer. To resolve this issue and enable connection to the Streamster server, simply disable the download accelerator application before connecting to the Streamster server.

IMPORTANT: This or similar error messages can also be seen if the user is sitting behind a personal or corporate firewall that does not let communication on SSL port (number 443). Please contact your security administrator, as this port should normally be open for outbound traffic.

Error: Server security certificate is invalid or expired.

This error message is usually seen if the system date and time are not correctly set (due to BIOS upgrade or battery failure) on your computer. To resolve this issue and enable connection to the Streamster server, simply update your system date and time.

Special Windows 98 requirements

Microsoft Windows 98 is an older operating system that does not support a high level of encryption and related services by default. You will need to download and install the so-called "Active Directory Client" (dsclient.exe). This program adds necessary components to Windows 98 installation and can be downloaded from many web sites, including:

Download Active Directory Client

After downloading this file, please run and install it and proceed with the installation of the software as usual.

Customizing Streamster™

Streamster allows you to customize it in many ways. You are able to setup sounds, voice and visual notifications, resize and relocate windows, change the way Streamster minimizes and much more.

Setting up sound, voice and visual notifications

Streamster can trigger an audio or visual notification for an alert or a news story. If an alert or news item is of low importance, no notification will be generated. Alerts or news items of normal importance generate a sound.

To disable the sound notifications:

• Click the Settings button.
• Disable the box next to the Beep when a news item or alert is received.
• Click OK to confirm.

Alerts or news items of high priority are pronounced by using the currently active text-to-speech engine (if available).

To disable the speech notifications:

• Click the Settings button.
• Disable the box next to the Pronounce high-priority news and alerts.
• Click OK to confirm.

To configure the default voice in which the speech notifications are played back, please consult Windows Help.

Resizing windows in Streamster

In order to resize a window within the Streamster, you need to click and drag the border of the particular window you want to resize. Windows can be resized horizontally and vertically.

Relocating and splitting windows

Streamster allows you to completely change placement and order of its windows. If you click on a window tab (without releasing mouse button) and drag it to a section of an existing window, that window will split into two new windows. You can do the same but in opposite direction: merge all windows into one.

Changing the way Streamster shows in taskbar

You are able to choose which way you want Streamster to behave when minimized. By default, Streamster minimizes to your taskbar, but if you check "Show icon in the taskbar when Streamster is minimized" in the Settings dialog on the Advanced tab, Streamster will minimize to the system tray.

Using descriptive names for Charting tabs

By default, names of Charting tabs are non-descriptive and additional charts contain respective order numbers only. In order to see tabs with instrument and chart range shown in Charting tabs, you need to do the following:

• Click the Settings button.
• Enable the box next to the Use descriptive names for Charting tabs.
• Click OK to confirm.

Forex, Funds, Indexes, Commodities

Forex Market

Foreign Exchange (Forex) is by far the largest market in the world, in terms of cash value traded, and includes trading between large banks, central banks, currency speculators, multinational corporations, governments, and other financial markets, institutions and entities. Forex traders simultaneously buy one currency and sell another and currencies are always priced and traded in pairs. There is no central physical exchange where Forex transactions occur since currency trading is freely carried out between counterparties, in person, by phone or online.

Current Forex Rates

Our Forex rates are based on current average interbank trading activity. Each instrument has bid price (for you to sell), offer price (for you to buy), last price (average of bid and offer), change from daily open price, highest and lowest daily prices and price update time-stamp.

Funds Market

Investment funds are offered by various institutions, investment banks, financial firms and other entities, and fund shares are purchased and sold through centralized exchanges or in direct retail sale. Funds are often structured to target specific geographic regions, specific industries or investment styles. Fund investors are typically advised to hold their shares for at least one year to offset initial charges and potential drawdowns in fund share prices. Funds are considered long-term investments and are normally not associated with speculative and day-trading.

Current Fund Rates

Our Fund rates are based on Fund pricing models (e.g. net asset value, preset percentage). Each instrument has bid price (for you to sell), ask price (for you to buy), last price (average of bid and ask), change from daily open price, annual yield (profit in the last 365 days), price update time-stamp and currency the prices are quoted in.

Market Indexes

Market index is a representation of value of a set of securities that constitute certain market sector or industry, have similar market capitalization, or are listed on the same exchange. Indexes often serve as barometers against which financial or economic performance is measured. Various methods are utilized to determine index values, some of them favoring market capitalization, others market share or price of a security. Major international market indexes are commonly published in media as indicators of economic trends in various parts of the world.

Current Index Rates

Our Index rates are based on current index values provided by various exchanges and financial institutions. Each instrument has bid price (for you to sell), ask price (for you to buy), last price (average of bid and ask), change from daily open price, highest and lowest daily prices and price update time-stamp.

Commodities Market

Commodities are basic resources and raw or primary products such as metals, energy and agricultural products. These resources and products are traded on commodities exchanges and over-the-counter markets, in which they are bought and sold in standardized contracts. Open auction, which involved traders meeting face-to-face in trading pits, was the primary method of trading before introduction of today prevalent electronic trading systems. Participants in commodities trading range from farming cooperatives hedging against a poor harvest to oil companies and market speculators.

Current Commodity Rates

Our Commodity rates are based on current prices quoted on largest commodity exchanges. Each instrument has bid price (for you to sell), ask price (for you to buy), last price (average of bid and ask), change from daily open price, highest and lowest daily prices, price update time-stamp and currency the prices are quoted in.

Available Instruments

Marketiva provides trading services in Forex, Funds, Indexes, and Commodities instruments listed on instruments page. Please select Commodity in [Type] field and click Filter Instrumentsbutton to get the list with detailed information on the instruments.