Actor hierarchy

Actors in MarketGrid are a set of tables that define the participants acting within the System. There is a hierarchical relationship between the Actor tables.

Users

A User is the bottom level Actor in MarketGrid that logs into the System and performs actions, such as entering orders or entering administrative transactions.

Each User in MarketGrid has a UserId (and associated Password) that is used to log into the System in order to enter transactions or to receive data from the System (such as Orders and Trades). A User could be a representation of a physical person within an organisation or a process accessing the System via an API.

Every User must belong to one and only one Firm.

Firms

A Firm is the representation of a business organisation within MarketGrid. Typical firms are banks and brokers. There is usually an exchange administration Firm for each Venue.

Every Firm must belong to one and only one Enterprise.

Enterprises

An Enterprise is the representation of a corporate group within MarketGrid. Each Enterprise comprises one or more Firms, each of which belongs to the Enterprise.

For example, a global bank might be represented as an Enterprise within MarketGrid and each of its global subsidiaries might be represented as a Firm belonging to the Enterprise.

Every Enterprise must belong to one and only one Venue. The Users in the Firms that belong to the Enterprise can see and trade on the Markets that belong to that Venue.

The following diagram illustrates the relationship between the various Actor and Product elements within MarketGrid.

graph TD
  E[Enterprise: Big Global Bank]:::darkdarkgreen
  E --> F1[Firm: Singapore Office]:::darkgreen
  E --> F2[Firm: US Office]:::darkgreen
  F1 --> U1[Singapore User 1]:::green
  F1 --> U2[Singapore User 2]:::green
  F1 --> U3[Singapore User 3]:::green
  F2 --> U4[US User 1]:::green
  F2 --> U5[US User 2]:::green

  classDef darkdarkgreen fill: #aca
  classDef darkgreen fill:#bdb
  classDef green fill:#dfd

Venues

A Venue is the top level of the hierarchy of Actors and Products in MarketGrid.

The purpose of a Venue is to organise a set of Markets and the Enterprises that have access to those Markets. In essence, a Venue is a stand-alone exchange that is siloed from other Venues within a given MarketGrid instance.

Every Enterprise and every Market in MarketGrid belongs to one and only one Venue. Access, for the Users under each Enterprise, to the Markets within the Venue is controlled through the MarketGrid permission model.

The following diagram illustrates the Actor and Product hierarchy with Venues.

graph TD
  subgraph VA[Venue A]
    subgraph A1[Market A1]
      IMA1[InstrumentMarkets...]
    end
    subgraph A2[Market A2]
      IMA2[InstrumentMarkets...]
    end
    subgraph E1[Enterprise 1]
      subgraph F1[Firms...]
        U1[Users...]
      end
    end
    subgraph E2[Enterprise 2]
      subgraph F2[Firms...]
        U2[Users...]
      end
    end
  end

graph TD
  subgraph VB[Venue B]
    subgraph B1[Market B1]
      IMB1[InstrumentMarkets...]
    end
    subgraph E3[Enterprise 3]
      subgraph F3[Firms...]
        U3[Users...]
      end
    end
  end