Mobile Quotes User Guide
Back to the main page.
Table of Contents
1. Features
The main functions of the MarketFilters application are:
- Quotes for stocks and indexes
- Stock charts
- Market Scans
2. Installation
The main page shows two methods for installing the application.
The first method is called OTA (Over The Air) and is accomplished by using the browser on your BlackBerry to visit the provided OTA URL. You can visit the URL by either going to the main page in your BlackBerry browser and clicking on the OTA link, or simply by entering the full OTA URL into your BlackBerry browser.
The second method is to download the ALX and COD files to your computer. The BlackBerry Desktop Manager application can then be used to install the application.
3. Usage
3.1 Initialization Screen
This screen appears when the application is first loaded and checks the configuration data, which is retrieved from MarketFilters once every several days at most. If the configuration has already been loaded this screen will quickly exit and proceed to the Quote List screen.
When data does need to be loaded, this may take several seconds. If more than 5-10 seconds have passed there is likely a networking issue. You can select "Use Default Settings" from the menu, proceed to the options screen from the menu, then try the Connection Test as outlined below to help find appropriate settings.
3.2 Quote List Screen
This is the "main screen" of the application.
When loaded for the first time you will see the index quote area, an area to add a symbol, then an empty list. When the cursor is inside the "Add Symbol" input, you may enter a symbol, then select "Add Symbol" from the menu. After retrieving the latest quotes you will now see your symbol in the list. You can add as many symbols as you like.
Note that only traditional stocks are officially supported, not mutual funds.
If you highlight a symbol in the list the menu will have several extra options: Quote Detail, Symbol Chart and Remove Symbol. Requesting a chart will fetch the data from MarketFilters. Quote Detail does not need to download any new information.
The menu on this screen will always contain: Refresh Quotes, Market Scans, Options, Remove All Symbols, About, User Guide and Disclaimer.
Note that when on this screen the device back button will hide the application, not fully close it. The next time you click on the application icon it will return to this screen with the same information, so quotes do not need to be fetched as often.
To add symbols from the Toronto Stock Exchange, add ".TO" to the symbol name. Example: RIM.TO.
3.3 Chart Screen
The chart screen shows a single chart. Use either the back button, or Close from the menu, to return to the main screen.
3.4 Quote Detail Screen
The detail screen shows more information about the selected symbol, such as Company Name, Volume, EPS, 50/200 day average, etc. Use either the back button, or Close from the menu, to return to the main screen.
3.5 Market Scans
Market Scans are the process of scoring every symbol in the market according to some criteria, then returning the symbols with the highest score. Within MarketFilters a Scan is a grouping of technical indicators meant to find symbols acting in a specific way, normally oversold or overbought, which may be considered for trading.
When first opened the Market Scans screen has no data. Open the menu and select one of the listed scans. Scans normally take 5-20 seconds to run because of how much data is being analyzed.
Once a scan returns the list will show the symbol, it's score for this scan, and the latest price. If a symbol is highlighted the menu will contain an option to "Get Symbol Quote" which will add it to your list and fetch the latest quotes.
Note that if you move to another screen (closing or getting a quote for a symbol) the same last scan will show the next time you return, but you can also pick a new scan to run.
3.6 Options Screen
The options screen allows configuration of the application. The available options are:
- Load quotes on startup - Whether the application will fetch quotes when loaded. Note that by default the application stays open when the main screen is exited with the back button. Use the Close menu option to exit the application.
- Indexes - Select which indexes to show on the main screen.
- Advanced connection parameters - Some networks will require special connection parameters to be able to access information from the web. See either the Connection Test below or the Troubleshooting guide for more details.
There are 2 extra menu options:
- Remove Cached Settings - The application loads configuration data once every 3 days, on startup, by default. This data can be cleared with this option.
- Connection Test - Attempts opening connections with various advanced parameters to help in troubleshooting.
4. Troubleshooting
We have compiled below the symptoms and solutions for all problems our users have encountered. By far the vast majority are connectivity issues described in section 4.1.
4.1 Errors: "Could not open tunnel - failed", "Invalid tunnel name" or "Got HTTP response code: 502"
If you are encountering one of the error messages above this is likely because your carrier uses a custom APN (Access Point Name), typically a WAP gateway. These issues are normally solved by configuring your device to allow outbound connections. You will need to find the APN associated with your carrier at one of the links below and fill that into the Options > Advanced > TCP screen.
Here are two good sources of information on how to do this:
Once you find the APN value(s) fill it into the device Options > Advanced > TCP screen and do a hard reboot (pull battery) for the changes to take effect.
Lastly, if things still are not working try running the "Connection Test" from the applications Options screen (accessible from the main quote list screen). If the test passes which says "deviceside=true", then enter that string into the advanced connection parameters section. Save the changes, select "Close" from the main application quote list screen, then reload the application. Quotes should work now.
If none of the above fix the problem there may be a problem accessing the internet through your carrier or your BES. Unfortunately, there isn't anything MarketFilters can do in this case. Our software opens connections in the standard way for 3rd party applications.
4.2 Error: "Bad DNS Address"
This error is most often caused by a bug in the device networking layer and is normally fixed by a hard reboot of the device (pull battery).
4.3 Connection Test
If none of the other suggestions have worked, please try the Connection Test menu option from the Options screen. The most common extra connection parameter required is "deviceside=true". If that test passed, please enter "deviceside=true" into the advanced connection parameters on the Options Screen, save, then Close (from the main screen) and reload the application.
4.4 Symbol XYZ shows up as N/A or won't add
The most common reasons why quotes cannot be found for a symbol are either because it's on a smaller exchange or not a stock (ie: mutual fund). Symbols from the OTC exchange can be added by adding ".OB" to the symbol, and those on the TSX ".TO".
Mutual funds are not supported by this application. Some funds do return quotes within the data feed we subscribe to, but it is not our intention to supply data for funds.
4.5 Installation problems
If you encounter an error message while trying to install the application such as "Bad COD" or "Invalid COD", please notify us by email at widgets. This likely indicates an incompatability has been introduced with your device version. We strive to ensure the application is compatible with device software version 4.1+.
4.6 Other Problems
If none of the suggestions above fix your issue, email us at admin. In your email please provide the following information:
- Your BlackBerry device type (ie: 8700, Curve, Pearl, etc)
- Your carrier (ie: AT&T, T-Mobile, etc)
- The error message you received, if any
- What you were doing when you got the error (ie: Connection problem when application first loaded, error when trying to add a symbol, error when trying to get market scans, etc)