Child pages
  • Photon User Guide
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 14 Next »


Photon is the Marketcetera Automated Trading Platform UI client. Photon is what's know as a fat client, meaning it is a standalone native executable as opposed to a thin client, which is typically made available via a web browser. To use Photon, you must install the Photon component for your platform and architecture. See the installation guide for more information on installing Photon.

Launching Photon

Photon uses the Eclipse Rich Client Platform. If you're familiar with the Eclipse IDE, Photon will look very familiar to you. On Windows, an entry for Photon will have been added to your Start menu or Desktop, as you requested during installation. On Linux, to start Photon:

$ cd marketcetera-2.2.1
$ . ./
$ cd photon
$ ./photon

On OSX, there is a which you can add to your toolbar or Applications folder.

Logging In

Photon can run by itself, however, most of its utility comes from connecting to other components in the Marketcetera Automated Trading Platform stack, like the Order Routing System and one or more Strategy Agents. Upon start, Photon prompts you to log in to an Order Routing System.

The default credentials for the Order Routing System are admin/admin.

Once you've entered the credentials to connect to the Order Routing System, you can tell if Photon has successfully connected by the status icons at the bottom. The icons will change from


(the left light is for the connection to the Order Routing System, the right light is for the connection to a market data adapter, more on that later)

After connecting, some views that require a connection to the Order Routing System are populated, like the Open Orders View and the Positions View. More on these and other views later.

By default, Photon is configured to connect to an Order Routing System running on the same host. However, if you've installed your Order Routing System on another host, you can configure Photon to connect to that host instead. Select Cancel from the login dialog and then Edit->Preferences. Select Connections in the left pane.

You can enter a new IP address (in place of for the IP address of your Order Routing System. Select OK and then File->Reconnect Server to resume the login process. There is also a menubar icon for Reconnect Server, for your convenience. If you are already connected to the server when you select Reconnect Server, your current connection will be closed and a new connection established. This is harmless, though there may be a small delay depending on the amount of trading activity that's occurred today as Photon downloads today's activity from the Order Routing System.


A View in Photon is one of the dockable and resizeable tabs with a title and a menubar. Views may be maximized, minimized, closed, and moved. In addition to some common Eclipse Views, Photon provides the following custom Views:

Console View

The Console View is a standard Eclipse View with some Photon-specific customizations. 

There are three sub-views: Main, Sink Console, and Notifications. The Main Console provides basic information from Photon. The default message level is INFO. This can be changed at Edit->Preferences->Photon.

The Sink Console displays messages from connected Strategy Agents. There aren't any Strategy Agent connections yet, more on that later.

The Notifications Console displays messages from Photon that correspond to pop-up messages, like server disconnect and reconnect messages, for example.

Market Data View

Photon provides market data for display and also for consumption by running strategies. More on strategies later, for now, let's focus on the display of market data. The Marketcetera Automated Trading Platform divides market data into content types:

  • Top of Book - best bid and offer
  • Latest Tick - most recent trade
  • Marketstat - statistics, including OHLC (open price, high price, low price, and close price)
  • NASDAQ Level 2 (NQDS) - top-of-book for NASDAQ exchange participants
  • NASDAQ TotalView (ITCH) - full order book depth for NASDAQ market participants
  • NYSE OpenBook limit-order book for all NYSE-traded securities
  • Aggregated Depth - generic depth data with order sizes aggregated at each price level
  • Unaggregated Depth - generate depth data no price level aggregation

In Photon, top-of-book, latest tick, and marketstat are displayed in the Market Data View:

To display market data in the Market Data View, enter a symbol in the Market Data View menubar and press the green plus button or press enter. The symbol you enter will be submitted to all the active market data adapters. Each adapter will interpret the symbol according to its nature and return market data accordingly. If more than one market data adapter is active and returning data for the same symbol, the market data displayed will come from the most recently supplied market data event. Note that, in the above image, there are two equities and one future instrument displayed. Market data can be displayed for multiple instruments at the same time.

It is important to note that Marketcetera, Inc. does not itself supply market data. Market data comes to the platform via a market data adapter from an external source, like Thompson Reuters or Lime. You will need an account with one of these providers in order to view market data. More on market data adapters later.

If the market data event displayed in the Market Data View comes from a market data adapter that supports depth-of-book, you can select a row in the Market Data View and open the Market Depth View.

The available depth views are displayed in the right-click menu for a given row in the Market Data View. Selecting one of the available market data depth types will open the Market Depth View.

You can select buy or sell from the right-click menu from either the Market Data or the Market Depth Views. Doing so will open the appropriate Order Ticket View populated with the bid or ask from the selected row depending on whether you selected buy (ask) or sell (bid).

Order Ticket Views

The Order Ticket Views are used to place new orders and cancel replace order requests. There is a specialized Order Ticket View for each supported asset class.

FieldTypeRequiredDefaultEquityOptionFutureCurrencyMessage Field
BrokerDropdownYesAuto SelectYesYesYesYesSpecial1
SideDropdownYes YesYesYesYesSide (54)
QuantityDecimalYes YesYesYesYesOrderQty (38)
SymbolString2Yes YesYesYesYesSymbol (55)
Order TypeDropdownYes YesYesYesYesOrdType (40)
PriceDecimalConditional3 YesYesYesYesPrice (44)
TIFDropdownYesDayYesYesYesYesTimeInForce (59)
AccountStringNo YesYesYesYesAccount (1)
IcebergDecimalNo YesYesYesYesMaxFloor (111)
AlgoDropdownNo YesYesYesYesVaries4
Custom FieldsTableNo YesYesYesYesVaries5
Expiration YearNumber: YYYYFuture NoNoYesNoMaturityMonthYear (200)
Expiration MonthDropdownFuture NoNoYesNoMaturityMonthYear (200)
ExpiryNumber: YYYYMMDDOption NoYesNoNoMaturityMonthYear (200), MaturityDay (205)
StrikeDecimalOption NoYesNoNoStrikePrice (202)
TypeDropdownOption NoYesNoNoPutOrCall (201)
Open/CloseDropdownNo NoYesNoNoOpenClose (77)
CapacityDropdownNo NoYesNoNoOrderCapacity (528)
Near TenorNumber: YYYYMMDDNo NoNoNoYesFutSettDate (64)
Far TenorNumber: YYYYMMDDNo NoNoNoYesSettDate2 (193)
Base CurrencyRadio ButtonYesCCY1NoNoNoYesSpecial6
  1. The list of available brokers is provided by the Order Routing System. An order may be targeted to a specific broker or the default or "auto-selected" broker may be selected.

  2. The symbol entered is provided to the broker as-is. There is no official symbology for instruments that is respected by all brokers, exchanges, and market data providers. Some providers accept numeric codes, others use OSI for options, and others use proprietary symbology. This is exacerbated by symbology of market data providers. In the next major release, the Marketcetera Automated Trading Platform will provide a symbol standardization system that will make this easier to manage. For now, keep in mind that the symbol in the order ticket has to be something understood by the broker to which you send the order.
  3. Price is required for non-market orders
  4. The algo dropdown and table allows you to target an order to a broker-specified algorithm. These algorithms are defined in the Order Routing System configuration. For example, the broker may offer a special VWAP or TWAP algorithm with parameters that specify participation or start and end times. These algorithm specifications are part of the broker configuration provided by Marketcetera, Inc. to subscription customers. For non-subscription customers, you may research and define these algorithms yourself depending on what your broker offers.
  5. The custom fields table allows you to specify FIX fields and values on outgoing orders that are not covered by existing widgets on the order ticket.
  6. Specifies whether to use the left currency as the base or the right. For example, for the symbol, USD/EUR, CCY1 is USD and CCY2 is EUR. You may swap these by setting the radio button value to CCY2.


  1. Logging in
    1. Local host
    2. Another host
    3. Default credentials
    1. Opening a View
    2. General
      1. Console
    3. Market Data
      1. Market Data
      2. Market Depth
    4. Photon
      1. Average Price
      2. Currency Order Ticket
      3. FIX Message Details
      4. FIX Messages
      5. Fills
      6. Future Order Ticket
      7. Open Orders
      8. Option Order Ticket
      9. Stock Order Ticket
    5. Positions
      1. Positions
    6. Strategy Category
      1. Project Explorer
      2. Strategy Engines
      3. Trade Suggestions
  3. Perspectives
    1. Equity
    2. Option
    3. Future
    4. Currency
    5. Strategy
    6. Custom
  4. Market Data Adapters
    1. Marketcetera
    2. Bogus
    3. Yahoo
    4. CSV
    5. Commercial Adapters
      1. Activ Financial
      2. Thompson Reuters
      3. Lime
      4. NYSE
      5. ICE
      6. Nordpool
  5. Configuration
  • No labels