Streamster™ API Retrieval Methods

Once the SOAP object is created, Streamster API exposes a number of methods you can invoke to communicate with Streamster from your script or application. The following section explores available retrieval methods and related structures.

GetQuote

GetQuote method returns a "Quote" structure for a given instrument name. The Quote structure contains fields equivalent to columns in Rates windows in Streamster. GetQuote returns only fields available in Streamster - if you wish to retrieve any fields not currently shown in Streamster, you have to add them by clicking the Columns button.

Sample - PHP: The following sample retrieves a quote for EUR/USD, displays the "Last" field and then lists all available fields.

SOAP_SINGLE_ELEMENT_ARRAYS));

$quote = $api -> GetQuote("EUR/USD");

echo $quote -> Last . "\n";

foreach($quote as $field => $value) {
echo $field . " = " . $value . "\n";
}

?>

Sample - Visual Basic: The following sample retrieves a quote for EUR/USD, displays the "Last" field and then displays all other fields.

Dim api As StreamsterApi = New StreamsterApi

Dim q As Quote
q = api.GetQuote("EUR/USD")

Console.WriteLine("Last: " & q.Last)
Console.WriteLine("Bid: " & q.Bid)
Console.WriteLine("Offer: " & q.Offer)
Console.WriteLine("Change: " & q.Change)
Console.WriteLine("High: " & q.High)
Console.WriteLine("Low: " & q.Low)
Console.WriteLine("Open: " & q.Open)
Console.WriteLine("Close: " & q.Close)
Console.WriteLine("Time: " & q.Time)
Console.WriteLine("Currency: " & q.Currency)
Console.WriteLine("Yield: " & q.Yield)
Console.WriteLine("Ask: " & q.Ask)

GetOrders

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

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

SOAP_SINGLE_ELEMENT_ARRAYS));

$r = $api -> GetOrders();

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

foreach($r -> Order as $n => $OrderInfo) {

echo "\tOrder " . $n . "\n";

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

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

}

}

}

?>

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

Dim api As StreamsterApi = New StreamsterApi

Dim ao As Order()

Dim o As Order

ao = api.GetOrders()

For Each o In ao

Console.WriteLine("")

Console.WriteLine("Order:")

Console.WriteLine("OrderID: " & o.OrderID)

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

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

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

Console.WriteLine("Phase: " & o.Phase)

Console.WriteLine("PriceType: " & o.PriceType)

Console.WriteLine("Price: " & o.Price)

Console.WriteLine("ActiveQuantity: " & o.ActiveQuantity)

Console.WriteLine("TradedQuantity: " & o.TradedQuantity)

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

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

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

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

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

Console.WriteLine("Duration: " & o.Duration)

Console.WriteLine("DurationType: " & o.DurationType)

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

Console.WriteLine("QuantityType: " & o.QuantityType)

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

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

Next

GetTrades

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

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

SOAP_SINGLE_ELEMENT_ARRAYS));

$r = $api -> GetTrades();

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

foreach($r -> Trade as $n => $TradeInfo) {

echo "\tTrade " . $n . "\n";

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

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

}

}

}

?>

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

Dim api As StreamsterApi = New StreamsterApi

Dim at As Trade()

Dim t As Trade

at = api.GetTrades()

For Each t In at

Console.WriteLine("")

Console.WriteLine("Trade:")

Console.WriteLine("TradeID: " & t.TradeID)

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

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

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

Console.WriteLine("Phase: " & t.Phase)

Console.WriteLine("Price: " & t.Price)

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

Console.WriteLine("Executed: " & t.Executed)

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

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

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

Console.WriteLine("OrderID: " & t.OrderID)

Next

Download Help

Most problems when downloading files are caused by incomplete or corrupted downloads. There are a number of reasons why this might occur. These can include but are not limited to: problems with your Internet connection, problems with your computer, peak traffic on the server, or a damaged file on the server.

Problems with Your Internet Connection

If you have access to second computer with an Internet connection, try your download there. If you can download to second computer successfully, the first may have a problem with its Internet connection. While the download is in progress, try not to use the computer for any other purpose, as another application's demands on your computers processor might result in this sort of problems.

Problems with Your Computer

If you have consistent problems with downloading files from the Internet, you may be having a problem with your computer. As a file is downloaded, it is written to your computer's hard disk. If there is a disk problem, the file may not be written properly. Try running a disk utility to check for errors. If any are found, they should be corrected before downloading any files. Also check your computer for viruses as these can affect its operation.

Peak Traffic on the Server

The Marketiva.com site receives a lot of heavy traffic daily. The number of visitors soars whenever we place a new product or an upgrade for download. During these peak traffic periods, some of our customers have a difficult time downloading. We will try to accommodate extra traffic, and will offer alternative download sites. If high traffic is the cause of the download problems, your only option is to try one of the alternate download sites, or to wait for an off-peak time to download.

Damaged File on the Server

We verify our files when we post them to make sure that they are valid. That said, it is possible that a file posted on one of our servers can be damaged. If you have downloaded the same file to several different computers and the resulting download is damaged, you should report it to us so we can correct the problem.

Marketiva Tools

Download Marketiva Tools

To download the trading tools, please click on any of the links below, choose the "Save" option in your browser, and save the file to your local computer. If you prefer to start the installation process right away, please click on any of the links below and choose the "Open" option in your browser.

Marketiva Personal Web Terminal

Personal Web Terminal is a trading tool that consists of a light web server and a web site that lets you check your positions and orders, and monitor prices through a browser.

NOTE: Streamster has to be running and the Web Service API has to be enabled while you use Marketiva Personal Web Terminal trading tool. It is necessary to subscribe to all columns for orders and positions.

Download Marketiva Personal Web Terminal (1.0.4)

Marketiva Personal Mobile Terminal

Personal Mobile Terminal is a trading tool that consists of a Personal Mobile Terminal Server running on personal computer with Streamster and a Mobile Terminal running on mobile operating system, this trading tool lets you check your positions and orders, and monitor prices through a mobile device.

NOTE: Streamster has to be running and the Web Service API has to be enabled while you use Marketiva.

• Personal Mobile Terminal trading tool. It is necessary to subscribe to all columns for orders and positions.
• Download Marketiva Personal Mobile Terminal Server (1.0.1) for Windows 2000 / XP / Vista / 7
• Download Marketiva Personal Mobile Terminal (1.0.1) for Pocket PC 2003 SE / Windows Mobile 5.0 Pocket PC or above
• Download Marketiva Personal Mobile Terminal (1.0.0) for Smartphone with Windows Mobile 5.0 or above

If you have any question regarding the Marketiva Tools, please see the Tools FAQ at Tools FAQ page. See more information at Marketiva Tools page.